Mengonfigurasi project Konsol Google Cloud

Untuk menyiapkan dan mengonfigurasi project Google Cloud Console guna menggunakan Driver SDK untuk Android, ikuti langkah-langkah berikut.

  1. Siapkan project aplikasi seluler.
  2. Tambahkan Driver SDK ke aplikasi Anda.
  3. Tambahkan kunci API ke aplikasi Anda.
  4. Sertakan atribusi yang diperlukan dalam aplikasi.

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 Anda, ikuti langkah-langkah berikut:

  1. Jika Anda tidak memiliki project pengembangan Konsol Google Cloud dan kunci API untuk proyek mobilitas Anda, Anda perlu menyiapkannya. Untuk mengetahui informasi selengkapnya, lihat Membuat project Fleet Engine.
  2. Di Konsol Google Cloud, pilih project Konsol Google Cloud yang sama dan Kunci API yang Anda gunakan untuk Fleet Engine.
  3. 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 Anda, tambahkan Driver SDK dan Navigation SDK dependensi ke konfigurasi Gradle atau Maven Anda.

Dalam contoh berikut, ganti VERSION_NUMBER dengan versi yang dipilih Driver SDK.

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 Anda, tambahkan kunci API. Anda harus menggunakan kunci API project yang diperoleh saat menyiapkan project pengembangan. Sebagai detail selengkapnya, lihat Menyiapkan project aplikasi seluler Anda.

Bagian ini menjelaskan cara menyimpan kunci API sehingga dapat lebih aman yang direferensikan 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:

  1. Buka file build.gradle tingkat root dan tambahkan kode berikut ke Elemen dependencies pada 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. Buka file build.gradle tingkat aplikasi dan tambahkan kode berikut ke elemen plugins.

    Groovy

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

    Kotlin

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

  3. Jika Anda menggunakan Android Studio, sinkronkan project Anda dengan Gradle. Untuk mengetahui detailnya, lihat Menyinkronkan project dengan Gradle.

  4. Buka local.properties di direktori tingkat project, lalu tambahkan kode berikut. Ganti YOUR_API_KEY dengan kunci API Anda.

    MAPS_API_KEY=YOUR_API_KEY

  5. Dalam file AndroidManifest.xml, buka com.google.android.geo.API_KEY dan perbarui atribut android: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 Anda menyertakan atribusi sebagai item menu independen atau sebagai bagian dari Tentang item menu.

Anda dapat menemukan informasi lisensi di "third_party_licenses.txt" file di file AAR yang tidak diarsipkan.

Lihat Menyertakan pemberitahuan open source tentang cara termasuk pemberitahuan {i>open source<i}.

Langkah berikutnya

Mendeklarasikan dependensi