Как настроить существующий проект Android Studio

В этой статье рассказывается, как настроить проект Android Studio для использования Maps SDK for Android, не применяя шаблон Google Карт, описанный в кратком руководстве.

Этот шаблон автоматически задает конфигурацию для проекта и добавляет базовую карту. Однако вы также можете добавить карту в проект Android, где используется другой шаблон Android Studio. Для этого необходимо вручную изменить настройки проекта, а затем добавить карту.

Настройте Android Studio

  1. Вам обязательно потребуется Android Studio. Если у вас нет этого инструмента, скачайте и установите его.

  2. Добавьте в Android Studio SDK сервисов Google Play. Maps SDK для Android является частью SDK сервисов Google Play, доступного в SDK Manager.

Настройте проект Google Cloud и ключ API

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

Обновите манифест приложения

В этом разделе описаны настройки, которые необходимо добавить в файл AndroidManifest.xml.


Версия сервисов Google Play

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

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

Разрешение для определения местоположения

Если приложению требуется доступ к данным о местоположении пользователя, вы должны запросить разрешение в файле AndroidManifest.xml. Доступны следующие варианты: ACCESS_FINE_LOCATION (точное местоположение) и ACCESS_COARSE_LOCATION (менее точное). Дополнительную информацию вы можете найти в этом руководстве.

Чтобы запросить разрешение ACCESS_FINE_LOCATION, добавьте в элемент manifest следующий код:

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

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

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

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

Библиотека 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" />

Добавьте Карты в качестве зависимости

В файле build.gradle на уровне приложения добавьте Карты в качестве зависимости. Дополнительная информация доступна в руководстве по управлению версиями.

dependencies {
    implementation 'com.google.android.gms:play-services-maps:17.0.1'
    // ...
}

Дальнейшие действия

Завершив настройку проекта, вы сможете добавить карту в свое приложение.