Menggunakan Kunci API

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 dari kunci penandatanganan yang digunakan untuk menandatangani aplikasi. Ada dua jenis sertifikat:

  • Sertifikat debug: Hanya gunakan jenis sertifikat ini dengan 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 Navigation SDK dari drop-down Select APIs. Jika Navigation SDK tidak tercantum, Anda harus enable.
  4. Untuk menyelesaikan perubahan, klik Save.

Cloud SDK

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="maps-android-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 selanjutnya

Setelah memiliki kunci API, Anda dapat membuat dan mengonfigurasi project Android Studio seperti yang dijelaskan dalam Menyiapkan Project Android Studio.

Menyiapkan project Android Studio