AppHostBuilderExtensions.UseMauiMaps(MauiAppBuilder) Método

Definición

Espacio de nombres:
Microsoft.Maui.Controls.Hosting
Ensamblados:
Microsoft.Maui.Controls.dll, Microsoft.Maui.Controls.Maps.dll, Microsoft.Maui.Controls.Xaml.dll
Source:
AppHostBuilderExtensions.cs
Source:
AppHostBuilderExtensions.cs
Source:
AppHostBuilderExtensions.cs
Source:
AppHostBuilderExtensions.cs

MauiAppBuilder Configura para agregar compatibilidad con el Map control .

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::Maui::Hosting::MauiAppBuilder ^ UseMauiMaps(Microsoft::Maui::Hosting::MauiAppBuilder ^ builder);
public static Microsoft.Maui.Hosting.MauiAppBuilder UseMauiMaps(this Microsoft.Maui.Hosting.MauiAppBuilder builder);
static member UseMauiMaps : Microsoft.Maui.Hosting.MauiAppBuilder -> Microsoft.Maui.Hosting.MauiAppBuilder
<Extension()>
Public Function UseMauiMaps (builder As MauiAppBuilder) As MauiAppBuilder

Parámetros

builder
MauiAppBuilder

que MauiAppBuilder se va a configurar.

Excepciones

NotImplementedException

Se produce en Windows porque el control de mapas no está implementado actualmente para Windows.

Comentarios

Windows (Azure Maps): establezca la clave de suscripción de Azure Maps mediante ConfigureEssentials:

builder.ConfigureEssentials(essentials => essentials.UseMapServiceToken("YOUR_AZURE_MAPS_KEY"));

Obtener una clave del Azure Portal: https://portal.azure.com → Azure Maps cuenta → autenticación

características de Windows (a través de Azure Maps API de JS): la implementación de Windows usa MapControl de WinUI 3 respaldado por Azure Maps. Las siguientes características se implementan accediendo al Azure Maps API de JavaScript a través de webView2 interno del control:

  • MoveToRegion: Navega a través de map.setCamera().
  • MapType: Street/Satellite/Hybrid a través de map.setStyle().
  • IsTrafficEnabled: Flujo de tráfico e incidentes a través de map.setTraffic().
  • IsScrollEnabled/IsZoomEnabled: Control independiente a través de map.setUserInteraction().
  • Patillas: A través MapIcon de en un MapElementsLayer.

Limitaciones de la plataforma Windows:

  • Ubicación del usuario: No integrado; requiere la integración manual de la API de geolocalización.
  • Formas: No se admiten polilíneas, polígonos y círculos (MapElementsLayer solo admite MapIcon).
  • Anclar etiquetas:MapIcon no admite etiquetas ni ventanas de información.
  • Map.Clicked (fondo): Solo MapElement se activan los eventos, no los clics vacíos del área de mapa.
Consulte MapHandler la documentación para obtener información detallada sobre la plataforma.

Se aplica a