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:
Rilis Geocoding API v4 ini mencakup rilis endpoint berikut:
- (Pratinjau) Memberi geocode pada alamat — Koordinat geografis untuk alamat. Juga disebut geocoding maju.
- (Pratinjau) Geocode lokasi — Alamat untuk kumpulan koordinat lintang dan bujur. Juga disebut geocoding terbalik.
- (Pratinjau) Geocoding tempat — Mengambil alamat dari ID tempat.
- (Pratinjau) Menelusuri tujuan — Telusuri tujuan dari alamat, ID tempat, atau lokasi.
Anda dapat mengontrol tempat hasil muncul dan membatasi hasil ke wilayah, kabupaten, 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 dan bujur atau ID Tempat menjadi alamat yang dapat dibaca manusia. Anda dapat menggunakan alamat untuk berbagai skenario, termasuk pengiriman atau pengambilan.
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 dokumentasi Respons geocode. |
|
| Geocoding terbalik | Menampilkan alamat, komponen alamat, dan jenis alamat. Lihat dokumentasi Respons geocoding terbalik. | |
| Geocoding tempat | Menampilkan alamat, komponen alamat, dan jenis alamat. Lihat dokumentasi Respons geocoding tempat. | |
| Penelusuran tujuan | Menampilkan informasi mendetail tentang berbagai tujuan berdasarkan kriteria input yang berbeda, seperti alamat, ID tempat, atau koordinat lintang dan bujur. Lihat dokumentasi Penelusuran tujuan. |
Fitur di Geocoding API v4
Geocoding API versi 4 menawarkan fitur baru ini.
Endpoint penelusuran tujuan
v4 memperkenalkan Endpoint penelusuran tujuan yang memungkinkan Anda mengambil informasi mendetail tentang berbagai tujuan berdasarkan kriteria input yang berbeda, seperti alamat, ID tempat, atau koordinat lintang dan bujur. Respons mencakup ringkasan yang didukung AI dan token titik navigasi yang berisi informasi kontekstual yang dapat diteruskan ke Navigation SDK untuk perutean yang presisi.
Diimplementasikan di platform standar Google Cloud
Geocoding API v4 diimplementasikan di infrastruktur layanan di Google Cloud. Penerapan ini menghadirkan platform yang lebih aman dan tepercaya dengan opsi keamanan yang ditingkatkan seperti OAuth. Desain API standar ini memberikan tingkat konsistensi di seluruh API yang meningkatkan efisiensi pengembangan dengan Geocoding API v4.
Dukungan OAuth ditambahkan
Geocoding API v4 mendukung penggunaan OAuth 2.0 untuk autentikasi. Google mendukung skenario OAuth 2.0 umum seperti skenario untuk server web.
Dukungan mask kolom ditambahkan
Gunakan mask kolom untuk menentukan informasi yang harus ditampilkan oleh respons. Untuk endpoint Geocode alamat, Geocode lokasi, dan Geocoding tempat, semua kolom dalam objek respons ditampilkan secara default. Untuk endpoint Search for destinations, Anda harus menentukan mask kolom dalam permintaan API.
Tidak ada biaya untuk penggunaan selama Pratinjau
Geocoding API v4 berada dalam tahap Pratinjau pra-GA, dan tidak ada biaya untuk penggunaan API selama Pratinjau. Panggilan API akan muncul di halaman Penagihan di Konsol Cloud, tetapi biaya akan menjadi $0.
Masukan
Ini adalah fitur Pratinjau. Kami akan menghargai masukan yang dikirimkan ke geocoding-feedback-channel@google.com.