AppHostBuilderExtensions.UseMauiMaps(MauiAppBuilder) Método

Definição

Espaço de Nomes:
Microsoft.Maui.Controls.Hosting
Assemblagens:
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-se MauiAppBuilder para adicionar suporte ao Map controlo.

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

Colocado no Windows porque o controlo de mapas atualmente não está implementado para o Windows.

Observações

Windows (Azure Maps): Defina a sua chave de subscrição Azure Maps usando ConfigureEssentials:

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

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

Funcionalidades do Windows (via Azure Maps JS API): A implementação do Windows utiliza o WinUI 3 MapControl apoiado pelo Azure Maps. As seguintes funcionalidades são implementadas acedendo à Azure Maps API de JavaScript através do WebView2 interno do controlo:

  • MoveToRegion: Navega via map.setCamera().
  • MapaTipo: Rua/Satélite/Híbrido via map.setStyle().
  • IsTrafficEnabled: Fluxo de trânsito e incidentes via map.setTraffic().
  • IsScrollEnabled/IsZoomEnabled: Controlo independente via map.setUserInteraction().
  • Pinos: Via MapIcon num MapElementsLayer.

Limitações da Plataforma Windows:

  • Localização do Utilizador: Não embutido; requer integração manual da API de Geolocalização.
  • Formas: Polilíneas, polígonos e círculos não são suportados (MapElementsLayer apenas suportam MapIcon).
  • Etiquetas de Pin:MapIcon Não suporta etiquetas ou janelas de informação.
  • Mapa.Clicado (fundo): Só MapElement os cliques disparam eventos, não os cliques da área vazia do mapa.
Consulte MapHandler a documentação para informações detalhadas sobre plataformas.

Aplica-se a