Coğrafi kodlama ile ilgili SSS

Bu SSS, Geocoding API'ye özel soruları kapsamaktadır. Tüm Google Haritalar Platformu'nda sık sorulan sorular için Google Haritalar Platformu Hakkında SSS sayfasını inceleyin. Adreslerin Coğrafi Kodlamasını Yapan En İyi Uygulamalar bölümüne de göz atın.

Sorun giderme

Sorun giderme

Coğrafi kodlayıcıyla ZERO_RESULTS sonucunu veren daha fazla sorgu alıyorum. Neler oluyor?

Coğrafi kodlayıcıda, yanlış yazılmış veya var olmayan adresler gibi belirsiz, eksik ve kötü biçimlendirilmiş sorgular ZERO_RESULTS üretilebilir. Adres bulunamazsa kısmi sonuç yerine ZERO_RESULTS tercih edilir (örneğin, adres yerine yalnızca banliyö döndürme).

Uygulamanız, adreslerin kullanıcı girişleriyle ilgileniyorsa Places API'deki Otomatik Yer Tamamlama özelliği daha kaliteli sonuçlar üretebilir. Otomatik Yer Tamamlama, kullanıcıların yazdıklarına bağlı olarak bir sonuç grubundan seçim yapmasına olanak tanır. Böylece, kullanıcılar benzer ada sahip sonuçlar arasından seçim yapabilir ve bir adresi yanlış yazdığında sorgularını ayarlayabilir.

Belirsiz veya eksik sorgularla ya da hata içerebilecek sorgularla ilgilenen bir uygulamanız varsa Geocoding API'de mevcut olan yönlendirme coğrafi kodu yerine Places API'deki Yer Otomatik Tamamlama özelliğini kullanmanızı öneririz. Daha fazla bilgi için Adresleri Coğrafi Kodlama Konusunda En İyi Uygulamalar ve Google Haritalar API'leri blog yayınındaki Adres Coğrafi Kodlama bölümlerine göz atın.

Hızlı yanıtlara ihtiyacım var ve coğrafi kodlayıcı uygulamam için çok yavaş. Daha hızlı yanıt vermek için ne kullanabilirim?

Kullanıcı girişine yanıt veren ve dolayısıyla gecikmeye duyarlı olan uygulamaların, coğrafi kodlamayı ele almak yerine Places API'deki Otomatik Yer Tamamlama özelliğini (JavaScript, Android veya iOS'te de mevcuttur) kullanmasını öneririz. Otomatik Yer Tamamlama, etkileşimli kullanım için optimize edildiğinden gecikme süresi çok düşüktür.

Coğrafi Kodlama API'sindeki adres coğrafi kodlaması, online formlara girilen teslimat adresleri gibi eksiksiz, net ve iyi biçimlendirilmiş adreslerle kullanım için optimize edilmiştir ve bu nedenle Otomatik Yer Tamamlama'dan daha yüksek gecikmeye sahiptir. İleri coğrafi kodlayıcı, daha geniş kapsama ve daha iyi sonuç kalitesine sahiptir, ancak biraz daha yüksek gecikmeye sahiptir.

Directions API ve Uzaklık Matrisi API'sindeki gecikmeyi nasıl azaltabilirim?

Ara noktaları, kalkış ve varış noktalarını belirtmek için adresler yerine yer kimliklerini kullanın. Yer kimliklerinin elde edilmesi için en iyi yöntem, Places API'deki Otomatik Yer Tamamlama özelliği veya Maps JavaScript API'deki Yer kitaplığı'dır. Ayrıca, Otomatik Yer Tamamlama maliyetini azaltmak için kullanılabilecek placeIdOnly seçeneği ile ilgili bilgilere de bakın.

