Настройка проекта Android Studio

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

Шаг 1. Настройте Android Studio

  1. Требуется Android Studio Arctic Fox или более поздней версии. Если вы еще этого не сделали, скачайте и установите его.
  2. Убедитесь, что вы используете подключаемый модуль Android Gradle версии 7.0 или более поздней версии в Android Studio.

Шаг 2. Настройте SDK

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

  1. В файле settings.gradle верхнего уровня включите портал плагинов Gradle , репозиторий Google Maven и центральный репозиторий Maven в блоке pluginManagement . Блок pluginManagement должен стоять перед любыми другими операторами в скрипте.
    pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
  2. В файле settings.gradle верхнего уровня включите репозиторий Google Maven и центральный репозиторий Maven в блоке dependencyResolutionManagement :
    dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

  3. В разделе dependencies файла build.gradle на уровне модуля добавьте зависимость к Places SDK для Android:

    dependencies {
    implementation 'com.google.android.libraries.places:places:3.1.0'
}
  4. В файле build.gradle уровня модуля установите для compileSdk и minSdk следующие значения:
    android {
    compileSdk 31

    defaultConfig {
        minSdk 21
        // ...
    }

Шаг 3: Добавьте свой ключ API в проект

В этом разделе описывается, как сохранить ваш ключ API, чтобы ваше приложение могло безопасно ссылаться на него. Вы не должны проверять свой ключ API в своей системе контроля версий, поэтому мы рекомендуем хранить его в файле local.properties , который находится в корневом каталоге вашего проекта. Дополнительные сведения о файле local.properties см. в разделе Файлы свойств Gradle .

Чтобы упростить эту задачу, мы рекомендуем вам использовать плагин Secrets Gradle для Android . Чтобы установить плагин и сохранить ключ API:

  1. В Android Studio откройте файл build.gradle уровня проекта и добавьте следующий код в элемент dependencies в buildscript .
    plugins {
    // ...
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false
}
  2. Затем откройте файл build.gradle уровня модуля и добавьте следующий код в элемент plugins . 
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
  3. Сохраните файл и синхронизируйте проект с Gradle .
  4. Откройте файл local.properties в каталоге уровня вашего проекта и добавьте следующий код. Замените YOUR_API_KEY своим ключом API. 
    MAPS_API_KEY=YOUR_API_KEY
  5. Сохраните файл.
  6. В файле AndroidManifest.xml перейдите на com.google.android.geo.API_KEY и обновите android:value attribute следующим образом: 
    <meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="${MAPS_API_KEY}" />

Примечание. Как показано выше, com.google.android.geo.API_KEY — рекомендуемое имя метаданных для ключа API. Ключ с таким именем можно использовать для аутентификации в нескольких API на основе Google Maps на платформе Android, включая Places SDK для Android. Для обратной совместимости API также поддерживает имя com.google.android.maps.v2.API_KEY . Это устаревшее имя позволяет выполнять аутентификацию только в Android Maps API версии 2. Приложение может указать только одно из имен метаданных ключа API. Если указаны оба, API выдает исключение.

Шаг 4. Инициализируйте клиент Places API

Инициализируйте Places SDK для Android в действии или фрагменте, как показано в следующем примере (обратите внимание, что вы передаете ключ API при вызове Places.initialize() ):

Ява


    // Initialize the SDK
    Places.initialize(getApplicationContext(), apiKey);

    // Create a new PlacesClient instance
    PlacesClient placesClient = Places.createClient(this);

Котлин


    // Initialize the SDK
    Places.initialize(applicationContext, apiKey)

    // Create a new PlacesClient instance
    val placesClient = Places.createClient(this)

Теперь вы готовы начать использовать Places SDK для Android!

Шаг 5. Настройте устройство Android

Чтобы запустить приложение, использующее Places SDK для Android, необходимо развернуть его на устройстве Android или в эмуляторе Android на базе Android 4.0 или более поздней версии, включающем API Google.

  • Чтобы использовать устройство Android, следуйте инструкциям в разделе Запуск приложений на аппаратном устройстве .
  • Чтобы использовать эмулятор Android, вы можете создать виртуальное устройство и установить эмулятор с помощью диспетчера виртуальных устройств Android (AVD) , который входит в состав Android Studio.

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

После настройки проекта вы можете изучить примеры приложений .