začínáme s Azure Maps Android SDK

Článek
11/04/2021
3 min ke čtení

Azure Maps Android SDK je knihovna vektorových map pro Android. tento článek vás provede procesy instalace Azure Maps Android SDK a načtení mapy.

Požadavky

Ujistěte se, že jste dokončili kroky v článku rychlý Start: Vytvoření aplikace pro Android .

Lokalizace mapy

Azure Maps Android SDK poskytuje tři způsoby, jak nastavit jazyk a regionální zobrazení mapy. Následující kód ukazuje, jak nastavit jazyk na francouzštinu ("fr-FR") a místní zobrazení na "auto".

Předejte informace o jazyce a regionálních zobrazení do AzureMaps třídy pomocí statických setLanguage setView vlastností a. Tím se v aplikaci nastaví výchozí jazyk a vlastnosti místního zobrazení.

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

Do XML mapového ovládacího prvku můžete také předat informace o jazyce a regionálním zobrazení.

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

Poslední způsob, jak programově nastavit vlastnosti jazyka a regionu, používá setStyle metodu map. To lze provést kdykoli, chcete-li změnit jazyk a regionální zobrazení mapy.

mapControl.onReady(map -> {
    map.setStyle(
        language("fr-FR"),
        view("Auto")
    );
});

mapControl.onReady(OnReady { map: AzureMap ->
    map.setStyle(
        language("fr-FR"),
        view("Auto")
    )
})

tady je příklad Azure Maps s jazykem, který je nastaven na "fr-fr" a místní zobrazení nastavené na "Auto".

Azure Maps, obrázek mapy znázorňující popisky ve francouzštině

Úplný seznam podporovaných jazyků a regionálních zobrazení najdete v tématu Podpora lokalizace v Azure Maps.

Navigace v mapě

Existuje několik různých způsobů, jak lze mapu zvětšit, vytočit, otočit a rozteč. Následující podrobnosti jsou všechny různými způsoby navigace v mapě.

Zvětšit mapu

Připojte se k mapě pomocí dvou prsty a gesto roztažení prstů společně, abyste se přiblížili nebo rozdělili prsty.
Poklepáním na mapu přiblížíte jednu úroveň.
Poklikáním na dva prsty přiblížíte rozvržení na jednu úroveň.
Klepněte dvakrát; při druhém klepněte na mapu na mapě a přetažením nahoru nebo dolů zmenšete zobrazení.

Posouvání mapy

Najeďte na mapu a táhněte v libovolném směru.

Otočit mapu

Dotkněte se mapy pomocí dvou prsty a otočení.

Rozteč mapy

Dotkněte se mapy dvěma prsty a přetáhněte je dohromady nahoru nebo dolů.

Podpora cloudu Azure Government

Azure Maps Android SDK podporuje cloud Azure Government. k Android SDK Azure Maps se dostanete ze stejného úložiště Maven. aby bylo možné se připojit ke cloudové verzi Azure Government Azure Maps platformy, bude nutné provést následující úlohy.

na stejném místě, kde jsou zadány podrobnosti ověření Azure Maps, přidejte následující řádek kódu, který oznámí mapě použití cloudové domény Azure Maps státní správy.

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

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

při ověřování map a služeb nezapomeňte použít podrobnosti ověřování Azure Maps z Azure Government cloudové platformy.

Migrace z verze Preview

s přesunem z verze preview na obecnou dostupnost byly do Azure Maps Android SDK zavedeny některé zásadní změny. Níže jsou uvedeny podrobnosti o klíči:

Identifikátor Maven se změnil z "com.microsoft.azure.maps:mapcontrol:0.7" na "com.azure.android:azure-maps-control:1.0.0" . Obor názvů a hlavní číslo verze se změnily.
Obor názvů importu se změnil z com.microsoft.azure.maps.mapcontrol na. com.azure.android.maps.control

Názvy prostředků pro možnosti XML, zdroje barev a zdroje obrázků mají text mapcontrol_ nahrazený textem azure_maps_ .

Před:

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

Po:

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