Настройка проекта консоли Google Cloud

Чтобы настроить и конфигурировать консоль Google Cloud для использования Consumer SDK для Android, выполните следующие действия.

1. Создайте свой проект по разработке .
2. Добавьте Consumer SDK в свое приложение .
3. Добавьте ключ API к вашему приложению .
4. Включите требуемые атрибуции в свое приложение .

Более подробную информацию о каждом этапе смотрите в следующих разделах.

Примечание: Ваше приложение должно быть ориентировано на minSdkVersion 23 или выше.

Настройте свой проект развития

Если у вас нет проекта разработки Google Cloud Console и ключа API для вашего мобильного проекта, вам необходимо их создать. Подробнее см. в разделе «Создание проекта» руководства Fleet Engine.

При выборе проекта разработки для Consumer SDK выберите тот же проект консоли Google Cloud и ключ API, которые вы используете для Fleet Engine.

Добавьте Consumer SDK в свое приложение

Consumer SDK доступен в репозитории Google Maven. Репозиторий содержит файлы Project Object Model (.pom) и документацию Javadocs. Чтобы добавить Consumer SDK в своё приложение, добавьте зависимости Consumer SDK и Maps SDK в конфигурацию Gradle или Maven.

Примечание: Consumer SDK зависит от Maps SDK. Установите зависимость от явно указанной версии Maps SDK, как показано в этом примере. В противном случае Consumer SDK будет использовать минимально необходимую версию Maps SDK, что может вызвать проблемы, если ваше приложение использует функции, доступные в более поздних версиях Maps SDK.

В следующих примерах замените VERSION_NUMBER на требуемую версию Consumer SDK:

Грейдл

Добавьте следующее в ваш build.gradle :

dependencies {
  ...
  implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
  implementation "com.google.android.gms:play-services-maps:18.1.0"
}

Maven

Добавьте в pom.xml следующее:

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
    <artifactId>transportation-consumer</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.gms</groupId>
    <artifactId>play-services-maps</artifactId>
    <version>18.1.0</version>
  </dependency>
</dependencies>

Добавьте ключ API в свое приложение

После добавления Consumer SDK в приложение добавьте ключ API. Необходимо использовать ключ API проекта, полученный при настройке проекта разработки. Подробнее см. в разделе «Настройка проекта разработки» на шаге 3 настоящего руководства.

В этом разделе описывается, как хранить ключ API, чтобы приложение могло использовать его более безопасно. Подробнее о рекомендациях по безопасности ключей API см. в статье платформы Google Карт о рекомендациях по безопасности API .

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

Чтобы упростить эту задачу, вы можете воспользоваться документацией GitHub Secrets Gradle Plugin for Android .

Чтобы установить плагин и сохранить свой ключ API:

1. Откройте файл build.gradle корневого уровня и добавьте следующий код в элемент dependencies в buildscript .

   Круто

   buildscript {
         dependencies {
             // ...
             classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0"
         }
   }
   

   Котлин

   buildscript {
       dependencies {
           // ...
           classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0")
       }
   }
   

2. Откройте файл build.gradle уровня приложения и добавьте следующий код в элемент plugins .

   Круто

   id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
   

   Котлин

   id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
   

3. Если вы используете Android Studio, синхронизируйте свой проект с Gradle. Подробнее см. в разделе «Синхронизация проекта с Gradle» в документации Android.

4. Откройте файл local.properties в каталоге вашего проекта и добавьте следующий код. Замените YOUR_API_KEY на ваш ключ API.

   MAPS_API_KEY= YOUR_API_KEY

5. В файле AndroidManifest.xml перейдите к com.google.android.geo.API_KEY и обновите атрибут android:value следующим образом:

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

В следующем примере показан полный манифест для образца приложения:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.consumerapidemo">
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <application
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:supportsRtl="true"
            android:theme="@style/_AppTheme">

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

            <activity android:name=".MainActivity">
                <intent-filter>
                    <action android:name="android.intent.action.MAIN" />
                    <category android:name="android.intent.category.LAUNCHER" />
                </intent-filter>
            </activity>
        </application>
    </manifest>

Включите необходимые атрибуции в свое приложение

Если вы используете Consumer SDK в своём приложении, необходимо включить текст атрибуции и лицензии с открытым исходным кодом в раздел «Юридические уведомления» вашего приложения. Рекомендуется включить атрибуцию в отдельный пункт меню или в пункт меню «О приложении» .

Информацию о лицензии вы можете найти в файле «third_party_licenses.txt» в распакованном файле AAR.

Информацию о том, как включить уведомления об открытом исходном коде, см. на сайте https://developers.google.com/android/guides/opensource .

Что дальше?

Получить токены аутентификации