Настройка проекта консоли 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. Репозиторий содержит файлы объектной модели проекта (.pom) и документацию Javadoc для SDK.

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

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

Грэдл

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

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

Мэйвен

Добавьте следующее в ваш 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 см. в статье Google Maps Platform о лучших практиках обеспечения безопасности API .

Для упрощения этой задачи вы можете воспользоваться документацией GitHub по плагину Secrets Gradle для 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» .

  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-архиве.

Инструкции по включению уведомлений об открытом исходном коде см. в разделе «Включение уведомлений об открытом исходном коде».

Что дальше?

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