Coğrafi kodlama ile ilgili SSS

Bu SSS, Geocoding API'ye özgü soruları kapsar. Tüm Google Haritalar Platformu'nda ortak olan sorular için Google Haritalar Platformu Hakkında SSS bölümünü inceleyin. 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, yanlış yazılmış veya var olmayan adresler gibi belirsiz, eksik ve kötü biçimlendirilmiş sorgular ZERO_RESULTS değerini döndürmeye eğilimlidir. Adres bulunamazsa kısmi bir sonuç yerine ZERO_RESULTS tercih edilir (örneğin, adres yerine yalnızca banliyö döndürülür).

Uygulamanız kullanıcıların adres girişleriyle ilgileniyorsa Yerler API'sindeki Yer Otomatik Tamamlama özelliği daha kaliteli sonuçlar sağlayabilir. Yer Otomatik Tamamlama, kullanıcıların yazdıklarına göre bir dizi sonuç arasından seçim yapmalarına olanak tanır. Bu sayede kullanıcılar benzer şekilde adlandırılmış sonuçlar arasından seçim yapabilir ve bir adresi yanlış yazdıklarında sorgularını düzenleyebilir.

Belirsiz veya eksik sorgularla ya da hata içerebilecek sorgularla ilgilenen bir uygulamanız varsa Geocoding API'deki ileri coğrafi kodlayıcı yerine Places API'deki Yer Adı Otomatik Tamamlama özelliğini kullanmanızı öneririz. Daha ayrıntılı bilgi için Adresleri Coğrafi Kodlarken Uygulanacak En İyi Uygulamalar başlıklı makaleyi ve Google Haritalar API'leri blog yayınındaki Adres Coğrafi Kodlaması başlıklı makaleyi 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şı son derece hassas olan uygulamaların, adres coğrafi kodlaması yerine Places API'deki yer otomatik tamamlama özelliğini (JavaScript, Android veya iOS'te de kullanılabilir) kullanmasını öneririz. Yer otomatik tamamlama, etkileşimli olarak kullanılmak üzere optimize edildiğinden çok düşük gecikmeye sahiptir.

Geocoding API'deki 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, Place Otomatik Tamamlama'ya kıyasla daha yüksek gecikmeye sahiptir. Doğrudan coğrafi kodlayıcı, daha geniş kapsama alanına ve daha iyi sonuç kalitesine sahiptir ancak biraz daha yüksek gecikme süresine sahiptir.

Directions API ve Distance Matrix API'deki gecikmeyi nasıl azaltabilirim?

Yol işaretlerini, başlangıç noktasını ve varış noktasını belirtmek için adresler yerine yer kimliklerini kullanın. Yer kimlikleri en iyi şekilde, Places API'deki yer otomatik tamamlama özelliğinden veya Maps JavaScript API'deki yerler kitaplığından elde edilir. Otomatik Yer Tamamlama'nın maliyetini düşürmek için kullanılabilen placeIdOnly seçeneğiyle ilgili bilgilere de göz atın.

Directions API veya Distance Matrix API, bir yer kimliği ya da enlem/boylam yerine bir adres dizesiyle sorgulandığında, bu adresleri yol tariflerini hesaplamadan önce bir yer kimliğine dönüştürmek için Geocoding API ile aynı arka uç sunucusunu kullanır. Yer otomatik tamamlama, adres coğrafi kodlamasından daha hızlıdır. Kullanıcı girişine yanıt vermek gibi gecikmeye çok duyarlı durumlarda Directions API veya Distance Matrix API'yi kullanan uygulamalar için, bu adreslere karşılık gelen yer kimliklerini almak üzere Place Autocomplete'i kullanmanızı ve yer kimliklerini Directions API veya Distance Matrix API'ye iletmenizi öneririz. Bu yaklaşım, gecikmeyi önemli ölçüde azaltır. Yer Adı Otomatik Tamamlama'nın yol tarifleriyle nasıl kullanılacağına dair örnek için dokümanlarımıza bakın.

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

Yönlendiren coğrafi kodlayıcı hizmetiyle ilgili 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 alabilirim?

Sonuç kalitesiyle ilgili sorunlara neden olan hata veya sistemsel sorunlar olup olmadığını veya geliştiricilerin daha iyi sonuçlar elde etmesine yardımcı olmak için en iyi uygulamalar kılavuzunda yapabileceğimiz değişiklikler olup olmadığını araştırmamız için, herkese açık sorunu takip etme aracımızı kullanarak birkaç sorgu paylaşın.

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ını uygular. 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 kendi API anahtarınızla değiştirdiğinizden emin olun.

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

    Örnekler:

    • components=country:FRA|locality:gallus için coğrafi kodlama yapıldığında Almanya'nın Frankfurt am Main kentindeki Gallus alt mahallesi döndürülür. Bunun nedeni, Fransa'nın 3 harfli ülke kodunun (FRA) desteklenmemesidir. Bu nedenle, herhangi bir ülkedeki sonuçlara izin verilir ve Frankfurt'taki sonuç, Fransa'daki herhangi bir sonuçtan daha iyi bir eşleşmedir. 
      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 Yer Otomatik Tamamlama tarafından daha iyi yanıtlanır.

    Örnekler:

    • components=country:US|locality:madrid için coğrafi kodlama işlemi sonucunda "Madrid, NM 87010, ABD" döndürülür ancak ABD'deki "Madrid" adlı diğer şehirlerden hiçbiri döndürülmez. 
      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 otomatik tamamlama özelliğini kullanmak ve ayrıca konum sonuçlarını etkilemek amacıyla location ve radius kullanarak bir görüntü alanı belirtmek, ABD'de "Madrid" adlı birkaç şehrin yer aldığı 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