FAQ Geocoding

FAQ ini mencakup pertanyaan khusus untuk Geocoding API. Lihat FAQ Google Maps Platform untuk semua pertanyaan umum terkait Google Maps Platform. Lihat juga Praktik Terbaik Saat Melakukan Geocoding Alamat.

Pemecahan masalah

Pemecahan masalah

Saya mendapatkan lebih banyak kueri yang menampilkan ZERO_RESULTS dengan geocoder. Apa yang terjadi?

Dalam geocoder, kueri yang ambigu, tidak lengkap, dan berformat buruk, seperti alamat yang salah eja atau tidak ada, cenderung menghasilkan ZERO_RESULTS. Jika alamat tidak dapat ditemukan, ZERO_RESULTS lebih baik daripada hasil parsial (misalnya, hanya menampilkan wilayah pinggiran kota, bukan alamat).

Jika aplikasi Anda menangani input alamat pengguna, fitur Place Autocomplete di Places API dapat menghasilkan hasil yang lebih berkualitas. Place Autocomplete memungkinkan pengguna memilih dari serangkaian hasil berdasarkan apa yang telah mereka ketik, sehingga pengguna dapat memilih di antara hasil yang bernama serupa, dan menyesuaikan kueri jika salah mengeja alamat.

Jika Anda memiliki aplikasi yang menangani kueri yang ambigu atau tidak lengkap, atau kueri yang mungkin berisi error, sebaiknya gunakan fitur Place Autocomplete di Places API, bukan geocoder maju yang tersedia di Geocoding API. Untuk mengetahui detail selengkapnya, lihat Praktik Terbaik Saat Melakukan Geocoding Alamat dan postingan blog Geocoding Alamat di Google Maps API.

Saya memerlukan respons cepat, dan geocoder terlalu lambat untuk aplikasi saya. Apa yang dapat saya gunakan untuk mendapatkan respons yang lebih cepat?

Sebaiknya aplikasi yang merespons input pengguna, dan oleh karena itu sangat sensitif terhadap latensi, menggunakan fitur Place Autocomplete di Places API (juga tersedia di JavaScript, Android, atau iOS), bukan geocoding alamat. Place Autocomplete dioptimalkan untuk digunakan secara interaktif, dan karenanya memiliki latensi yang sangat rendah.

Geocoding alamat di Geocoding API dioptimalkan untuk digunakan dengan alamat yang lengkap, tidak ambigu, dan diformat dengan baik, seperti alamat pengiriman yang dimasukkan ke dalam formulir online, sehingga memiliki latensi yang lebih tinggi daripada Place Autocomplete. Geocoder penerusan memiliki cakupan yang lebih luas dan kualitas hasil yang lebih baik, tetapi dengan latensi yang agak lebih tinggi.

Bagaimana cara mengurangi latensi di Directions API (Lama) dan Distance Matrix API (Lama)?

Daripada alamat, gunakan ID tempat untuk menentukan titik jalan, asal, dan tujuan. ID tempat paling baik diperoleh dari fitur Place Autocomplete di Places API atau Places Library di Maps JavaScript API. Lihat juga informasi tentang opsi placeIdOnly, yang dapat digunakan untuk mengurangi biaya Place Autocomplete.

Saat Directions API (Legacy) atau Distance Matrix API (Legacy) dikueri dengan string alamat, bukan ID tempat atau latlng, API tersebut menggunakan backend yang sama dengan Geocoding API untuk mengonversi alamat tersebut menjadi ID tempat sebelum menghitung rute. Place Autocomplete lebih cepat daripada geocoding alamat. Untuk aplikasi yang menggunakan Directions API (Lama) atau Distance Matrix API (Lama) dalam situasi yang sangat sensitif terhadap latensi, seperti merespons input pengguna, sebaiknya gunakan Place Autocomplete untuk mendapatkan ID tempat yang sesuai dengan alamat tersebut, dan teruskan ID tempat ke Directions API (Lama) atau Distance Matrix API (Lama). Pendekatan ini mengurangi latensi secara signifikan. Lihat dokumentasi kami untuk mengetahui contoh cara menggunakan Place Autocomplete dengan rute.

Bagaimana cara melaporkan bug di geocoder?

Jika Anda memiliki laporan bug atau permintaan fitur untuk layanan forward geocoder, beri tahu kami menggunakan issue tracker publik kami.

Geocoder tidak menghasilkan hasil yang baik untuk kasus penggunaan saya. Bantuan apa yang tersedia?

Beri tahu kami menggunakan issue tracker publik kami, dengan membagikan beberapa kueri tertentu, sehingga kami dapat menyelidiki untuk melihat apakah ada bug atau masalah sistemik yang menyebabkan masalah pada kualitas hasil, atau apakah ada perubahan yang dapat kami lakukan pada panduan praktik terbaik untuk membantu developer mendapatkan hasil yang lebih baik.

Bagaimana cara mendapatkan hasil terbaik dengan geocoder menggunakan pemfilteran komponen?

Di geocoder, pemfilteran komponen hanya menerapkan batasan postal_code dan country. Contoh berikut menggambarkan cara terbaik untuk menggunakan pemfilteran komponen, bergantung pada hasil yang Anda butuhkan. Di URL permintaan contoh, pastikan untuk mengganti `YOUR_API_KEY` dengan kunci API Anda yang sebenarnya.

  • Untuk membatasi kode pos ke negara tertentu, pastikan untuk menentukan batasan negara menggunakan kode negara ISO 3166-2. Misalnya: components=country:CH|postal_code:8000 menampilkan "8000 Zürich, Switzerland". 
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
  • Untuk membatasi kueri ke negara tertentu, pastikan untuk menentukan batasan negara menggunakan kode negara ISO 3166-2. Nama negara dan singkatan lainnya mungkin tidak menghasilkan hasil yang sama dengan kode negara.

    Contoh:

    • Geocoding untuk components=country:FRA|locality:gallus menampilkan sublokalitas Gallus di Frankfurt am Main, Jerman. Hal ini karena kode negara 3 huruf untuk Prancis (FRA) tidak didukung, sehingga hasil di negara mana pun diizinkan dan hasil di Frankfurt lebih cocok daripada hasil di Prancis. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • Geocoding API tidak selalu menampilkan beberapa hasil untuk kueri yang ambigu. Kueri seperti itu lebih baik dijawab oleh Place Autocomplete.

    Contoh:

    • Geocoding untuk components=country:US|locality:madrid menampilkan "Madrid, NM 87010, USA" tetapi tidak ada kota lain di Amerika Serikat yang bernama "Madrid". 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • Menggunakan Place Autocomplete untuk input=madrid&components=country:us&types=(regions), dan juga menentukan area tampilan menggunakan location dan radius untuk membuat bias hasil lokasi, akan menghasilkan respons dengan beberapa kota di Amerika Serikat yang bernama "Madrid". 
      https://maps.googleapis.com/maps/api/place/autocomplete/json?location=37.386052,-122.083851&radius=10000&input=madrid&components=country:us&types=(regions)&key=YOUR_API_KEY