AppHostBuilderExtensions.UseMauiMaps(MauiAppBuilder) メソッド

定義

MauiAppBuilder コントロールのサポートを追加するようにMapを構成します。

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

パラメーター

builder
MauiAppBuilder

構成する MauiAppBuilder

例外

マップ コントロールが現在Windowsに対して実装されていないため、Windowsでスローされます。

注釈

Windows (Azure Maps):ConfigureEssentialsを使用してAzure Mapsサブスクリプション キーを設定します。

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

Azure portalからキーを取得する: https://portal.azure.com → Azure Maps アカウント→認証

Windows機能 (Azure Maps JS API を使用): Windows実装では、Azure Mapsによってサポートされる WinUI 3 MapControl が使用されます。 コントロールの内部 WebView2 を介してAzure Maps JavaScript APIにアクセスすることで、次の機能が実装されます。

  • MoveToRegion:map.setCamera()経由で移動します。
  • MapType:map.setStyle()経由の Street/Satellite/Hybrid。
  • IsTrafficEnabled:map.setTraffic()経由のトラフィック フローとインシデント。
  • IsScrollEnabled/IsZoomEnabled:map.setUserInteraction()による独立した制御。
  • ピン:MapElementsLayerMapIcon経由。

Windows プラットフォームの制限事項:

  • ユーザーの場所: 組み込みではありません。には、Geolocation API の手動統合が必要です。
  • 図形: ポリライン、ポリゴン、および円はサポートされていません (MapElementsLayerMapIconのみをサポートします)。
  • ラベルをピン留めする:MapIcon では、ラベルや情報ウィンドウはサポートされていません。
  • Map.Clicked (背景):MapElementクリックのみがイベントを発生し、空のマップ領域のクリックは発生しません。
プラットフォームの詳細については、 MapHandler ドキュメントを参照してください。

適用対象