Mengonfigurasi project Konsol Google Cloud

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

  1. Menyiapkan project pengembangan.
  2. Tambahkan Consumer SDK ke aplikasi Anda.
  3. Tambahkan kunci API ke aplikasi Anda.
  4. Sertakan atribusi yang diperlukan dalam aplikasi.

Untuk detail selengkapnya tentang setiap langkah, lihat bagian berikut.

Menyiapkan project pengembangan

Jika Anda tidak memiliki project pengembangan Konsol Google Cloud dan kunci API untuk proyek mobilitas Anda, Anda perlu menyiapkannya. Untuk mengetahui detailnya, lihat Buat project Anda 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 pribadi. Repositori mencakup file Project Object Model (.pom) SDK dan Javadocs. Untuk menambahkan SDK Konsumen ke aplikasi Anda, ikuti langkah-langkah berikut:

  1. Siapkan lingkungan Anda untuk mengakses repositori Maven host seperti yang dijelaskan di Langkah 2 dalam panduan ini.

  2. Menambahkan dependensi Consumer SDK dan Maps SDK ke Gradle atau Maven Anda konfigurasi Anda.

    Pada contoh berikut, ganti VERSION_NUMBER dengan atribut versi Consumer SDK:

    Gradle

    Tambahkan kode berikut ke build.gradle Anda:

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

    Maven

    Tambahkan kode berikut ke pom.xml Anda:

    <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

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

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 Secrets Gradle Plugin 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 bawah 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 Sinkronkan project Anda dengan Gradle dalam 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 Anda, buka com.google.android.geo.API_KEY dan update 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 dalam aplikasi

Jika Anda menggunakan SDK Konsumen di aplikasi, Anda harus menyertakan teks atribusi dan lisensi open source sebagai bagian dari bagian pemberitahuan hukum aplikasi Anda. 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 https://developers.google.com/android/guides/opensource untuk mengetahui cara termasuk pemberitahuan {i>open source<i}.

Langkah berikutnya

Mendapatkan token autentikasi