Как установить Maps SDK для Android, версия 3.1.0 БЕТА

В этом руководстве рассказывается, как установить Maps SDK для Android (версию 3.1.0 БЕТА). Завершив установку, узнайте, как пользоваться новыми функциями.

Как установить Maps SDK для Android, версия 3.1.0 БЕТА

Чтобы вручную добавить клиентскую библиотеку Maps SDK для Android версии 3.1.0 БЕТА в свой проект Android Studio, выполните указанные ниже действия.

Примечание. Maps SDK для Android требует как минимум API 16. Убедитесь, что параметр minSdkVersion в вашем приложении имеет значение API 16 или выше.

Скачайте статическую библиотеку Places (этот шаг можно пропустить, если вы не используете Places).
- places-maps-sdk-3.1.0-beta.aar – необязательно. Используется только с Картами версии 3.1.0 БЕТА.
Скопируйте файл AAR в папку app/libs своего проекта Android Studio.

Библиотека Maps SDK для Android доступна в репозитории Google Maven. Чтобы добавить SDK в свое приложение, выполните следующие действия:

В разделе buildscript.repositories файла верхнего уровня build.gradle должно быть указано хранилище Google Maven:
```
buildscript {
    repositories {
        google()
        // ...
    }
}
```

В разделе dependencies файла уровня приложения build.gradle добавьте Maps SDK для Android и (при необходимости) статическую библиотеку Places и ее требуемые зависимости:

dependencies {
  implementation 'com.google.android.libraries.maps:maps:3.1.0-beta'

  // If you are using Places, add all of the dependencies below
  implementation name:'places-maps-sdk-3.1.0-beta', ext:'aar'
  implementation 'com.google.android.gms:play-services-gcm:17.0.0'
  implementation 'com.google.auto.value:auto-value-annotations:1.6.2'
}

Если вы используете новые библиотеки AndroidX, задайте параметры android.useAndroidX=true и android.enableJetifier=true в файле gradle.properties. По умолчанию у них должно быть значение true, если используется Android Studio версии 3.2 или выше.

В разделе dependencies файла build.gradle уровня приложения удалите строку implementation для прежней версии. Она должна выглядеть примерно так:

implementation 'com.google.android.gms:play-services-maps:17.0.0'

Если вы клиент платформы Google Карт с пакетом услуг Premium Plan, то строка implementation, которую нужно удалить, будет выглядеть как в одном из следующих примеров:

implementation(name:'google-maps-sdk-m4b', ext:'aar')
implementation project(':googlemapssdkm4b_lib')

Синхронизируйте свой проект Gradle.
Преобразуйте существующие конфигурации.
- Если в вашем существующем приложении используется Maps SDK для Android через сервисы Google Play, замените все упоминания пакета com.google.android.gms.maps на com.google.android.libraries.maps. Для этого в Android Studio нажмите Edit (Изменить) > Replace in Path (Заменить в указанном каталоге).
- Если в существующем приложении используется платформа Google Карт с пакетом услуг Premium Plan, замените все упоминания пакета com.google.android.m4b.maps на com.google.android.libraries.maps. Кроме того, удалите префикс m4b_ из всех упоминаний атрибутов макета XML. Например, m4b_mapType нужно заменить на mapType, а m4b_cameraZoom – на cameraZoom.
Настройте в правилах ProGuard сохранение классов Maps SDK для Android, если в конечной сборке выполняются сжатие кода и обфускация.
```
-keep,allowoptimization class com.google.android.libraries.maps.** { *; }
```

Как импортировать библиотеку утилит, совместимую с бета-версией

Если вы используете библиотеку утилит Google Maps для Android, необходимо обновить зависимости вашего проекта, заменив существующую версию библиотеки на бета-совместимую. Для этого выполните следующие действия:

Импортируйте бета-совместимую библиотеку утилит в файле build.gradle:
```
implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
```
Удалите следующую строку из файла build.gradle, чтобы удалить несовместимую библиотеку утилит:
```
implementation 'com.google.maps.android:android-maps-utils:1.3.1'
```

Как запустить приложения–примеры

В репозитории Google Samples на сайте GitHub доступны примеры приложений, где демонстрируется использование Maps SDK для Android версии 3.1.0 БЕТА.

Примеры приложений с интеграцией Maps SDK для Android
Примеры приложений с интеграцией Places SDK для Android (только для использования с Картами версии 3.1.0 БЕТА)