Начало работы с пакетом SDK для Android для Azure Maps

Статья
04/07/2024

Пакет SDK для Android для Azure Maps — это библиотека векторных карт для Android. В этой статье описывается, как установить пакет SDK для Android для Azure Maps и загрузить карту.

Примечание.

Прекращение использования пакета SDK для Android для Azure Карты

Пакет SDK для машинного кода Azure для Android Карты теперь устарел и будет прекращен 3.31.25. Чтобы избежать сбоев в работе служб, перейдите в веб-пакет SDK для Azure Карты на 3.31.25. Дополнительные сведения см. в руководстве по миграции пакета SDK для Android Карты Azure.

Необходимые компоненты

Обязательно выполните действия, описанные в кратком руководстве по созданию приложения Android.

Локализация карты

Пакет SDK для Azure Maps для Android предоставляет три разных способа настройки языка и регионального представления для карты. В приведенном ниже коде показано, как установить французский язык (fr-FR) и региональное представление со значением "Auto".

Передайте сведения о языке и региональном представлении в класс AzureMaps, используя статические свойства setLanguage и setView. Это задает свойства языка по умолчанию и регионального представления в вашем приложении.

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

Можно также передать сведения о языке и региональном представлении в XML-код элемента управления картой.

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

Последний способ программной установки свойств языка и регионального представления использует метод setStyle карт. Это можно сделать в любое время, чтобы изменить язык и региональное представление для карты.
```
mapControl.onReady(map -> {
    map.setStyle(
        language("fr-FR"),
        view("Auto")
    );
});
```
```
mapControl.onReady(OnReady { map: AzureMap ->
    map.setStyle(
        language("fr-FR"),
        view("Auto")
    )
})
```

Ниже приведен пример Azure Карты с языковым значением fr-FR и региональным представлением, равным "Auto".

Изображение карты Azure Maps с надписями на французском языке

Полный список поддерживаемых языков и региональных представлений см. в разделе Поддержка локализации в Azure Maps.

Перемещение по карте

Существует несколько способов, с помощью которых можно увеличить, сдвинуть, повернуть и наклонить карту. Ниже описаны различные способы перемещения по карте.

Изменение масштаба карты

Коснитесь карты двумя пальцами и сведите их, чтобы уменьшить карту, или разведите пальцы, чтобы увеличить ее.
Дважды коснитесь карты, чтобы увеличить ее масштаб на один уровень.
Дважды коснитесь карты двумя пальцами, чтобы уменьшить ее масштаб на один уровень.
Коснитесь карты дважды, и при втором касании, удерживая палец на карте, проведите вверх, чтобы увеличить карту, либо проведите вниз, чтобы уменьшить ее.

Сдвиг карты

Коснитесь карты и проведите в любом направлении.

Поворот карты

Коснитесь карты двумя пальцами и вращайте ее.

Наклон карты

Коснитесь карты двумя пальцами и проведите ими вверх или вниз.

Поддержка облака Azure для государственных организаций

Пакет SDK Azure Maps для Android поддерживает облако Azure для государственных организаций. Пакет SDK Azure Maps для Android доступен в том же репозитории Maven. Для подключения к Azure для государственных организаций облачной версии платформы Azure Карты необходимо выполнить следующие задачи.

В том же месте, где заданы данные аутентификации Azure Maps, добавьте следующую строку кода, чтобы указать карте использовать домен Azure Maps в облаке для государственных организаций.

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

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

При проверке подлинности карт и служб обязательно используйте сведения о проверке подлинности Azure Maps на облачной платформе Azure для государственных организаций.

Переход с предварительной версии

При переход с предварительной на общедоступную версию в пакете SDK Azure Maps для Android были представлены некоторые критические изменения. В их числе следующие:

Идентификатор maven изменен с "com.microsoft.azure.maps:mapcontrol:0.7" на "com.azure.android:azure-maps-control:1.0.0". Пространство имен и номер основной версии изменены.
Пространство имен импорта изменено с com.microsoft.azure.maps.mapcontrol на com.azure.android.maps.control.

В именах ресурсов для параметров XML, ресурсов цветов и изображений заменен текст mapcontrol_ на azure_maps_.

До:

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

После:

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