Directions API veya Uzaklık Matrisi API'si yer kimliği ya da latlng yerine bir adres dizesiyle sorgulandığında, yol tarifi hesaplamadan önce bu adresi bir yer kimliğine dönüştürmek için Geocoding API ile aynı arka ucu kullanır. Otomatik Yer Tamamlama, adresin coğrafi kodlamasından daha hızlıdır. Kullanıcı girişlerine yanıt vermek gibi gecikmenin son derece hassas olduğu durumlarda Directions API'yi veya Uzaklık Matrisi API'sini kullanan uygulamalarda, bu adreslere karşılık gelen yer kimliklerini almak için Otomatik Yer Tamamlama özelliğini kullanmanızı ve yer kimliklerini Directions API'ye veya Uzaklık Matris API'sine iletmenizi öneririz. Bu yaklaşım, gecikmeyi önemli ölçüde azaltır. Otomatik Yer Tamamlama özelliğinin yol tarifleriyle birlikte nasıl kullanılacağına ilişkin bir örnek için dokümanlarımıza bakın.

Coğrafi kodlayıcıda hataları nasıl bildirebilirim?

Yönlendirme coğrafi kodlayıcı hizmeti için hata raporlarınız veya özellik istekleriniz varsa lütfen herkese açık sorun izleyicimizi kullanarak bize bildirin.

Coğrafi kodlayıcı, kullanım alanım için iyi sonuçlar vermiyor. Hangi konularda yardım alabilirsiniz?

Lütfen herkese açık sorun izleyicimizi kullanarak ve belirli sorguları paylaşarak bize bildirin. Böylece, sonuç kalitesinde sorunlara neden olan hatalar veya sistemsel sorunlar olup olmadığını ya da geliştiricilerin daha iyi sonuçlar almasına yardımcı olmak için en iyi uygulamalar kılavuzunda yapabileceğimiz herhangi bir değişiklik olup olmadığını araştırabiliriz.

Bileşen filtrelemeyi kullanarak coğrafi kodlayıcıyla en iyi sonuçları nasıl elde edebilirim?

Coğrafi kodlayıcıda bileşen filtreleme yalnızca postal_code ve country kısıtlamaları uygular. Aşağıdaki örneklerde, ihtiyacınız olan sonuçlara bağlı olarak bileşen filtrelemenin en iyi nasıl kullanılacağı gösterilmektedir. Örnek istek URL'lerinde "YOUR_API_KEY" kısmını gerçek API anahtarınızla değiştirmeyi unutmayın.

  • Posta kodlarını belirli bir ülkeyle kısıtlamak için ülke kısıtlamasını ISO 3166-2 ülke kodu kullanarak belirttiğinizden emin olun. Örneğin: components=country:CH|postal_code:8000, "8000 Zürih, İsviçre" değerini döndürür.
    https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY
    
  • Sorguları belirli bir ülkeyle kısıtlamak için ülke kısıtlamasını ISO 3166-2 ülke kodu kullanarak belirttiğinizden emin olun. Ülke adları ve diğer kısaltmalar, ülke kodlarıyla aynı sonuçları verir.

    Örnekler:

    • components=country:FRA|locality:gallus için coğrafi kodlama, Almanya'nın Frankfurt am Main şehrindeki Gallus bölgesini döndürür. Bunun nedeni, Fransa için 3 harfli ülke kodunun (FRA) desteklenmediğinden, herhangi bir ülkedeki sonuçlara izin verilmesi ve Frankfurt sonucunun Fransa'daki her şeye göre daha uygun olmasıdır.
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
      
  • Coğrafi Kodlama API'si belirsiz sorgular için birden fazla sonuç döndürmez. Bu tür sorgular Otomatik Yer Tamamlama tarafından daha iyi yanıtlanır.

    Örnekler:

    • components=country:US|locality:madrid için coğrafi kodlama, "Madrid, NM 87010, ABD" ifadesini döndürür ancak ABD'deki "Madrid" adlı diğer şehirlerin hiçbirini döndürmez.
      https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY
      
    • input=madrid&components=country:us&types=(regions) için Otomatik Yer Tamamlama özelliğini kullanmak ve ayrıca konum sonuçlarını etkilemek için location ve radius ile bir görüntü alanı belirlemek, ABD'de "Madrid" adlı birkaç şehir için yanıt oluşturur.
      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