Untuk menyiapkan dan mengonfigurasi project Google Cloud Console guna menggunakan Driver SDK untuk Android, ikuti langkah-langkah berikut.
- Siapkan project aplikasi seluler.
- Tambahkan Driver SDK ke aplikasi Anda.
- Tambahkan kunci API ke aplikasi Anda.
- Sertakan atribusi yang diperlukan di aplikasi Anda.
Untuk mengetahui detail selengkapnya tentang setiap langkah, lihat bagian berikut.
Menyiapkan project aplikasi seluler
Bagian ini menjelaskan cara mengonfigurasi project aplikasi seluler Anda untuk Driver SDK.
Untuk mengonfigurasi project aplikasi seluler, ikuti langkah-langkah berikut:
- Jika tidak memiliki project pengembangan Konsol Google Cloud dan kunci API untuk project mobilitas, Anda harus menyiapkannya. Untuk mengetahui informasi selengkapnya, lihat Membuat project Fleet Engine.
- Di Konsol Google Cloud, pilih project Konsol Google Cloud dan kunci API yang sama dengan yang Anda gunakan untuk Fleet Engine.
- Pilih APIs & Services, lalu telusuri dan aktifkan Maps SDK for Android.
Menambahkan Driver SDK ke aplikasi
Driver SDK tersedia dari repositori Maven Google. Repositori menyertakan file Project Object Model (.pom) dan Javadoc SDK.
Untuk menambahkan Driver SDK ke aplikasi, tambahkan dependensi Driver SDK dan Navigation SDK ke konfigurasi Gradle atau Maven Anda.
Pada contoh berikut, ganti VERSION_NUMBER
dengan versi Driver SDK
yang dipilih.
Gradle
Tambahkan kode berikut ke build.gradle
Anda:
dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-driver:VERSION_NUMBER'
implementation 'com.google.android.libraries.navigation:navigation:5.0.0'
}
Maven
Tambahkan kode berikut ke pom.xml
Anda:
<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>
Menambahkan kunci API ke aplikasi
Setelah menambahkan Driver SDK ke aplikasi, tambahkan kunci API. Anda harus menggunakan kunci API project yang diperoleh saat menyiapkan project pengembangan. Untuk mengetahui detail selengkapnya, lihat Menyiapkan project aplikasi seluler.
Bagian ini menjelaskan cara menyimpan kunci API sehingga dapat dirujuk dengan lebih aman oleh aplikasi Anda. Untuk informasi selengkapnya tentang praktik terbaik keamanan kunci API, lihat artikel Google Maps Platform tentang Praktik terbaik keamanan API.
Untuk menyederhanakan tugas ini, Anda dapat menggunakan dokumentasi GitHub Plugin Secrets Gradle untuk Android.
Untuk menginstal plugin dan menyimpan kunci API Anda, ikuti langkah-langkah berikut:
Buka file
build.gradle
tingkat root dan tambahkan kode berikut ke elemendependencies
di bagianbuildscript
.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") } }
Buka file
build.gradle
tingkat aplikasi dan tambahkan kode berikut ke elemenplugins
.Groovy
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
Jika Anda menggunakan Android Studio, sinkronkan project Anda dengan Gradle. Untuk mengetahui detailnya, lihat Menyinkronkan project dengan Gradle.
Buka
local.properties
di direktori tingkat project, lalu tambahkan kode berikut. GantiYOUR_API_KEY
dengan kunci API Anda.MAPS_API_KEY=YOUR_API_KEY
Dalam file
AndroidManifest.xml
, bukacom.google.android.geo.API_KEY
dan perbarui atributandroid:value
sebagai berikut:
<meta-data
android:name="com.google.android.geo.API_KEY"
android:value="${MAPS_API_KEY}" />
Contoh berikut menunjukkan manifes lengkap untuk aplikasi contoh:
<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>
Menyertakan atribusi yang diperlukan di aplikasi Anda
Jika menggunakan Driver SDK di aplikasi, Anda harus menyertakan teks atribusi dan lisensi open source sebagai bagian dari bagian pemberitahuan hukum aplikasi. Sebaiknya sertakan atribusi sebagai item menu tersendiri atau sebagai bagian dari item menu Tentang.
Anda dapat menemukan informasi lisensi di file "third_party_licenses.txt" dalam file AAR yang tidak diarsipkan.
Lihat Menyertakan pemberitahuan open source tentang cara menyertakan pemberitahuan open source.