Menggunakan Kunci API

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.
Pilih platform: Android iOS JavaScript Layanan Web

Sebelum memulai

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

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 > Kredensial.

    Buka halaman Kredensial

  2. Pada halaman Kredensial, klik Buat kredensial > kunci API.
    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 mendapatkan informasi selengkapnya tentang sertifikat digital, lihat panduan Menandatangani aplikasi .

Untuk informasi tentang cara mendapatkan sidik jari sertifikat, lihat halaman Mengautentikasi Klien Anda. Jika Anda menggunakan Penandatanganan Aplikasi Play, Anda harus membuka halaman penandatanganan aplikasi di Konsol Play untuk mendapatkan sidik jari sertifikat.

Cara membatasi kunci API:

Konsol

  1. Buka halaman Google Maps Platform > Kredensial.

    Buka halaman Credentials

  2. Pilih kunci API yang ingin Anda batasi. Halaman properti kunci API akan muncul.
  3. Di bagian Pembatasan kunci, 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 Batasi kunci.
      2. Pilih Places API dari menu drop-down Pilih API. Jika Places API tidak tercantum, Anda harus mengaktifkannya.
  4. Untuk menyelesaikan perubahan, klik Simpan.

Cloud SDK

Cantumkan kunci yang ada. 

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

Hapus pembatasan yang ada 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:

Menemukan informasi sertifikat aplikasi

Kunci API didasarkan pada bentuk singkat sertifikat digital aplikasi Anda, yang dikenal sebagai sidik jari SHA-1. Agar dapat menampilkan sidik jari SHA-1 untuk sertifikat Anda, pastikan terlebih dahulu bahwa Anda menggunakan sertifikat yang tepat. Anda mungkin memiliki dua sertifikat:

  • Sertifikat debug: Android SDK Tools membuat sertifikat ini secara otomatis saat Anda membuat build debug. Hanya gunakan sertifikat ini bersama aplikasi yang sedang Anda uji. Jangan mencoba memublikasikan aplikasi yang ditandatangani dengan sertifikat debug. Sertifikat debug dijelaskan secara lebih mendetail dalam Penandatanganan dalam Mode Debug dalam Dokumentasi Developer Android.
  • Sertifikat rilis: Android SDK Tools membuat sertifikat ini saat Anda membuat build rilis. Anda juga dapat membuat sertifikat ini menggunakan program keytool. Gunakan sertifikat ini jika Anda siap merilis aplikasi Anda ke publik.

Menggunakan Gradle

Gradle sangat memudahkan untuk mendapatkan info penandatanganan aplikasi Anda. Cukup jalankan ./gradlew signingReport.

Output akan terlihat seperti ini:

Task :app:signingReport

Variant: debug
Config: debug
Store: ~/.android/debug.keystore
Alias: AndroidDebugKey
MD5: 76:4E:BF:C3:59:DA:D3:8F:98:D6:3C:DB:87:A4:5B:E7
SHA1: 99:8E:73:B8:3A:A3:A3:C4:C1:D4:19:08:F6:7E:9E:F6:75:29:4C:B2
SHA-256: 6C:01:12:53:90:94:73:B5:66:D6:07:FF:A5:6F:AB:30:AE:99:20:55:0F:B3:12:22:4C:46:7E:02:3D:7E:6D:1D
Valid until: Friday, June 25, 2049
----------
Variant: release
Config: release
Store: app/keystore.jks
Alias: keystore
MD5: 1E:63:0F:14:67:E0:04:BD:98:4C:EB:2B:09:EF:7E:1E
SHA1: 2C:DF:9F:D1:A3:0D:1E:01:48:34:5D:91:52:0B:D8:8A:5A:07:45:C3
SHA-256: 12:66:CE:4B:90:FD:64:1A:4D:79:9E:78:AD:59:0C:21:D8:53:61:EE:2B:90:E4:67:CE:65:A0:76:04:13:23:89
Valid until: Tuesday, September 29, 2116

Secara manual

Ikuti langkah-langkah di bawah untuk menampilkan sidik jari SHA-1 sertifikat menggunakan program keytool dengan parameter -v. Untuk mendapatkan informasi lebih lanjut tentang Keytool, lihat dokumentasi Oracle.

Sertifikat debug

Menampilkan sidik jari sertifikat debug

  1. Temukan file keystore debug Anda. Nama file-nya adalah debug.keystore, dan dibuat saat pertama kali Anda membuat project. Secara default, file ini disimpan dalam direktori yang sama seperti file Android Virtual Device (AVD) Anda:

    • macOS dan Linux: ~/.android/
    • Windows Vista dan Windows 7: C:\Users\your_user_name\.android\

  2. Tampilkan daftar sidik jari SHA-1:

    • Untuk Linux atau macOS, buka jendela terminal dan masukkan berikut:

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

    • Untuk Windows Vista dan Windows 7, jalankan:

      keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Anda akan melihat output yang serupa dengan ini:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3

Sertifikat rilis

Menampilkan sidik jari sertifikat rilis

  1. Temukan file keystore sertifikat rilis Anda. Tidak ada lokasi atau nama default untuk keystore rilis. Jika Anda tidak menetapkannya saat membuat aplikasi untuk rilis, build akan membiarkan .apk tidak ditandatangani, dan Anda harus menandatanganinya sebelum dapat memublikasikannya. Untuk sertifikat rilis, Anda juga memerlukan sandi dan alias sertifikat untuk keystore dan sertifikatnya. Anda dapat menampilkan daftar alias untuk semua kunci dalam keystore dengan memasukkan:

    keytool -list -keystore your_keystore_name

    Ganti your_keystore_name dengan jalur dan nama keystore yang sepenuhnya memenuhi syarat, termasuk ekstensi .keystore. Anda akan diminta memasukkan sandi keystore. Selanjutnya, keytool menampilkan semua alias dalam keystore.

  2. Masukkan hal berikut pada terminal atau command prompt:

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    Ganti your_keystore_name dengan jalur dan nama keystore yang sepenuhnya memenuhi syarat, termasuk ekstensi .keystore. Ganti your_alias_name dengan alias yang ditetapkan ke sertifikat saat Anda membuatnya.

Anda akan melihat output yang serupa dengan ini:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

Baris yang diawali dengan SHA1 berisi sidik jari SHA-1 sertifikat. Sidik jari adalah rangkaian 20 angka heksadesimal dua digit yang dipisahkan dengan titik dua.

Langkah berikutnya

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