Geolocation API: Mendapatkan Kunci API

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

Untuk menggunakan Geolocation API, Anda harus mengautentikasi permintaan menggunakan kunci API. Dengan menggunakan kunci API, Anda dapat:

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

Membuat kunci API

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

Cara mendapatkan 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

    Catatan: Untuk mendapatkan akses penuh ke fitur yang terdapat dalam paket, pelanggan Premium harus menggunakan project yang dikaitkan dengan akun Premium mereka. Saat membeli lisensi, Anda akan 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.

  2. Buka halaman API & Layanan > Kredensial.

    Buka halaman Kredensial

  3. Pada halaman Kredensial, klik Buat kredensial > Kunci API.
    Dialog Kunci API dibuat akan menampilkan kunci API yang baru dibuat.
  4. Klik Tutup.
    Kunci API baru dicantumkan pada halaman Kredensial di bagian Kunci API.
    (Jangan lupa untuk membatasi kunci API sebelum menggunakannya dalam produksi.)

Menambahkan kunci API ke permintaan

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

https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY

Membatasi kunci API

Membatasi Kunci API akan meningkatkan keamanan 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 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 batasi. 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, dll.) dari daftar Pembatasan aplikasi.
      2. Tentukan satu alamat IPv4 maupun 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 Geolocation API dari drop-down Pilih API.
        (Jika Geolocation 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, Geolocation 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 secara cepat.

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