Menyiapkan Geocoding API

Developer Wilayah Ekonomi Eropa (EEA)

Jika alamat penagihan Anda berada di Wilayah Ekonomi Eropa, mulai 8 Juli 2025, Persyaratan Layanan Google Maps Platform EEA akan berlaku untuk penggunaan Layanan oleh Anda. Fungsi bervariasi menurut wilayah. Pelajari lebih lanjut.

Dokumen ini menjelaskan langkah-langkah yang diperlukan untuk mulai menggunakan Geocoding API.

1. Akun dan penagihan Pastikan Anda memenuhi prasyarat.

2. Aktifkan API Aktifkan API di project Google Cloud Anda.

3. Membuat permintaan pertama Anda Konfigurasi kunci API atau OAuth untuk membuat permintaan API yang terautentikasi.

Poin Penting: Panduan penyiapan ini mencakup prosedur untuk mengonfigurasi kunci API dan membuat token OAuth. Pilih prosedur yang berlaku untuk lingkungan deployment Anda.

Produk Google Maps Platform dilindungi dari penggunaan yang tidak sah dengan mewajibkan panggilan API untuk menyertakan salah satu dari kunci API atau token OAuth.

Kunci API Token OAuth

Buat token OAuth

Geocoding API mendukung penggunaan OAuth 2.0 untuk autentikasi. Google mendukung skenario OAuth 2.0 umum seperti skenario untuk server web.

Dokumen ini menjelaskan cara meneruskan token OAuth ke panggilan Geocoding API di lingkungan pengembangan Anda. Untuk mengetahui petunjuk tentang cara menggunakan OAuth di lingkungan produksi, lihat Metode autentikasi di Google.

Catatan:

Meskipun Anda dapat menggunakan Google Maps API secara langsung dengan membuat permintaan API ke server, library klien memberikan penyederhanaan yang secara signifikan mengurangi jumlah kode yang perlu Anda tulis. Google Maps menyediakan library klien untuk banyak bahasa pemrograman, termasuk Go, Java, Node.js, dan Python.

Lihat Library Klien Geocoding API untuk dokumentasi dan contoh.

Tentang OAuth

Ada banyak cara untuk membuat dan mengelola token akses dengan OAuth berdasarkan lingkungan deployment Anda.

Misalnya, sistem OAuth 2.0 Google mendukung interaksi server-ke-server, seperti interaksi antara aplikasi Anda dan layanan Google. Untuk skenario ini, Anda memerlukan akun layanan, yaitu akun milik aplikasi Anda, bukan milik pengguna akhir perorangan. Aplikasi Anda memanggil Google API atas nama akun layanan, sehingga pengguna tidak terlibat secara langsung. Untuk mengetahui informasi selengkapnya tentang metode autentikasi, lihat Metode autentikasi di Google.

Atau, Anda dapat menggunakan Geocoding API sebagai bagian dari aplikasi seluler Android atau iOS. Untuk informasi umum tentang penggunaan OAuth dengan Geocoding API, termasuk informasi tentang pengelolaan token akses untuk lingkungan deployment yang berbeda, lihat Menggunakan OAuth 2.0 untuk Mengakses Google API.

Tentang cakupan OAuth

Untuk menggunakan OAuth dengan Geocoding API, token OAuth harus diberi cakupan yang benar. Geocoding API mendukung cakupan berikut:

• https://www.googleapis.com/auth/maps-platform.geocode — Gunakan dengan semua endpoint Geocoding API.
• https://www.googleapis.com/auth/maps-platform.geocode.address — Hanya digunakan dengan GeocodeAddress untuk geocoding maju.
• https://www.googleapis.com/auth/maps-platform.geocode.location — Hanya digunakan dengan GeocodeLocation untuk geocoding terbalik.
• https://www.googleapis.com/auth/maps-platform.geocode.place — Hanya digunakan dengan GeocodePlace untuk geocoding tempat.

Selain itu, Anda dapat menggunakan cakupan https://www.googleapis.com/auth/cloud-platform umum untuk semua endpoint Geocoding API. Cakupan tersebut berguna selama pengembangan karena merupakan cakupan default yang digunakan saat membuat token menggunakan gcloud.

Contoh: Mencoba panggilan REST API di lingkungan pengembangan lokal Anda

Jika ingin mencoba Geocoding API menggunakan token OAuth, tetapi tidak memiliki penyiapan lingkungan untuk membuat token, Anda dapat menggunakan prosedur di bagian ini untuk melakukan panggilan.

Contoh ini menjelaskan cara menggunakan token OAuth yang disediakan oleh Kredensial Default Aplikasi (ADC) untuk melakukan panggilan. Untuk mengetahui informasi tentang cara menggunakan ADC untuk memanggil Google API menggunakan library klien, lihat Mengautentikasi menggunakan library klien.

Catatan: Prosedur di bawah untuk melakukan panggilan REST tidak dimaksudkan untuk digunakan di lingkungan produksi. Gunakan prosedur ini hanya untuk lingkungan pengembangan atau pengujian.

Prasyarat

Sebelum Anda dapat membuat permintaan REST menggunakan ADC, gunakan Google Cloud CLI untuk memberikan kredensial ke ADC:

1. Instal dan lakukan inisialisasi gcloud CLI.

2. Jalankan perintah gcloud berikut di komputer lokal Anda untuk membuat file kredensial:

   gcloud auth application-default login

3. Layar login akan ditampilkan. Setelah Anda login, kredensial Anda akan disimpan dalam file kredensial lokal yang digunakan oleh ADC.

Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal.

Membuat permintaan REST

Dalam contoh ini, Anda meneruskan dua header permintaan:

• Teruskan token OAuth di header Authorization menggunakan perintah berikut untuk membuat token:

  gcloud auth application-default print-access-token

  Token yang ditampilkan memiliki cakupan https://www.googleapis.com/auth/cloud-platform.

• Teruskan ID atau nama project Google Cloud Anda yang telah mengaktifkan penagihan di header X-Goog-User-Project.

Contoh berikut melakukan panggilan ke Geocoding API menggunakan token OAuth.

1. Edit kolom PROJECT_ID untuk meneruskan ID project Google Cloud Anda.

   curl -X GET -H 'Content-Type: application/json' \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://geocode.googleapis.com/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
   

2. Klik ikon salin di contoh kode, , untuk menyalin perintah curl.
3. Tempel perintah di jendela terminal, lalu jalankan perintah.

Responsnya adalah objek JSON:

Pemecahan masalah

Jika permintaan Anda menampilkan pesan error tentang kredensial pengguna akhir yang tidak didukung oleh API ini, lihat Memecahkan masalah penyiapan ADC.