Az Azure Térképek Android SDK használatának első lépései

Cikk
04/07/2024

Az Azure Térképek Android SDK egy vektortérkép-kódtár Androidhoz. Ez a cikk végigvezeti az Azure Térképek Android SDK telepítésének és a térkép betöltésének folyamatán.

Feljegyzés

Az Azure Térképek Android SDK kivonása

Az Androidhoz készült Azure Térképek Natív SDK elavult, és 25.31-én megszűnik. A szolgáltatáskimaradások elkerülése érdekében 25.31-ig migráljon az Azure Térképek Web SDK-ba. További információ: Az Azure Térképek Android SDK migrálási útmutatója.

Előfeltételek

Mindenképpen végezze el a rövid útmutató lépéseit: Android-alkalmazás létrehozása.

A térkép honosítása

Az Azure Térképek Android SDK háromféleképpen állíthatja be a térkép nyelvét és regionális nézetét. Az alábbi kód bemutatja, hogyan állíthatja be a nyelvet francia ("fr-FR") értékre, a regionális nézetet pedig "Auto" értékre.

Adja át a nyelvi és regionális nézet adatait az AzureMaps osztálynak a statikus setLanguage és setView a tulajdonságok használatával. Ezzel beállítja az alkalmazás alapértelmezett nyelvi és regionális nézettulajdonságait.

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");
    }
}

A nyelv és a regionális nézet adatait a térképvezérlő XML-fájljának is átadhatja.

<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"
    />

A nyelvi és regionális nézettulajdonságok programozott módon történő beállításának végső módja a térképmetódus setStyle . Ez bármikor elvégezhető a térkép nyelvének és regionális nézetének módosításához.
```
mapControl.onReady(map -> {
    map.setStyle(
        language("fr-FR"),
        view("Auto")
    );
});
```
```
mapControl.onReady(OnReady { map: AzureMap ->
    map.setStyle(
        language("fr-FR"),
        view("Auto")
    )
})
```

Íme egy példa az Azure Térképek az "fr-FR" nyelvre, a regionális nézet pedig "Auto" értékre.

Az Azure Térképek, a címkéket francia nyelven ábrázoló térképkép

A támogatott nyelvek és regionális nézetek teljes listájáért tekintse meg az Azure Térképek honosítási támogatását.

Navigálás a térképen

A térkép többféleképpen is nagyítható, pásztázható, elforgatható és dobható. Az alábbi ábra részletesen ismerteti a térképen való navigálás különböző módjait.

A térkép nagyítása

Érintse meg a térképet két ujjal, és csippentsen össze, hogy kicsinyítse vagy szétterjessze az ujjait a nagyításhoz.
Koppintson duplán a térképre egy szint nagyításához.
Két ujjal duplán koppintva kicsinyítheti a térképet egy szinttel.
Koppintson kétszer; a második koppintás során tartsa lenyomva az ujját a térképen, és húzza felfelé a nagyításhoz, vagy lefelé a nagyításhoz.

A térkép pásztázása

Érintse meg a térképet, és húzza bármelyik irányba.

A térkép elforgatása

Érintse meg a térképet két ujjal, és forgassa el.

A térkép felosztása

Két ujjal érintse meg a térképet, és húzza őket felfelé vagy lefelé.

Az Azure Government felhőtámogatása

Az Azure Térképek Android SDK támogatja az Azure Government-felhőt. Az Azure Térképek Android SDK ugyanabból a Maven-adattárból érhető el. A következő feladatokat kell elvégezni az Azure Térképek platform Azure Government felhőalapú verziójához való csatlakozáshoz.

Ugyanazon a helyen, ahol az Azure Térképek hitelesítési adatai meg vannak adva, adja hozzá a következő kódsort, amely tájékoztatja a térképet az Azure Térképek kormányzati felhőtartomány használatára.

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

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

A térkép és a szolgáltatások hitelesítésekor mindenképpen használja az Azure Térképek hitelesítési adatait az Azure Government felhőplatformjáról.

Migrálás előzetes verzióról

Az előzetes verzióról az általános rendelkezésre állásra való áttéréssel néhány kompatibilitástörő változás jelent meg az Azure Térképek Android SDK-ban. A legfontosabb részletek a következők:

A maven-azonosító a következőre "com.azure.android:azure-maps-control:1.0.0"változott"com.microsoft.azure.maps:mapcontrol:0.7": . A névtér és a főverzió száma megváltozott.
Az importálási névtér a következőre com.microsoft.azure.maps.mapcontrol változott: com.azure.android.maps.control

Az XML-beállítások, a színerőforrások és a képerőforrások erőforrásnevei a szöveget lecserélték a következőre mapcontrol_azure_maps_: .

Előtt:

<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"
/>

Után:

<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"
/>