Geocoding adalah proses konversi 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 mengklarifikasi pertimbangan yang dilibatkan saat membuat geocoding alamat. Ini menjelaskan kapan waktu yang tepat untuk menggunakan Geocoding API dan kapan menggunakan layanan Place Autocomplete Places API akan menguntungkan.
Secara umum, gunakan Geocoding API saat geocoding alamat lengkap (misalnya, “48 Pirrama Rd, Pyrmont, NSW, Australia”). Gunakan layanan Place Autocomplete di Places API saat melakukan geocoding terhadap alamat yang ambigu (tidak lengkap) pada geocoding atau untuk aplikasi yang sensitif terhadap latensi, seperti saat merespons input pengguna.
Kasus penggunaan dan saran API
| Kasus penggunaan dan saran API | |
|---|---|
| Respons input pengguna secara real time (termasuk alamat yang ambigu, tidak lengkap, berformat salah, atau salah eja yang dimasukkan oleh pengguna) | Gunakan layanan Place Autocomplete Places API untuk mendapatkan ID tempat, lalu Geocoding API untuk melakukan geocoding terhadap ID tempat menjadi latlng. |
| Pemrosesan sistem otomatis yang lengkap, tidak ambigu, alamat pos (misalnya, “48 Pirrama Rd, Pyrmont, NSW, Australia”) | Gunakan layanan web Geocoding API. |
| Sistem otomatis yang memproses kueri ambigu (misalnya, alamat tidak lengkap, diformat dengan buruk, atau salah eja) | Merekomendasikan sistem otomatis menggunakan layanan web Geocoding API. Namun, sistem otomatis dengan tingkat kueri ambigu, tidak lengkap, atau salah eja yang tinggi yang berasal dari input pengguna mungkin akan mendapatkan manfaat dari penambahan widget Place Autocomplete yang interaktif sehingga pengguna dapat memilih hasil sehingga tidak perlu salah mengeja alamat. |
| Masalah latensi menggunakan Directions API atau Distance Matrix API, dengan asal, tujuan, atau titik jalan 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 masukan pengguna
Aplikasi yang merespons input pengguna secara real-time memiliki dua pertimbangan utama yang memengaruhi pilihan API:
- Input pengguna umumnya melibatkan pemasukan alamat secara progresif (seperti “123 Main Street”), sehingga kemampuan untuk meng-geocoding alamat yang tidak lengkap dan ambigu bermanfaat karena memungkinkan pengguna mendapatkan hasil yang 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 respons terhadap input pengguna. Place Autocomplete dirancang untuk menampilkan beberapa kemungkinan opsi dan memungkinkan pengguna memilih di antara keduanya. Places API dapat dibatasi untuk hanya menelusuri geocoding atau alamat tanpa 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 jelas ke layanan web Geocoding API, yang kemudian menampilkan detail alamat lengkap, dan meng-geocoding alamat menjadi latlng. Place ID 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 memberikan 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
Pemrosesan sistem otomatis yang lengkap, tidak ambigu, alamat pos: Kueri yang tidak ambigu seperti string alamat pos yang lengkap (misalnya, “48 Pirrama Rd, Pyrmont, NSW, Australia”) paling baik ditangani oleh layanan web Geocoding API. Backend geocoding alamat memberikan cakupan alamat yang lebih besar secara global, dan dioptimalkan untuk hasil berkualitas tinggi dengan jenis kueri yang lengkap dan tidak ambigu ini.
Sistem otomatis memproses kueri ambigu: Kueri ambigu adalah kueri yang berisi alamat dengan format yang 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 mungkin memberikan hasil yang kurang akurat atau tanpa hasil sebagai respons terhadap kueri ambigu. Jika sistem otomatis Anda memproses banyak kueri ambigu yang berasal dari input pengguna, Anda dapat memanfaatkan penambahan elemen interaktif ke aplikasi Anda menggunakan layanan Place Autocomplete di Places API, karena sistem tersebut dirancang untuk menampilkan beberapa opsi yang memungkinkan dan memungkinkan pengguna memilih di antara kueri tersebut. Places API menampilkan ID tempat yang dapat diteruskan sebagai lokasi yang sepenuhnya jelas ke layanan web Geocoding API, yang kemudian menampilkan detail alamat lengkap, dan melakukan geocoding terhadap alamat tersebut ke dalam 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 jalan ditetapkan sebagai string alamat, Directions API dan Distance Matrix API akan menggunakan backend yang sama dengan Geocoding API untuk melakukan geocoding terhadap alamat ini sebelum menghitung rute. Hal ini meningkatkan latensi secara signifikan dibandingkan dengan menentukan lokasi yang sama seperti latlng atau ID tempat.
Jika aplikasi Anda menggunakan Directions API atau Distance Matrix API dalam situasi sensitif latensi seperti merespons input pengguna, dan asal, tujuan, atau titik jalan Anda awalnya ditetapkan sebagai string alamat, sebaiknya Anda meminimalkan latensi dengan menggunakan layanan Place Autocomplete di Places API untuk mengonversi string alamat ke ID tempat, lalu meneruskan ID tempat tersebut 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 tentang pelengkapan otomatis tempat dan rute.
Kesimpulan
Bergantung pada kasus penggunaan Anda, saat geocoding alamat, menggunakan Geocoding API atau menggunakan layanan Place Autocomplete yang dikombinasikan dengan Geocoding API, memungkinkan Anda membuat aplikasi yang menawarkan hasil geocoding yang akurat kepada pengguna serta latensi yang lebih rendah.
Mengelola kesalahan dan mencoba lagi
Jika Anda menerima respons UNKNOWN_ERROR, hal ini disebabkan oleh error sementara dan sebaiknya ditangani dengan mencoba lagi setelah beberapa saat. Sebaiknya gunakan library klien layanan web Google Maps Platform yang mencakup 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
kode contoh.
Jika Anda mendapatkan kode status OVER_QUERY_LIMIT sebagai respons, Anda telah melebihi batas penggunaan untuk API. Sebaiknya Anda mencoba strategi pengoptimalan penggunaan ini.