FAQ Geocoding

FAQ ini membahas pertanyaan khusus tentang Geocoding API. Lihat FAQ Google Maps Platform untuk pertanyaan umum untuk semua Google Maps Platform. Lihat juga Praktik Terbaik Saat Geocoding Alamat.

Pemecahan masalah

Pemecahan masalah

Saya semakin banyak mendapatkan kueri yang menampilkan ZERO_RESULTS dengan geocoder tersebut. Mengapa demikian?

Di geocoder, kueri yang ambigu, tidak lengkap, dan tidak diformat dengan buruk, seperti alamat yang salah eja atau tidak ada, cenderung menghasilkan ZERO_RESULTS. Jika alamat tidak dapat ditemukan, ZERO_RESULTS akan lebih disukai daripada sebagian hasil (misalnya, mengembalikan hanya daerah pinggiran sebagai pengganti alamat).

Jika aplikasi Anda berurusan dengan input alamat dari pengguna, Fitur Pelengkapan Otomatis Tempat di Places API mungkin memberikan hasil dengan kualitas yang lebih baik. Pelengkapan Otomatis Tempat memungkinkan pengguna memilih dari serangkaian hasil berdasarkan yang telah mereka ketik, yang memungkinkan pengguna memilih antara hasil dengan nama yang mirip, dan menyesuaikan kueri jika mereka salah mengeja alamat.

Jika Anda memiliki aplikasi yang menangani kueri atau kueri yang ambigu atau tidak lengkap yang mungkin mengandung kesalahan, sebaiknya gunakan Fitur Pelengkapan Otomatis Tempat di Places API, bukan geocoder maju yang tersedia di Geocoding API. Untuk detail selengkapnya, lihat Praktik Terbaik Saat Alamat Geocoding dan Alamat Geocoding di postingan blog Google Maps API.

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

Sebaiknya aplikasi yang merespons input pengguna, dan karenanya sangat sensitif terhadap latensi, gunakan 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 formulir online, sehingga memiliki latensi lebih tinggi daripada Place Autocomplete. Geocoder maju memiliki cakupan yang lebih besar dan kualitas hasil yang lebih baik, tetapi dengan latensi yang agak lebih tinggi.

Bagaimana cara mengurangi latensi pada Directions API dan Distance Matrix API?

Alih-alih alamat, gunakan ID tempat untuk menentukan titik jalan, asal, dan tujuan. ID tempat paling baik diperoleh dari Pelengkapan Otomatis Tempat di Places API atau Library Tempat di Maps JavaScript API. Lihat juga informasi tentang placeIdOnly, yang dapat digunakan untuk mengurangi biaya Pelengkapan Otomatis Tempat.

Kapan Directions API atau Distance Matrix API dikueri dengan string alamat, bukan ID tempat atau latlng, keduanya menggunakan string backend sebagai Geocoding API untuk mengonversi alamat tersebut menjadi ID tempat sebelum menghitung rute. Pelengkapan Otomatis Tempat lebih cepat daripada alamat pembuatan geocoding. Untuk aplikasi yang menggunakan Directions API atau Distance Matrix API dalam situasi yang sangat sensitif terhadap latensi, seperti dengan merespons input pengguna, sebaiknya gunakan Place Autocomplete untuk mendapatkan ID tempat yang sesuai dengan alamat tersebut, dan meneruskan ID tempat ke Directions API atau Distance Matrix API. Pendekatan ini mengurangi latensi secara signifikan. Lihat dokumentasi kami untuk contoh cara menggunakan Place Autocomplete dengan rute.

Bagaimana cara melaporkan bug di geocoder?

Jika Anda memiliki laporan bug atau permintaan fitur untuk layanan geocoder maju, harap beri tahu kami menggunakan Issue Tracker.

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

Harap beri tahu kami melalui Issue Tracker, yang membagikan beberapa kueri spesifik, sehingga kami dapat menyelidiki lihat apakah ada bug atau masalah sistemik yang menyebabkan masalah pada hasil atau jika ada perubahan yang bisa kita 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 postal_code dan Pembatasan country. Contoh berikut mengilustrasikan cara terbaik untuk menggunakan komponen filter, tergantung pada hasil yang Anda butuhkan. Dalam contoh URL permintaan, pastikan untuk ganti ‘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. Contoh: components=country:CH|postal_code:8000 menampilkan "8000 Zürich, Swiss". 
    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 pembatasan negara menggunakan kode negara ISO 3166-2. Pedesaan nama dan singkatan lainnya tidak dijamin akan memberikan hasil yang sama dengan kode negara.

    Contoh:

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

    Contoh:

    • Geocoding untuk hasil components=country:US|locality:madrid "Madrid, NM 87010, AS" tetapi tidak ada kota lain di AS yang bernama "Madrid". 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
    • Menggunakan Pelengkapan Otomatis Tempat untuk input=madrid&components=country:us&types=(regions), dan juga menentukan area pandang menggunakan location dan radius untuk mencondongkan hasil lokasi, menghasilkan respons untuk 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