Чтобы настроить проект Google Cloud Console для использования Driver SDK для Android, выполните следующие действия.
- Настройте проект мобильного приложения .
- Добавьте Driver SDK в свое приложение .
- Добавьте ключ API в свое приложение .
- Включите в свое приложение необходимые сведения об авторстве .
Более подробную информацию о каждом шаге см. в следующих разделах.
Настройте проект мобильного приложения
В этом разделе описывается, как настроить проект мобильного приложения для Driver SDK.
Чтобы настроить проект мобильного приложения, выполните следующие действия:
- Если у вас нет проекта разработки Google Cloud Console и ключа API для вашего проекта мобильности, вам необходимо его настроить. Дополнительные сведения см. в разделе Создание проекта Fleet Engine .
- В Google Cloud Console выберите тот же проект Google Cloud Console и ключ API, которые вы используете для Fleet Engine.
- Выберите API и службы , найдите и включите Maps SDK для Android.
Добавьте Driver SDK в свое приложение
Driver SDK доступен в репозитории Google Maven. Репозиторий включает файлы объектной модели проекта SDK (.pom) и документацию Javadocs.
Чтобы добавить 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 о рекомендациях по обеспечению безопасности API .
Чтобы упростить эту задачу, вы можете использовать документацию GitHub Secrets Gradle Plugin for Android .
Чтобы установить плагин и сохранить ключ API, выполните следующие действия:
Откройте файл
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") } }
Откройте файл
build.gradle
уровня приложения и добавьте следующий код в элементplugins
.классный
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Котлин
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
Если вы используете Android Studio, синхронизируйте свой проект с Gradle. Подробности см. в разделе Синхронизация проекта с Gradle .
Откройте
local.properties
в каталоге уровня вашего проекта, а затем добавьте следующий код. ЗаменитеYOUR_API_KEY
своим ключом API.MAPS_API_KEY= YOUR_API_KEY
В файле
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.
О том, как включать уведомления об открытом исходном коде , см. в разделе Включение уведомлений об открытом исходном коде.