Ringkasan Geocoding API

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

Alasan 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 di peta menjadi alamat. Layanan ini dirancang untuk geocoding alamat statis standar guna penempatan konten aplikasi pada peta.

Yang dapat Anda lakukan dengan Geocoding API

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

  • 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 pada peta, atau untuk memusatkan atau mengubah posisi peta dalam bingkai 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 selengkapnya.

Referensi

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 dalam panduan Permintaan dan respons geocoding terbalik.
Geocoding tempat Menampilkan alamat, komponen alamat, dan jenis alamat. Lihat Respons geocoding terbalik dalam panduan Permintaan dan respons geocoding Tempat.

Cara menggunakan Geocoding API

1 Melakukan persiapan. Mulailah dengan Menyiapkan project Google Cloud Anda dan selesaikan petunjuk penyiapan yang mengikutinya.
2 Mencoba permintaan geocoding Setelah memiliki kunci API, Anda dapat mulai menguji Geocoding API langsung dari cURL atau browser. Anda harus memberikan parameter pencarian yang tepat untuk pencarian alamat atau komponen. Lihat Parameter Geocoding untuk mengetahui detailnya.
3 Mencoba permintaan geocoding terbalik Berikan koordinat lintang/bujur beserta kunci API Anda guna 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 mendapatkan penjelasan tentang 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 memberikan 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 komunitas, dan merupakan open source berdasarkan Lisensi Apache 2.0. Download dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah berikutnya