Places API: Mendapatkan Kunci API

Catatan: Premium Plan Google Maps Platform tidak lagi tersedia untuk pendaftar atau pelanggan baru.

Untuk menggunakan Places API, Anda harus memiliki kunci API. Kunci API adalah ID unik yang digunakan untuk mengautentikasi permintaan terkait project untuk tujuan penggunaan dan penagihan.

Dengan menggunakan kunci API untuk mengautentikasi permintaan, Anda dapat:

Dapatkan informasi selengkapnya tentang laporan yang tersedia untuk pelanggan Premium Plan.

Membuat kunci API

Anda harus memiliki setidaknya satu kunci API terkait project.

Cara mendapatkan kunci API:

  1. Buka Google Cloud Platform Console.
  2. Klik drop-down project, lalu pilih project yang dibuat untuk Anda saat membeli Premium Plan. Nama project diawali dengan Google Maps API for Business atau Google Maps for Work atau Google Maps.

    3. Catatan: Untuk mendapatkan akses penuh ke fitur yang terdapat dalam paketnya, pelanggan Premium harus menggunakan project yang terkait dengan akun Premium mereka. Saat membeli lisensi, Anda menerima nama aset Premium Anda dalam format berikut: gme-[company] & proj-[number] ([type]). Untuk memastikan Anda mengakses project yang benar, login ke konsol sebagai pemilik project menggunakan console.cloud.google.com/project/number (ganti number dengan nomor project Anda). Anda dapat menemukan pemilik project di email selamat datang.

  3. Klik tombol menu lalu pilih API & Layanan > Kredensial.
  4. Pada halaman Kredensial, klik Buat kredensial > Kunci API.
    Dialog kunci API dibuat menampilkan kunci API yang baru dibuat (string yang dienkripsi).
  5. Klik Tutup.
    Kunci API baru dicantumkan pada halaman Kredensial di bagian Kunci API.

Menambahkan kunci API ke permintaan

Anda harus menyertakan kunci API dengan setiap permintaan Places API. Pada contoh berikut, ganti YOUR_API_KEY dengan kunci API Anda. 

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?location=-33.8670522,151.1957362
  &radius=500
  &types=food
  &name=harbour
  &key=YOUR_API_KEY

Membatasi kunci API

Membatasi Kunci API akan menambah keamanan ke aplikasi Anda dengan memastikan hanya permintaan sah yang dibuat dengan Kunci API Anda. Sebaiknya Anda mengikuti petunjuk untuk menetapkan pembatasan pada Kunci API Anda. Untuk mengetahui informasi selengkapnya, lihat Praktik Terbaik Kunci API.

Cara membatasi kunci API:

  1. Di GCP Console, pada halaman pemilih project, pilih atau buat project Google Cloud yang ingin Anda tambahkan kunci API.

    Buka halaman pemilih project

  2. Buka halaman API & Layanan > Kredensial.

    Buka halaman Kredensial

  3. Pilih kunci API yang ingin Anda tetapkan pembatasannya. Halaman properti kunci API akan muncul.
  4. Di bagian Pembatasan kunci, tetapkan pembatasan berikut:
    • Pembatasan aplikasi:
      1. Untuk menerima permintaan dari daftar alamat IP server web yang Anda berikan, pilih alamat IP (server web, cron job, dsb.) dari daftar Pembatasan aplikasi.
      2. Tentukan satu alamat IPv4 atau IPv6, atau subnet menggunakan notasi CIDR (misalnya, 192.168.0.0/22). Jika Anda perlu memasukkan entri lain, kotak baru akan muncul setelah Anda selesai menambahkan entri sebelumnya.
    • Pembatasan API:
      1. Klik Batasi kunci.
      2. Pilih Places API dari menu drop-down Pilih API.
        (Jika Places API tidak tercantum, Anda harus mengaktifkannya.)
  5. Untuk menyelesaikan perubahan, klik Simpan.

Memecahkan masalah autentikasi

Jika permintaan Anda salah format atau memberikan tanda tangan yang tidak valid, Places API akan menampilkan error HTTP 403 (Forbidden).

Untuk memecahkan setiap masalah URL, Anda dapat menggunakan Debugger Penandatanganan URL. Alat bantu ini memungkinkan Anda memvalidasi URL dan tanda tangan yang dihasilkan oleh aplikasi Anda.

Atau, pelanggan Premium Plan dapat memecahkan masalah setiap URL dengan login ke Portal Dukungan Google Cloud lalu memilih Resources > Alat online Premium Plan Google Maps Platform > Debugger Penandatanganan URL untuk Web Service dan Image API.