Конфигурация проекта

Эта страница продолжает руководство по началу работы. Здесь вы найдете все сведения о конфигурации для проекта, связанного с Maps SDK for Android в приложении для Android.

Обзор

Чтобы добавить карту в приложение для Android, выполните следующие действия:

  1. Установите Android Studio.
  2. Установите и настройте SDK Google Play, в который входит Maps SDK for Android. Примечание. Если вы хотите использовать Maps SDK for Android совместно с лицензией платформы Google Карт с премиум-планом, скачайте и установите Premium Plan SDK.
  3. Получите ключ API. Для этого вам необходимо зарегистрировать проект в Google Cloud Platform Console, создать ключ API и ограничить доступ к нему с помощью цифрового сертификата для приложения.
  4. Добавьте в манифест приложения необходимые параметры.

Далее приведены подробные описания каждого шага этого процесса.

1. Скачайте Android Studio

Следуйте инструкциям по скачиванию и установке Android Studio.

2. Установите SDK сервисов Google Play

Вам потребуется создать для своего приложения проект Android. Если у вас ещё нет приложения для Android, можете воспользоваться руководством по созданию приложения Hello World.

Maps SDK for Android is распространяется как часть SDK сервисов Google Play, который можно загрузить с помощью Android SDK Manager.

Пошаговые инструкции приведены в документации по сервисам Google Play.

Получите ключ Google Maps API

Чтобы использовать Maps SDK for Android, вам необходимо зарегистрировать свой проект приложения в Google Cloud Platform Console и получить ключ Google API, который вы можете добавить в приложение.

Более подробную информацию вы можете найти в руководстве по получению ключа API.

Добавьте в манифест приложения необходимые параметры

Откройте файл AndroidManifest.xml и добавьте в него перечисленные ниже параметры.

Номер версии сервисов Google Play

Добавьте в элемент <application> объекта AndroidManifest.xml приведенный ниже код, чтобы указать версию сервисов Google Play, которая использовалась при компиляции приложения.

<meta-data
    android:name="com.google.android.gms.version"
    android:value="@integer/google_play_services_version" />

Ключ API

Обязательно добавьте свой ключ API в файл AndroidManifest.xml согласно описанию в руководстве.

Разрешения для Android

Чтобы задать необходимые разрешения, добавьте элементы <uses-permission> в качестве дочерних элементов <manifest> в объекте AndroidManifest.xml.

Доступ к данным о местоположении

Если ваше приложение обращается к данным о текущем местоположении пользователя с применением слоя "Мое местоположение", вам необходимо запросить доступ к данным о местоположении, как это описано в руководстве.

Разрешение на доступ к внешнему хранилищу

Если ваше приложение предназначено для SDK сервисов Google Play версии 8.3 или более поздней, вам больше не понадобится разрешение WRITE_EXTERNAL_STORAGE на использование Maps SDK for Android.

Если же ваше приложение предназначено для более ранних версий, необходимо запросить разрешение android.permission.WRITE_EXTERNAL_STORAGE.

<uses-permission
        android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Примечание. Если ваше приложение предназначено для API уровня 23 (Android 6.0), который требует использования разрешений для выполнения, вам необходимо работать с SDK сервисов Google Play версии 8.3 или более поздней.

Разрешения, автоматически добавляемые в манифест

Указанные ниже разрешения определяются в манифесте сервисов Google Play и автоматически добавляются в манифест вашего приложения при сборке. Вам не нужно указывать их явным образом.

  • android.permission.INTERNET используется API для скачивания фрагментов карты с серверов Google.
  • android.permission.ACCESS_NETWORK_STATE позволяет API проверять состояние подключения, чтобы определить, возможно ли скачать данные.

Требования к OpenGL ES версии 2

Для обработки карты Maps SDK for Android использует интерфейс OpenGL ES версии 2. Указанный ниже параметр определяется в манифесте сервисов Google Play и автоматически добавляется в манифест вашего приложения при сборке. Вам не нужно указывать его явным образом.

<uses-feature
        android:glEsVersion="0x00020000"
        android:required="true"/>

Таким образом внешние сервисы получат информацию о требовании. В частности, из-за этого Google Play Маркет не будет отображать ваше приложение для устройств, которые не поддерживают OpenGL ES версии 2.

Требования для библиотеки Apache HTTP Legacy

Если вы используете версию com.google.android.gms:play-services-maps:16.0.0 или более ранние, но ваше приложение обращается к API 28 уровня (Android 9.0) или более поздней версии, вам необходимо добавить в элемент <application> в файле AndroidManifest.xml следующую декларацию:

  <uses-library
      android:name="org.apache.http.legacy"
      android:required="false" />

Если вы используете com.google.android.gms:play-services-maps:16.1.0, это делать не нужно. То же самое, если ваше приложение обращается к более низкому уровню API.