Настройка

На этой странице описано, что необходимо сделать для начала работы с SDK Maps 3D для Android. Процесс настройки включает в себя конфигурацию проекта Google Cloud и API для использования с SDK, а затем настройку проекта Android Studio. Выполните эти шаги, прежде чем добавлять свою первую 3D-карту в приложение .

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

Прежде чем начать разработку с использованием Maps 3D SDK для Android, необходимо настроить проект Google Cloud и ключ API для работы с Maps 3D SDK для Android, выполнив следующие шаги:

gcloud projects create "PROJECT"

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Чтобы включить SDK, перейдите на страницу Maps 3D SDK для Android в консоли Google Cloud. Дополнительную информацию о выполнении этих шагов см. в разделе «Начало работы с платформой Google Maps» .

Создайте проект в Android Studio.

В этом разделе объясняется, как создать и настроить проект Android Studio для использования с Maps 3D SDK для Android.

Часть 1: Настройка проекта и конфигурации Gradle

1. Создайте новый проект Android Studio, используя шаблон Empty Views Activity .

2. Если вы используете Git для контроля версий, измените файл .gitignore проекта, чтобы предотвратить добавление файла с секретами в систему контроля версий:

   • В корневом каталоге вашего проекта откройте файл .gitignore .
   • Добавьте следующую строку:

   secrets.properties
   

3. Обновите файл build.gradle.kts на уровне проекта:

   • В корневом каталоге вашего проекта откройте файл build.gradle.kts .
   • В блоке plugins добавьте плагин Secrets Gradle:

   plugins {
     alias(libs.plugins.android.application) apply false
     alias(libs.plugins.kotlin.android) apply false
     alias(libs.plugins.secrets.gradle.plugin) apply false // Add this line
   }
   

4. Обновите файл gradle/libs.versions.toml :

   • Откройте файл gradle/libs.versions.toml , который обычно находится в каталоге gradle внутри корневого каталога проекта.
   • В разделе versions укажите версии SDK и плагина Secrets Gradle:

   maps3dSdk = "0.0.1" # Update this value to match the SDK version to include
   secretsGradlePlugin = "2.0.1"
   

   • В разделе «Библиотека» добавьте библиотеку SDK:

   play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }
   

   • В разделе плагинов добавьте плагин Secrets Gradle:

   secrets-gradle-plugin = { id = "com.google.android.libraries.mapsplatform.secrets-gradle-plugin", version.ref = "secretsGradlePlugin" }
   

5. Обновите файл app/build.gradle.kts на уровне модуля:

   • Откройте файл build.gradle.kts , расположенный на уровне модуля, который обычно находится в каталоге app .
   • В верхней части файла добавьте плагин Secrets Gradle в блок plugins :

   plugins {
       alias(libs.plugins.android.application)
       alias(libs.plugins.kotlin.android)
       alias(libs.plugins.secrets.gradle.plugin) // Add this line
   }
   

   • В блоке dependencies добавьте SDK:

   dependencies {
       // ... other dependencies
       implementation(libs.play.services.maps3d) // Add this line
   }
   

   • В конце файла, вне блоков android и dependencies , добавьте конфигурацию secrets:

   secrets {
       // Optionally specify a different filename containing your secrets.
       // The plugin defaults to "local.properties"
       propertiesFileName = "secrets.properties"
   
       // A properties file containing default secret values. This file can be
       // checked in version control.
       defaultPropertiesFileName = "local.defaults.properties"
   }
   

Часть 2: Добавьте свой API-ключ в свой проект.

1. Создайте файл secrets.properties :

   • В корневом каталоге модуля приложения (обычно это каталог app ) создайте новый файл с именем secrets.properties .
   • Добавьте свой API-ключ в файл:

   MAPS3D_API_KEY=YOUR_API_KEY_HERE
   

2. Создайте файл local.defaults.properties : - В корневом каталоге модуля приложения создайте новый файл с именем secrets.properties . - Добавьте в файл ключ API по умолчанию или в качестве заполнителя. Этот файл можно добавить в систему контроля версий:

   MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER
   

Часть 3: Обновите файл AndroidManifest.xml

1. Откройте файл app/src/main/AndroidManifest.xml .

2. Внутри тега <application> , перед тегом <activity> , добавьте следующий элемент <meta-data> , чтобы объявить свой API-ключ:

   <application
       ...>
   
       <meta-data
           android:name="com.google.android.geo.maps3d.API_KEY"
           android:value="${MAPS3D_API_KEY}" />
   
       <activity
           ...>
       </activity>
   </application>
   

   В процессе сборки плагин Secrets Gradle заменит заполнитель ${MAPS3D_API_KEY} ключом из вашего файла secrets.properties .

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

Теперь, когда у вас есть проект Google Cloud, ключ API и настроенный проект Android Studio для использования с Maps 3D SDK для Android, вы можете добавить 3D-карту в свое приложение .