Ringkasan Geocoding API

Developer Wilayah Ekonomi Eropa (EEA)

Geocoding API adalah layanan yang menerima tempat sebagai alamat, koordinat lintang dan bujur, atau ID Tempat. Layanan ini mengonversi alamat menjadi koordinat lintang dan bujur serta ID Tempat, atau mengonversi koordinat lintang dan bujur atau ID Tempat menjadi alamat.

Yang dapat Anda lakukan dengan Geocoding API

Anda dapat menggunakan Geocoding API untuk mendapatkan data geocoding untuk satu atau beberapa alamat atau tempat, termasuk yang berikut:

  • Koordinat geografis untuk alamat.
  • Alamat untuk kumpulan koordinat lintang dan bujur.
  • Alamat untuk ID tempat.

Anda dapat mengontrol tempat hasil muncul dan membatasi hasil ke wilayah, county, atau kode pos tertentu.

Cara kerja Geocoding API

Geocoding API melakukan geocoding dan geocoding terbalik:

  • Geocoding: Mengonversi alamat seperti "1600 Amphitheatre Parkway, Mountain View, CA" menjadi koordinat lintang dan bujur atau ID Tempat. Anda dapat menggunakan koordinat ini untuk menempatkan penanda di peta, atau untuk memusatkan atau memosisikan ulang peta dalam frame tampilan.
  • Geocoding terbalik: Mengonversi koordinat lintang/bujur atau ID Tempat menjadi alamat yang dapat dibaca manusia. Anda dapat menggunakan alamat untuk berbagai skenario, termasuk pengiriman atau pengambilan.

Demo berikut menggunakan Geocoding Service melalui Maps JavaScript API untuk menunjukkan cara kerja Geocoding API. Buka peta di tab terpisah untuk melihat opsi dan detail lainnya.

Resource

Tabel berikut merangkum resource yang tersedia melalui Geocoding API beserta data yang ditampilkan setiap endpoint.

Resource data Data yang ditampilkan Format pengembalian
Geocoding Menampilkan alamat, komponen alamat, dan jenis alamat. Lihat Hasil dalam panduan Permintaan dan respons geocoding.
  • JSON
  • XML
Geocoding terbalik Menampilkan alamat, komponen alamat, dan jenis alamat. Lihat Respons geocoding terbalik di panduan Permintaan dan respons geocoding terbalik.
Geocoding tempat Menampilkan alamat, komponen alamat, dan jenis alamat. Lihat Respons geocoding terbalik di panduan Permintaan dan respons geocoding tempat.

Cara menggunakan Geocoding API

1 Lakukan penyiapan. Mulai dengan Menyiapkan project Google Cloud dan selesaikan petunjuk penyiapan berikutnya.
2 Mencoba permintaan geocoding Setelah memiliki kunci API, Anda dapat mulai menguji Geocoding API langsung dari curl atau browser. Anda harus memberikan parameter penelusuran yang benar untuk penelusuran alamat atau komponen. Lihat Parameter geocoding untuk mengetahui detailnya.
3 Mencoba permintaan geocoding terbalik Berikan koordinat garis lintang/bujur beserta kunci API Anda untuk mendapatkan komponen alamat untuk alamat terdekat yang dapat dibaca manusia untuk lokasi tersebut. Lihat Permintaan geocoding terbalik untuk mengetahui detailnya.
4 Memahami dasar-dasar respons Semua endpoint di Geocoding API menampilkan data yang sama dalam JSON atau XML. Lihat Respons geocoding untuk penjelasan tentang data, kode status, dan pesan error.
5 Sertakan data geocoding ke dalam aplikasi Anda sendiri. Anda dapat menggunakan data geocoding untuk mendapatkan alamat dari penanda peta atau untuk menyediakan penanda di peta berdasarkan alamat yang diketahui.

Library klien yang tersedia

Panggil API ini dalam bahasa pilihan Anda melalui salah satu library klien berikut:

Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps adalah library klien yang didukung komunitas, yang bersifat open source berdasarkan Lisensi Apache 2.0. Download library tersebut dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah berikutnya