Ringkasan Geocoding API

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

Mengapa menggunakan Geocoding API

Gunakan Geocoding API untuk situs atau aplikasi seluler jika Anda ingin menggunakan data geocoding dalam peta yang disediakan oleh salah satu API Google Maps Platform. Dengan Geocoding API, Anda menggunakan alamat untuk menempatkan penanda pada peta, atau mengonversi penanda pada peta menjadi alamat. Layanan ini dirancang untuk geocoding alamat statis yang telah ditetapkan sebelumnya untuk penempatan konten aplikasi pada peta.

Yang dapat Anda lakukan dengan Geocoding API

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

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

Anda dapat mengontrol tempat munculnya hasil dan membatasi hasil ke wilayah, wilayah, 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 pada 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 Layanan Geocoding 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 bersama dengan data yang ditampilkan oleh setiap endpoint.

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

Cara menggunakan Geocoding API

1 Mulai penyiapan. Mulai dengan Menyiapkan project Google Cloud Anda dan selesaikan petunjuk penyiapan yang mengikuti.
2 Mencoba permintaan geocoding Setelah memiliki kunci API, Anda dapat mulai menguji Geocoding API langsung dari cURL atau browser. Anda harus menyediakan parameter pencarian yang benar untuk pencarian 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 orang 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 format JSON atau XML. Lihat Respons Geocoding untuk penjelasan mengenai data, kode status, dan pesan error.
5 Gabungkan data geocoding ke dalam aplikasi Anda sendiri. Anda dapat menggunakan data geocoding untuk mendapatkan alamat dari penanda peta atau untuk menyediakan penanda pada 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 oleh komunitas, yang bersifat open source berdasarkan Lisensi Apache 2.0. Download file dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah berikutnya