Ringkasan Geocoding API

Geocoding API adalah layanan yang menerima tempat sebagai alamat, koordinat lintang dan bujur, atau ID Tempat. Library 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 pada peta menjadi alamat. Layanan ini dirancang untuk geocoding alamat statis standar untuk penempatan konten aplikasi pada peta.

Yang dapat Anda lakukan dengan Geocoding API

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

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

Anda dapat mengontrol tempat hasil akan muncul dan membatasi hasil pada wilayah, negara, 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 garis 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 lebih lanjut.

Referensi

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

Resource data Data yang dikembalikan 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 Respons dan permintaan geocoding terbalik.
Geocoding tempat Menampilkan alamat, komponen alamat, dan jenis alamat. Lihat Respons geocoding terbalik di panduan Permintaan dan respons geocoding terbalik.

Cara menggunakan Geocoding API

1 Melakukan penyiapan. Mulailah dengan Menyiapkan project Google Cloud Anda dan menyelesaikan 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 menyediakan parameter pencarian yang benar untuk pencarian alamat atau komponen. Lihat Parameter Geocoding untuk mengetahui detailnya.
3 Mencoba permintaan geocoding terbalik Sediakan 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 mengetahui penjelasan tentang data, kode status, dan pesan error.
5 Gabungkan data geocoding ke dalam aplikasi Anda sendiri! Anda bisa 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 open source yang didukung komunitas berdasarkan Lisensi Apache 2.0. Download semuanya dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah selanjutnya