AppHostBuilderExtensions.UseMauiMaps(MauiAppBuilder) Methode

Definition

Namespace:
Microsoft.Maui.Controls.Hosting
Assemblys:
Microsoft.Maui.Controls.dll, Microsoft.Maui.Controls.Maps.dll, Microsoft.Maui.Controls.Xaml.dll
Quelle:
AppHostBuilderExtensions.cs
Quelle:
AppHostBuilderExtensions.cs
Quelle:
AppHostBuilderExtensions.cs
Quelle:
AppHostBuilderExtensions.cs

MauiAppBuilder Konfiguriert, um Unterstützung für das Map Steuerelement hinzuzufügen.

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

Parameter

builder
MauiAppBuilder

Der MauiAppBuilder zu konfigurierende

Ausnahmen

NotImplementedException

Wird auf Windows ausgelöst, da das Kartensteuerelement derzeit nicht für Windows implementiert ist.

Hinweise

Windows (Azure Maps): Legen Sie Ihren Azure Maps Abonnementschlüssel mithilfe von ConfigureEssentials:

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

Abrufen eines Schlüssels aus dem Azure-Portal: https://portal.azure.com → Azure Maps Konto → Authentifizierung

Windows Features (über Azure Maps JS-API): Die Windows Implementierung verwendet winUI 3 MapControl, das von Azure Maps unterstützt wird. Die folgenden Features werden durch Den Zugriff auf die Azure Maps JavaScript-API über das interne WebView2 des Steuerelements implementiert:

  • MoveToRegion: Navigiert über map.setCamera().
  • MapType: Straße/Satellit/Hybrid über map.setStyle().
  • IsTrafficEnabled: Datenverkehrsfluss und Vorfälle über map.setTraffic().
  • IsScrollEnabled/IsZoomEnabled: Unabhängige Steuerung über map.setUserInteraction().
  • Pins: Via MapIcon auf einem MapElementsLayer.

Windows Plattformbeschränkungen:

  • Benutzerspeicherort: Nicht integriert; erfordert manuelle Geolocation-API-Integration.
  • Shapes: Polylinien, Polygone und Kreise werden nicht unterstützt (MapElementsLayer nur unterstützt MapIcon).
  • Anheften von Etiketten:MapIcon unterstützt keine Bezeichnungen oder Infofenster.
  • Map.Clicked (Hintergrund): Nur MapElement klickt auf Feuerereignisse, nicht leere Kartenbereichsklicks.
Ausführliche Informationen zur Plattform finden Sie MapHandler in der Dokumentation.

Gilt für: