Coğrafi kodlama ile ilgili SSS

Bu SSS, Geocoding API'ye özgü soruları kapsar. Tüm Google Haritalar Platformu için ortak olan sorular için Google Haritalar Platformu SSS bölümüne bakın. Ayrıca Adresleri Coğrafi Kodlamayla İlgili En İyi Uygulamalar başlıklı makaleyi de inceleyin.

Sorun giderme

Sorun giderme

Coğrafi kodlayıcıyla ZERO_RESULTS döndüren daha fazla sorgu alıyorum. Neler oluyor?

Coğrafi kodlayıcıda belirsiz, eksik ve kötü biçimlendirilmiş sorgular (ör. yanlış yazılmış veya mevcut olmayan adresler) ZERO_RESULTS hatası vermeye yatkındır. Adres bulunamıyorsa kısmi bir sonuç yerine ZERO_RESULTS tercih edilir (örneğin, adres yerine yalnızca banliyö döndürülür).

Uygulamanız adreslerle ilgili kullanıcı girişleriyle ilgileniyorsa Places API'deki Yer Adı Otomatik Tamamlama özelliği daha kaliteli sonuçlar üretebilir. Yer Adı Otomatik Tamamlama, kullanıcıların yazdıklarına göre bir dizi sonuç arasından seçim yapmasına olanak tanır. Bu sayede kullanıcılar, benzer şekilde adlandırılmış sonuçlar arasında seçim yapabilir ve bir adresi yanlış yazmaları durumunda sorgularını düzeltebilir.

Belirsiz veya eksik sorgularla ya da hata içerebilecek sorgularla ilgilenen bir uygulamanız varsa Geocoding API'deki ileriye dönük coğrafi kodlayıcı yerine Places API'deki Yer Adı Otomatik Tamamlama özelliğini kullanmanızı öneririz. Daha fazla bilgi için Adresleri Coğrafi Kodlarken En İyi Uygulamalar ve Google Maps API'lerinde Adres Coğrafi Kodlama başlıklı blog yayınını inceleyin.

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

Kullanıcı girişine yanıt veren ve bu nedenle gecikmeye karşı çok hassas olan uygulamaların, adres coğrafi kodlaması yerine Places API'deki Yer Adı Otomatik Tamamlama özelliğini (JavaScript, Android veya iOS'te de kullanılabilir) kullanmasını öneririz. Yer Adı Otomatik Tamamlama, etkileşimli olarak kullanılacak şekilde optimize edildiğinden gecikme süresi çok düşüktür.

Geocoding API'deki adres coğrafi kodlama, online formlara girilen teslimat adresleri gibi eksiksiz, net ve iyi biçimlendirilmiş adreslerle kullanılmak üzere optimize edildiğinden Yer Otomatik Tamamlama'ya kıyasla daha yüksek gecikmeye sahiptir. İleri coğrafi kodlayıcı daha geniş kapsama alanına ve daha iyi sonuç kalitesine sahiptir ancak gecikme süresi biraz daha uzundur.

Directions API (Eski) ve Distance Matrix API (Eski) üzerindeki gecikmeyi nasıl azaltabilirim?

Adres yerine yer kimliklerini kullanarak ara noktaları, başlangıcı ve hedefi belirtin. Yer kimlikleri en iyi şekilde Places API'deki Yer Adı Otomatik Tamamlama özelliğinden veya Maps JavaScript API'deki Yer Kitaplığı'ndan alınır. Yer Adı Otomatik Tamamlama maliyetini azaltmak için kullanılabilecek placeIdOnly seçeneğiyle ilgili bilgilere de göz atın.

Directions API (Legacy) veya Distance Matrix API (Legacy), yer kimliği ya da latlng yerine bir adres dizesiyle sorgulandığında bu adresi yönleri hesaplamadan önce yer kimliğine dönüştürmek için Geocoding API ile aynı arka ucu kullanır. Yer Adı Otomatik Tamamlama, adres coğrafi kodlamasından daha hızlıdır. Kullanıcı girişine yanıt verme gibi gecikmeye karşı hassas durumlarda Directions API (Eski) veya Distance Matrix API (Eski) kullanan uygulamalar için, bu adreslere karşılık gelen yer kimliklerini almak üzere Yer Adı Otomatik Tamamlama'yı kullanmanızı ve yer kimliklerini Directions API (Eski) veya Distance Matrix API'ye (Eski) iletmenizi öneririz. Bu yaklaşım, gecikmeyi önemli ölçüde azaltır. Yer Adı Otomatik Tamamlama'yı yol tarifleriyle kullanma örneği için dokümanlarımızı inceleyin.

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

İleri coğrafi kod çözücü hizmetiyle ilgili hata raporlarınız veya özellik istekleriniz varsa herkese açık Issue Tracker'ımızı kullanarak bize bildirin.

Coğrafi kodlayıcı, kullanım alanım için iyi sonuçlar üretmiyor. Yardım alabilirsiniz?

Herkese açık Issue Tracker'ımızı kullanarak birkaç belirli sorgu paylaşarak bize bildirin. Böylece sonuç kalitesiyle ilgili sorunlara neden olan hatalar veya sistemik 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 değişiklikler olup olmadığını araştırabiliriz.

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

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

  • Posta kodlarını belirli bir ülkeyle sınırlamak için ISO 3166-2 ülke kodu kullanarak ülkeye özgü kısıtlamaları belirttiğinizden emin olun. Örneğin: components=country:CH|postal_code:8000 "8000 Zürich, İsviçre" sonucunu 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 ISO 3166-2 ülke kodu kullanarak ülkeye özgü kısıtlamaları belirttiğinizden emin olun. Ülke adları ve diğer kısaltmalar, ülke kodlarıyla aynı sonuçları vermeyebilir.

    Örnekler:

    • components=country:FRA|locality:gallus için coğrafi kodlama, Almanya'nın Frankfurt am Main şehrindeki Gallus alt yerleşim birimini döndürür. Bunun nedeni, Fransa'nın 3 harfli ülke kodunun (FRA) desteklenmemesi, dolayısıyla herhangi bir ülkedeki sonuçlara izin verilmesi ve Frankfurt'taki sonucun Fransa'daki her şeyden daha uygun olmasıdır. 
      https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY
  • Geocoding API, belirsiz sorgular için birden fazla sonuç döndürmeyebilir. Bu tür sorgular, Yer Adı Otomatik Tamamlama tarafından daha iyi yanıtlanır.

    Örnekler:

    • components=country:US|locality:madrid için coğrafi kodlama "Madrid, NM 87010, ABD" sonucunu döndürüyor ancak ABD'de "Madrid" adlı diğer şehirlerin hiçbirini döndürmüyor. 
      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 Yer Adı Otomatik Tamamlama özelliğini kullanmanın yanı sıra location ve radius kullanarak görüntü alanını belirtip konum sonuçlarını etkilemek, ABD'de "Madrid" adlı birkaç şehri içeren bir 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