Geocoding adalah proses mengonversi alamat (seperti alamat jalan) menjadi koordinat geografis (lintang dan bujur) yang dapat Anda gunakan untuk menempatkan penanda pada peta, atau memosisikan peta. Fokus dokumen ini adalah untuk memperjelas pertimbangan yang terlibat saat melakukan geocoding alamat. Panduan ini menjelaskan kapan sebaiknya menggunakan Geocoding API dan kapan sebaiknya menggunakan layanan Place Autocomplete Places API.
Secara umum, gunakan Geocoding API saat melakukan geocoding alamat lengkap (misalnya, "48 Pirrama Rd, Pyrmont, NSW, Australia"). Gunakan layanan Pelengkapan Otomatis Tempat Places API saat melakukan geocoding alamat yang ambigu (tidak lengkap) atau untuk aplikasi yang sensitif terhadap latensi, seperti saat merespons input pengguna.
Kasus penggunaan dan saran API
| Kasus penggunaan dan saran API | |
|---|---|
| Merespons input pengguna secara real time (termasuk alamat yang ambigu, tidak lengkap, berformat buruk, atau salah eja yang dimasukkan oleh pengguna) | Gunakan layanan Place Autocomplete Places API untuk mendapatkan ID tempat, lalu Geocoding API untuk melakukan geocoding ID tempat menjadi latlng. |
| Sistem otomatis yang memproses alamat pos lengkap dan tidak ambigu (misalnya, “48 Pirrama Rd, Pyrmont, NSW, Australia”) | Gunakan layanan web Geocoding API. |
| Sistem otomatis yang memproses kueri ambigu (misalnya, alamat yang tidak lengkap, berformat buruk, atau salah eja) | Menyarankan sistem otomatis menggunakan layanan web Geocoding API. Namun, sistem otomatis dengan rasio kueri ambigu, tidak lengkap, atau salah ejaan yang tinggi yang berasal dari input pengguna dapat memanfaatkan penambahan widget Place Autocomplete interaktif untuk memungkinkan pengguna memilih hasil sehingga menghindari kesalahan ejaan alamat. |
| Masalah latensi menggunakan Directions API atau Distance Matrix API, dengan asal, tujuan, atau titik perhentian yang ditentukan sebagai string alamat | Kurangi latensi geocoding dengan menggunakan layanan Place Autocomplete Places API untuk mendapatkan ID tempat, lalu teruskan ID Tempat ke Directions API atau Distance Matrix API. |
Merespons input pengguna
Aplikasi yang merespons input pengguna secara real-time memiliki dua pertimbangan utama yang memengaruhi pilihan API:
- Input pengguna umumnya melibatkan memasukkan alamat secara bertahap (seperti "123 Main Street"), sehingga kemampuan untuk melakukan geocoding alamat yang tidak lengkap dan ambigu akan bermanfaat karena memungkinkan pengguna mendapatkan hasil lebih cepat.
- Aplikasi yang merespons masukan pengguna sangat sensitif pada latensi.
Kedua pertimbangan ini membuat layanan Place Autocomplete di Places API ideal untuk kasus penggunaan merespons input pengguna. Autocomplete Tempat dirancang untuk menampilkan beberapa opsi yang mungkin dan memungkinkan pengguna memilih di antara opsi tersebut. Places API dapat dibatasi untuk hanya menelusuri geocode atau alamat, sekaligus mengecualikan bisnis. Selain itu, fungsi pencarian pelengkapan otomatis dapat dibiaskan untuk menampilkan hasil yang spesifik untuk suatu lokasi. Places API menampilkan ID tempat yang dapat diteruskan sebagai lokasi yang sepenuhnya dibedakan ke layanan web Geocoding API, yang kemudian menampilkan detail alamat lengkap, dan melakukan geocoding alamat ke latlng. ID tempat juga dapat diteruskan ke API lain, seperti Directions API dan Distance Matrix API (lihat di bawah).
Geocoding alamat di Geocoding API memiliki latensi yang jauh lebih tinggi, dan juga menghasilkan hasil yang kurang akurat untuk kueri yang tidak lengkap atau ambigu, sehingga tidak direkomendasikan untuk aplikasi yang harus merespons input pengguna secara real time.
Dapatkan informasi selengkapnya tentang layanan Place Autocomplete untuk Android, iOS, JavaScript, dan Places API.
Sistem otomatis
Sistem otomatis yang memproses alamat pos lengkap dan tidak ambigu: Kueri yang tidak ambigu seperti string alamat pos lengkap (misalnya, "48 Pirrama Rd, Pyrmont, NSW, Australia") sebaiknya ditangani oleh layanan web Geocoding API. Backend geocoding alamat memberikan cakupan alamat yang lebih luas secara global, dan dioptimalkan untuk hasil berkualitas tinggi dengan jenis kueri lengkap dan tidak ambigu ini.
Sistem otomatis memproses kueri ambigu: Kueri ambigu adalah kueri yang berisi alamat yang berformat buruk, alamat yang tidak lengkap, atau kesalahan ejaan. Untuk sistem otomatis, sebaiknya gunakan layanan web Geocoding API. Namun, Geocoding API tidak dirancang untuk menangani kueri ambigu dan dapat menghasilkan hasil yang kurang akurat atau nol sebagai respons terhadap kueri ambigu. Jika sistem otomatis Anda memproses kueri ambigu dalam jumlah besar yang berasal dari input pengguna, Anda dapat memanfaatkan penambahan elemen interaktif ke aplikasi menggunakan layanan Place Autocomplete di Places API, karena layanan ini dirancang untuk menampilkan beberapa opsi yang mungkin dan memungkinkan pengguna memilih di antara opsi tersebut. Places API menampilkan ID tempat yang dapat diteruskan sebagai lokasi yang sepenuhnya dibedakan ke layanan web Geocoding API, yang kemudian menampilkan detail alamat lengkap, dan melakukan geocoding alamat menjadi latlng. Dapatkan informasi selengkapnya tentang layanan Place Autocomplete untuk Android, iOS, JavaScript, dan Places API.
Mengurangi latensi untuk Directions API dan Distance Matrix API
Jika asal, tujuan, atau titik perhentian ditentukan sebagai string alamat, Directions API dan Distance Matrix API menggunakan backend yang sama dengan Geocoding API untuk melakukan geocoding alamat ini sebelum menghitung rute. Hal ini secara signifikan meningkatkan latensi dibandingkan dengan menentukan lokasi yang sama seperti latlng atau ID tempat.
Jika aplikasi Anda menggunakan Directions API atau Distance Matrix API dalam situasi yang sensitif terhadap latensi seperti merespons input pengguna, dan asal, tujuan, atau titik perhentian Anda awalnya ditentukan sebagai string alamat, sebaiknya minimalkan latensi dengan menggunakan layanan Places Autocomplete dari Places API untuk mengonversi string alamat menjadi ID tempat, lalu teruskan ID tempat ke Directions API atau Distance Matrix API. Dapatkan informasi selengkapnya tentang layanan Place Autocomplete untuk Android, iOS, JavaScript, dan Places API. Lihat juga contoh JavaScript untuk petunjuk arah dan pelengkapan otomatis tempat.
Kesimpulan
Bergantung pada kasus penggunaan Anda, saat melakukan geocoding alamat, menggunakan Geocoding API atau menggunakan layanan Place Autocomplete dalam kombinasi dengan Geocoding API memungkinkan Anda membuat aplikasi yang menawarkan hasil geocoding yang akurat kepada pengguna serta mengurangi latensi.
Mengelola error dan percobaan ulang
Jika Anda menerima respons UNKNOWN_ERROR, respons ini disebabkan oleh error sementara
dan sebaiknya ditangani dengan mencoba lagi setelah penundaan singkat. Sebaiknya gunakan
library klien layanan web Google Maps Platform yang menyertakan logika percobaan ulang dan mendukung autentikasi Premium Plan Google Maps Platform.
Klien Java,
Klien Python,
Klien Go,
dan Klien Node.js
untuk Layanan Google Maps adalah library klien yang didukung komunitas, tersedia untuk didownload
dan kontribusi di GitHub, tempat Anda juga akan menemukan petunjuk penginstalan dan
contoh kode.
Jika Anda mendapatkan kode status OVER_QUERY_LIMIT sebagai respons, Anda telah
melampaui batas penggunaan untuk API. Sebaiknya
Anda mencoba
strategi pengoptimalan penggunaan ini.