Azure Maps Android SDK の概要

[アーティクル]
03/29/2023

Azure Maps Android SDK は、Android 用のベクターマップライブラリです。この記事では、Azure Maps Android SDK のインストールおよびマップの読み込みのプロセスを説明します。

Note

Azure Maps Android SDK の廃止

Android 用 Azure Maps Native SDK は非推奨となり、2025 年 3 月 31 日に廃止されます。サービスの中断を回避するには、2025 年 3 月 31 日までに Azure Maps Web SDK に移行します。詳細については、「Azure Maps Android SDK 移行ガイド」を参照してください。

前提条件

必ず、Android アプリ作成のクイックスタートに関する記事の手順を完了してください。

マップのローカライズ

Azure Maps Android SDK には、マップの言語と地域ビューを設定する方法が 3 つ用意されています。次のコードは、言語をフランス語 ("fr-FR") に、地域ビューを "Auto" に設定する方法を示しています。

静的な setLanguage および setView プロパティを使用し、言語と地域ビューの情報を AzureMaps クラスに渡します。これでアプリに既定の言語と地域ビューのプロパティが設定されます。

static {
    //Alternatively use Azure Active Directory authenticate.
    AzureMaps.setAadProperties("<Your aad clientId>", "<Your aad AppId>", "<Your aad Tenant>");

    //Set your Azure Maps Key.
    //AzureMaps.setSubscriptionKey("<Your Azure Maps Key>");   

    //Set the language to be used by Azure Maps.
    AzureMaps.setLanguage("fr-FR");

    //Set the regional view to be used by Azure Maps.
    AzureMaps.setView("Auto");
}

companion object {
    init {
        //Alternatively use Azure Active Directory authenticate.
        AzureMaps.setAadProperties("<Your aad clientId>", "<Your aad AppId>", "<Your aad Tenant>");

        //Set your Azure Maps Key.
        //AzureMaps.setSubscriptionKey("<Your Azure Maps Key>");

        //Set the language to be used by Azure Maps.
        AzureMaps.setLanguage("fr-FR");

        //Set the regional view to be used by Azure Maps.
        AzureMaps.setView("Auto");
    }
}

言語と地域ビューの情報はマップコントロール XML に渡すこともできます。

<com.azure.android.maps.control.MapControl
    android:id="@+id/myMap"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:azure_maps_language="fr-FR"
    app:azure_maps_view="Auto"
    />

言語と地域ビューのプロパティをプログラミングで設定する最後の方法では、マップの setStyle メソッドを使用します。これは、マップの言語と地域ビューを変更するときにいつでも実行できます。
```
mapControl.onReady(map -> {
    map.setStyle(
        language("fr-FR"),
        view("Auto")
    );
});
```
```
mapControl.onReady(OnReady { map: AzureMap ->
    map.setStyle(
        language("fr-FR"),
        view("Auto")
    )
})
```

言語が "fr-FR" に設定され、地域ビューが "Auto" に設定されている Azure Maps の例を次に示します。

Azure Maps、ラベルをフランス語で表示するマップイメージ

サポートされている言語と地域ビューの完全な一覧については、「Azure Maps でのローカライズのサポート」を参照してください。

マップ内を移動する

マップをズーム、パン、回転、およびピッチ調整する方法は複数存在します。以下では、マップ内を移動するときのさまざまな方法をすべて詳しく説明します。

マップをズームする

2 本の指でマップをタッチし、指でつまむようにすると縮小し、指を広げると拡大します。
マップをダブルタップし、1 レベル分拡大します。
2 本の指でダブルタップし、マップを 1 レベル分縮小します。
2 回タップします。2 回目のタップで指をマップに置いたままにして、上にドラッグすると拡大し、下にドラッグすると縮小します。

マップをパンする

マップをタッチし、任意の方向にドラッグします。

マップを回転する

2 本の指でマップをタッチし、回転します。

マップのピッチを調整する

2 本の指でマップをタッチして、上または下にドラッグします。

Azure Government クラウドのサポート

Azure Maps Android SDK では、Azure Government クラウドがサポートされています。 Azure Maps Android SDK には、同じ Maven リポジトリからアクセスします。 Azure Maps プラットフォームの Azure Government クラウドバージョンに接続するには、次のタスクを実行する必要があります。

Azure Maps 認証の詳細が指定されているのと同じ場所で、次のコード行を追加して、Azure Maps Government クラウドドメインを使用するようにマップに指示します。

AzureMaps.setDomain("atlas.azure.us");

AzureMaps.setDomain("atlas.azure.us")

マップとサービスを認証するときは、Azure Government クラウドプラットフォームからの Azure Maps 認証の詳細を必ず使用してください。

プレビューバージョンから移行する

プレビューから一般提供への移行に伴い、Azure Maps Android SDK にいくつかの破壊的変更が導入されています。主な内容は次のとおりです。

Maven 識別子が "com.microsoft.azure.maps:mapcontrol:0.7" から "com.azure.android:azure-maps-control:1.0.0" に変更されました。名前空間とメジャーバージョン番号が変更されました。
インポート名前空間が com.microsoft.azure.maps.mapcontrol から com.azure.android.maps.control に変更されました。

XML オプション、色リソース、画像リソースのリソース名のテキストが mapcontrol_ から azure_maps_ に置き換えられています。

前:

<com.microsoft.azure.maps.mapcontrol.MapControl
    android:id="@+id/myMap"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:mapcontrol_language="fr-FR"
    app:mapcontrol_view="Auto"
    app:mapcontrol_centerLat="47.602806"
    app:mapcontrol_centerLng="-122.329330"
    app:mapcontrol_zoom="12"
/>

後:

<com.azure.android.maps.control.MapControl
    android:id="@+id/myMap"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:azure_maps_language="fr-FR"
    app:azure_maps_view="Auto"
    app:azure_maps_centerLat="47.602806"
    app:azure_maps_centerLng="-122.329330"
    app:azure_maps_zoom="12"
/>