Mengonfigurasi project Konsol Google Cloud

Untuk menyiapkan dan mengonfigurasi konsol Google Cloud agar dapat menggunakan Consumer SDK for Android, ikuti langkah-langkah berikut.

1. Menyiapkan project pengembangan.
2. Menambahkan Consumer SDK ke aplikasi Anda.
3. Menambahkan kunci API ke aplikasi Anda.
4. Menyertakan atribusi yang diperlukan di aplikasi Anda.

Untuk mengetahui detail selengkapnya tentang setiap langkah, lihat bagian berikut.

Menyiapkan project pengembangan

Jika Anda tidak memiliki project pengembangan konsol Google Cloud dan kunci API untuk project mobilitas, Anda harus menyiapkannya. Untuk mengetahui detailnya, lihat Membuat project di panduan Fleet Engine.

Saat memilih project pengembangan untuk Consumer SDK, pilih project konsol Google Cloud dan kunci API yang sama dengan yang Anda gunakan untuk Fleet Engine.

Menambahkan Consumer SDK ke aplikasi Anda

Consumer SDK tersedia dari repositori Maven Google. Repositori ini mencakup file Project Object Model (.pom) dan Javadocs SDK. Untuk menambahkan Consumer SDK ke aplikasi Anda, tambahkan dependensi Consumer SDK dan Maps SDK ke konfigurasi Gradle atau Maven.

Dalam contoh berikut, ganti VERSION_NUMBER dengan versi Consumer SDK yang diperlukan:

dependencies {
  ...
  implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
  implementation "com.google.android.gms:play-services-maps:18.1.0"
}

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
    <artifactId>transportation-consumer</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.gms</groupId>
    <artifactId>play-services-maps</artifactId>
    <version>18.1.0</version>
  </dependency>
</dependencies>

Menambahkan kunci API ke aplikasi Anda

Setelah menambahkan Consumer SDK ke aplikasi Anda, tambahkan kunci API. Anda harus menggunakan kunci API project yang Anda peroleh saat menyiapkan project pengembangan. Untuk mengetahui detail selengkapnya, lihat Menyiapkan project pengembangan di Langkah 3 panduan ini.

Bagian ini menjelaskan cara menyimpan kunci API sehingga dapat dirujuk dengan lebih aman oleh aplikasi Anda. Untuk mengetahui 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:

1. Buka file build.gradle tingkat root dan tambahkan kode berikut ke elemen dependencies di bagian 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 Anda dengan Gradle di dokumentasi Android.

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. Di 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.consumerapidemo">
        <uses-permission android:name="android.permission.ACCESS_FINE_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 Anda menggunakan Consumer SDK di aplikasi Anda, Anda harus menyertakan teks atribusi dan lisensi open source sebagai bagian dari bagian pemberitahuan hukum aplikasi Anda. Sebaiknya sertakan atribusi sebagai item menu terpisah atau sebagai bagian dari item menu Tentang.

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

Lihat https://developers.google.com/android/guides/opensource tentang cara menyertakan pemberitahuan open source.

Langkah berikutnya

Mendapatkan token autentikasi