Как настроить проект в консоли Google Cloud

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

  1. Настройте проект мобильного приложения.
  2. Добавьте Driver SDK в приложение.
  3. Добавьте в приложение ключ API.
  4. Добавьте в приложение обязательную атрибуцию.

Подробные инструкции для каждого шага приведены в разделах ниже.

Как настроить проект мобильного приложения

В этом разделе описывается, как настроить проект мобильного приложения для Driver SDK.

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

  1. Если у вас нет проекта разработки в консоли Google Cloud и ключа API для проекта мобильности, их нужно создать. Подробнее о том, как создать проект Fleet Engine…
  2. В консоли Google Cloud выберите тот же проект и ключ API, которые вы используете для Fleet Engine.
  3. Выберите API и сервисы, найдите и включите Maps SDK для Android.

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

Driver SDK доступен в репозитории Google Maven. В хранилище содержатся файлы Project Object Model (.pom) и Javadocs.

Чтобы добавить Driver SDK в приложение, добавьте зависимости Driver SDK и Navigation SDK в конфигурацию Gradle или Maven.

В следующем примере замените VERSION_NUMBER на выбранную версию Driver SDK.

Gradle

Добавьте в файл build.gradle следующий код:

dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-driver:VERSION_NUMBER'
implementation 'com.google.android.libraries.navigation:navigation:5.0.0'
}

Maven

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

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation.driver</groupId>
    <artifactId>transportation-driver</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.libraries.navigation</groupId>
    <artifactId>navigation</artifactId>
    <version>5.0.0</version>
  </dependency>
</dependencies>

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

Добавив Driver SDK в приложение, добавьте ключ API. Используйте ключ API, полученный при настройке проекта. Подробнее о том, как настроить проект мобильного приложения…

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

Чтобы упростить работу, используйте плагин Secrets Gradle для Android.

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

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

    Groovy

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

    Kotlin

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

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

    Groovy

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

    Kotlin

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

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

  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.driverapidemo" >
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <uses-permission android:name="android.permission.ACCESS_COARSE_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>

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

Если вы используете Driver SDK в своем приложении, вы должны включить текст атрибуции и лицензии на ПО с открытым исходным кодом в раздел юридической информации приложения. Рекомендуем вынести эти данные в отдельный пункт меню или включить их в раздел О приложении.

Информацию о лицензии можно найти в файле third_party_licenses.txt в разархивированном файле AAR.

Подробнее о том, как добавить уведомления об использовании ПО с открытым исходным кодом…

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

Объявление зависимостей