Az Azure Térképek Android SDK használatának első lépései
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 statikussetLanguage
éssetView
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.
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" />
Következő lépések
Ismerje meg, hogyan adhat hozzá átfedési adatokat a térképen: