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

Выбор языка программирования

Java (Android) Kotlin (Android)

Пакет 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".

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

   Java

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

   Kotlin

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

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

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

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

   Java

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

   Kotlin

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

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

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

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

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

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

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

Сдвиг карты

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

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

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

Наклон карты

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

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

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

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

Java

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

Kotlin

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_.

  До:

  XML

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

  После:

  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"
      app:azure_maps_centerLat="47.602806"
      app:azure_maps_centerLng="-122.329330"
      app:azure_maps_zoom="12"
  />
  

Следующие шаги

Узнайте, как добавить данные наложения на карту:

Управление проверкой подлинности в Azure Карты

Изменение стилей карт Android

Добавление слоя символов

Добавление слоя линий

Добавление слоя многоугольников