Komma igång med Azure Kartor Android SDK

Artikel
11/04/2021
3 minuter för att läsa

Azure Kartor Android SDK är ett vektorkartbibliotek för Android. Den här artikeln vägleder dig genom processerna för att installera Azure Kartor Android SDK och läsa in en karta.

Förutsättningar

Se till att slutföra stegen i artikeln Snabbstart: Skapa en Android-app.

Lokalisera kartan

Azure Kartor Android SDK erbjuder tre sätt att ange språk och regional vy på kartan. Följande kod visar hur du ställer in språket på franska ("fr-FR") och den regionala vyn till "Auto".

Skicka information om språk och regional vy till klassen AzureMaps med hjälp av egenskaperna static och setLanguage setView . Detta anger standardspråk och regionala vyegenskaper i din app.

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

Du kan också skicka språk- och regional visningsinformation till XML-kartkontrollen.

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

Det sista sättet att programmässigt ställa in egenskaperna för språk och regional vy använder metoden setStyle maps. Detta kan göras när som helst för att ändra språk och regional vy på kartan.

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

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

Här är ett exempel på Azure Kartor med språket inställt på "fr-FR" och regional vy inställd på "Auto".

Azure Kartor, kartbild som visar etiketter på franska

En fullständig lista över språk och regionala vyer som stöds finns i Lokaliseringsstöd i Azure Kartor.

Navigera på kartan

Det finns flera olika sätt att zooma, rotera, rotera och visa kartan på. Följande beskriver alla de olika sätten att navigera på kartan.

Zooma kartan

Tryck på kartan med två händer och dra ihop för att zooma ut eller sprida ut tummarna för att zooma in.
Dubbelklicka på kartan för att zooma på en nivå.
Dubbeltryck med två zoomning för att zooma ut kartan en nivå.
Tryck två gånger; vid andra tryckning håller du ditt finger på kartan och drar uppåt för att zooma in eller ned för att zooma ut.

Panorera kartan

Tryck på kartan och dra i valfri riktning.

Rotera kartan

Rör vid kartan med två händer och rotera.

Visa kartan

Rör kartan med två händer och dra dem uppåt eller nedåt.

Azure Government molnstöd

Azure Kartor Android SDK stöder Azure Government molnet. Azure Kartor Android SDK nås från samma Maven-lagringsplats. Följande uppgifter måste utföras för att ansluta till den Azure Government molnversionen av Azure Kartor plattformen.

På samma plats där autentiseringsinformationen för Azure Kartor har angetts lägger du till följande kodrad för att be kartan att använda molndomänen Azure Kartor Government.

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

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

Se till att använda Azure Kartor autentiseringsinformation från Azure Government-molnplattformen när du autentiserar kartan och tjänsterna.

Migrera från en förhandsversion

Med flytten från förhandsversion till allmän tillgänglighet introducerades vissa större ändringar i Azure Kartor Android SDK. Här följer viktig information:

Maven-identifieraren har ändrats "com.microsoft.azure.maps:mapcontrol:0.7" från till "com.azure.android:azure-maps-control:1.0.0" . Namnområdet och huvudversionsnumret har ändrats.
Importnamnområdet har ändrats från com.microsoft.azure.maps.mapcontrol till com.azure.android.maps.control

Resursnamn för XML-alternativ, färgresurser och bildresurser har fått texten mapcontrol_ ersatt med azure_maps_ .

Innan:

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

Efter:

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