Aan de slag met Azure Kaarten Android SDK

Artikel
11/04/2021
3 minuten om te lezen

De Azure Kaarten Android SDK is een vectorkaartbibliotheek voor Android. Dit artikel begeleidt u door de processen voor het installeren van de Azure Kaarten Android SDK en het laden van een kaart.

Vereisten

Voltooi de stappen in het artikel Quickstart: Een Android-app maken.

Lokaliseren van de kaart

De Azure Kaarten Android SDK biedt drie manieren om de taal en regionale weergave van de kaart in te stellen. De volgende code laat zien hoe u de taal in kunt stellen op Frans (fr-FR) en de regionale weergave op 'Auto'.

Geef de taal- en regionale weergavegegevens door aan de AzureMaps klasse met behulp van de statische eigenschappen en setLanguage setView . Hiermee worden de standaardtaal en regionale weergave-eigenschappen in uw app ingesteld.

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

U kunt ook de taal- en regionale weergavegegevens doorgeven aan de XML van het kaartbesturingselement.

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

De laatste manier om programmatisch de taal- en regionale weergave-eigenschappen in te stellen, maakt gebruik van de methode setStyle maps. Dit kan op elk moment worden gedaan om de taal en de regionale weergave van de kaart te wijzigen.
```
mapControl.onReady(map -> {
    map.setStyle(
        language("fr-FR"),
        view("Auto")
    );
});
```
```
mapControl.onReady(OnReady { map: AzureMap ->
    map.setStyle(
        language("fr-FR"),
        view("Auto")
    )
})
```

Hier is een voorbeeld van Azure Kaarten met de taal ingesteld op fr-FR en regionale weergave ingesteld op 'Auto'.

Azure Kaarten, kaartafbeelding met labels in het Frans

Zie Lokalisatieondersteuning in Azure Kaarten voor een volledige lijst met ondersteunde talen en regionale weergaven.

Door de kaart navigeren

Er zijn verschillende manieren waarop de kaart kan worden ingezoomd, gedraaid, gedraaid en gedraaid. Hieronder worden alle verschillende manieren om door de kaart te navigeren begegevens weergegeven.

De kaart inzoomen

Aanraak de kaart met twee vingers en knijpen om uit te zoomen of de vingers uit elkaar te verspreiden om in te zoomen.
Dubbelklik op de kaart om op één niveau in te zoomen.
Dubbel tikken met twee vingers om één niveau uit te zoomen op de kaart.
Tik twee keer; houd bij de tweede tik uw vinger op de kaart en sleep omhoog om in te zoomen of omlaag om uit te zoomen.

De kaart pannen

Tik op de kaart en sleep deze in elke richting.

De kaart draaien

Aanraak de kaart met twee vingers en draai deze.

De kaart pitchen

Tik met twee vingers op de kaart en sleep ze omhoog of omlaag.

Azure Government cloudondersteuning

De Azure Kaarten Android SDK ondersteunt de Azure Government cloud. De Azure Kaarten Android SDK is toegankelijk vanuit dezelfde Maven-opslagplaats. De volgende taken moeten worden uitgevoerd om verbinding te maken met de Azure Government cloudversie van het Azure Kaarten platform.

Op dezelfde plaats waar de Azure Kaarten-verificatiegegevens zijn opgegeven, voegt u de volgende coderegel toe om de kaart te laten weten dat het clouddomein van Azure Kaarten government moet worden gebruikt.

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

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

Zorg ervoor dat u Azure Kaarten verificatiegegevens van het Azure Government cloudplatform gebruikt bij het authenticeren van de kaart en services.

Migreren vanuit een preview-versie

Met de overstap van preview naar algemene beschikbaarheid zijn enkele belangrijke wijzigingen geïntroduceerd in de Azure Kaarten Android SDK. Hier volgen de belangrijkste details:

De Maven-id is gewijzigd "com.microsoft.azure.maps:mapcontrol:0.7" van in "com.azure.android:azure-maps-control:1.0.0" . De naamruimte en het nummer van de belangrijkste versie zijn gewijzigd.
De importnaamruimte is gewijzigd van com.microsoft.azure.maps.mapcontrol in com.azure.android.maps.control

Voor resourcenamen voor XML-opties, kleurresources en afbeeldingsresources is de tekst mapcontrol_ vervangen door azure_maps_ .

Voor:

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

Na:

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