AppHostBuilderExtensions.UseMauiMaps(MauiAppBuilder) Método

Definição

Namespace:
Microsoft.Maui.Controls.Hosting
Assemblies:
Microsoft.Maui.Controls.dll, Microsoft.Maui.Controls.Maps.dll, Microsoft.Maui.Controls.Xaml.dll
Origem:
AppHostBuilderExtensions.cs
Origem:
AppHostBuilderExtensions.cs
Origem:
AppHostBuilderExtensions.cs
Origem:
AppHostBuilderExtensions.cs

Configura MauiAppBuilder para adicionar suporte para o Map controle.

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

O MauiAppBuilder para configurar.

Exceções

NotImplementedException

Lançado em Windows porque o controle de mapas atualmente não é implementado para Windows.

Comentários

Windows (Azure Mapas): defina sua chave de assinatura Azure Mapas usandoConfigureEssentials:

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

Obter uma chave do portal do Azure: https://portal.azure.com → Azure Mapas conta → Autenticação

recursos do Windows (via API JS Azure Mapas): a implementação do Windows usa o MapControl do WinUI 3 apoiado pelo Azure Mapas. Os seguintes recursos são implementados acessando o Azure Mapas API de JavaScript por meio do WebView2 interno do controle:

  • MoveToRegion: Navega por .map.setCamera()
  • MapType: Street/Satellite/Hybrid via map.setStyle().
  • IsTrafficEnabled: Fluxo de tráfego e incidentes via map.setTraffic().
  • IsScrollEnabled/IsZoomEnabled: Controle independente por meio de map.setUserInteraction().
  • Pinos: Via MapIcon em um MapElementsLayer.

limitações da plataforma Windows:

  • Local do usuário: Não interno; requer integração manual da API de Localização Geográfica.
  • Formas: Não há suporte para polilinha, polígonos e círculos (MapElementsLayer só há MapIconsuporte).
  • Fixar rótulos:MapIcon não dá suporte a rótulos ou janelas de informações.
  • Map.Clicked (plano de fundo): Só MapElement clica em eventos de fogo, não em cliques vazios na área do mapa.
Consulte MapHandler a documentação para obter informações detalhadas da plataforma.

Aplica-se a