Menggunakan Kunci API

Pilih platform: Android iOS JavaScript Web Service

Sebelum memulai

Sebelum mulai menggunakan Places SDK for Android, Anda harus memiliki project dengan akun penagihan dan mengaktifkan Places SDK for Android. Untuk mempelajari lebih lanjut, lihat Menyiapkan project di Konsol Cloud.

Membuat kunci API

Kunci API adalah ID unik yang mengautentikasi permintaan terkait project untuk tujuan penggunaan dan penagihan. Anda harus memiliki setidaknya satu kunci API terkait project.

Untuk membuat kunci API:

Konsol

  1. Buka halaman Google Maps Platform > Credentials.

    Buka halaman Credentials

  2. Pada halaman Credentials, klik Create credentials > API key.
    Dialog API key created akan menampilkan kunci API yang baru dibuat.
  3. Klik Close.
    Kunci API baru dicantumkan pada halaman Credentials di bawah API keys.
    (Jangan lupa untuk membatasi kunci API sebelum menggunakannya dalam produksi.)

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Baca selengkapnya tentang Google Cloud SDK, Penginstalan Cloud SDK, dan perintah berikut:

Membatasi kunci API

Google sangat menyarankan agar Anda membatasi penggunaan kunci API hanya untuk API yang diperlukan aplikasi Anda. Membatasi kunci API akan meningkatkan keamanan aplikasi Anda dengan melindunginya dari permintaan yang tidak sah. Untuk informasi selengkapnya, lihat Praktik terbaik keamanan API.

Saat membatasi kunci API, Anda harus memberikan sidik jari sertifikat SHA-1 untuk kunci penandatanganan yang digunakan untuk menandatangani aplikasi. Ada dua jenis sertifikat:

  • Sertifikat debug: Hanya gunakan jenis sertifikat ini bersama aplikasi yang sedang Anda uji dan kode non-produksi lainnya. Jangan mencoba memublikasikan aplikasi yang ditandatangani dengan sertifikat debug. Android SDK Tools membuat sertifikat ini secara otomatis saat Anda menjalankan build debug.
  • Sertifikat rilis: Gunakan sertifikat ini jika Anda siap merilis aplikasi ke app store. Android SDK Tools membuat sertifikat ini saat Anda menjalankan build rilis.

Untuk informasi selengkapnya tentang sertifikat dan penandatanganan aplikasi Android, baca panduan Menandatangani aplikasi.

Untuk petunjuk cara menemukan sidik jari sertifikat penandatanganan Anda, lihat referensi di bawah:

Cara membatasi kunci API:

Konsol

  1. Buka halaman Google Maps Platform > Credentials.

    Buka halaman Credentials

  2. Pilih kunci API yang ingin Anda batasi. Halaman properti kunci API akan muncul.
  3. Di bagian Key restrictions, tetapkan pembatasan berikut:
    • Pembatasan aplikasi:
      1. Pilih Android apps.
      2. Klik + Add package name and fingerprint.
      3. Masukkan nama paket dan sidik jari sertifikat SHA-1. Contoh:
        com.example.android.mapexample
        BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    • Pembatasan API:
      1. Klik Restrict key.
      2. Pilih Places API atau Places API (Baru) dari drop-down Pilih API, tetapi jangan keduanya. Jika Places API tidak tercantum, Anda harus enable.
  4. Untuk menyelesaikan perubahan, klik Save.

Cloud SDK

Places SDK for Android (Baru)

Cantumkan kunci yang ada.

gcloud services api-keys list --project="PROJECT"

Hapus pembatasan yang berlaku pada kunci yang ada.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Tetapkan pembatasan baru pada kunci yang ada.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="places.googleapis.com"
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

Baca selengkapnya tentang Google Cloud SDK, Penginstalan Cloud SDK, dan perintah berikut:

Places SDK for Android

Cantumkan kunci yang ada.

gcloud services api-keys list --project="PROJECT"

Hapus pembatasan yang berlaku pada kunci yang ada.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Tetapkan pembatasan baru pada kunci yang ada.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="places-backend.googleapis.com"
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

Baca selengkapnya tentang Google Cloud SDK, Penginstalan Cloud SDK, dan perintah berikut:

Langkah berikutnya

Setelah Anda memiliki kunci API, buat dan konfigurasi project seperti yang dijelaskan dalam artikel Menyiapkan Project Android Studio.