Coğrafi kodlama ile ilgili SSS
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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 başlıklı makaleyi 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 Otomatik Yer 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 almak 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ılacak şekilde 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 (eski) ve Distance Matrix API (eski)'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 (eski) veya Distance Matrix API (eski), bir yer kimliği veya enlem/boylam yerine bir adres dizesiyle sorgulandığında, yol tariflerini hesaplamadan önce bu adresi bir yer kimliğine dönüştürmek için Geocoding API ile aynı arka uç kullanılır. Yer Adı 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 (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 (eski)'ye iletmenizi öneririz.
Bu yaklaşım, gecikmeyi önemli ölçüde azaltır. Otomatik Yer Tamamlama'nın yol tarifleriyle nasıl kullanılacağına dair
örnek için dokümanlarımıza göz atı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 herkese açık
sorun takip aracımızı 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
sorun izleyicimizi kullanarak belirli birkaç sorguyu 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 "API_ANAHTARINIZ" ifadesini 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ı belirtmeyi unutmayın.
Ö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ı ve diğer kısaltmalar, ülke kodlarıyla aynı sonuçları vermeyebilir.
Ö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
- Geocoding API, belirsiz sorgular için birden fazla sonuç döndürmez. Bu tür sorgulara Yer Otomatik Tamamlama daha iyi yanıt verir.
Ö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
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-31 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-31 UTC."],[[["\u003cp\u003eThis FAQ addresses questions about the Geocoding API; for general Google Maps Platform questions, refer to the Google Maps Platform FAQ.\u003c/p\u003e\n"],["\u003cp\u003eFor applications with user input and latency sensitivity, Google recommends using Place Autocomplete instead of address geocoding for better results and speed.\u003c/p\u003e\n"],["\u003cp\u003eTo improve latency with the Directions or Distance Matrix APIs, use place IDs obtained from Place Autocomplete instead of addresses.\u003c/p\u003e\n"],["\u003cp\u003eYou can report bugs or request features for the Geocoding API through the public issue tracker.\u003c/p\u003e\n"],["\u003cp\u003eComponent filtering in the Geocoding API is primarily used to restrict results by country and postal code.\u003c/p\u003e\n"]]],[],null,["This FAQ covers questions specific to the Geocoding API.\nRefer to the [Google Maps Platform FAQ](/maps/faq) for questions\ncommon to all Google Maps Platform. See also\n[Best Practices When Geocoding Addresses](/maps/documentation/geocoding/best-practices).\n\nTroubleshooting\n\n- [I'm getting more queries that return ZERO_RESULTS with the geocoder. What's going on?](#trbl-zero-results)\n- [I need fast responses, and the geocoder is too slow for my application. What can\n I use for faster responses?](#trbl-slow)\n- [How can I mitigate the latency on the Directions API (Legacy) and\n Distance Matrix API (Legacy)?](#trbl-latency)\n- [How do I report bugs in the geocoder?](#trbl-report-bug)\n- [The geocoder isn't producing good results for my use case. What help is available?](#trbl-help)\n- [How do I get the best results with the geocoder using component filtering?](#trbl-component-filtering)\n\nTroubleshooting\n\n\nI'm getting more queries that return ZERO_RESULTS with the geocoder. What's going on?\n\n: In the geocoder, ambiguous, incomplete and badly formatted queries, such as\n misspelled or nonexistent addresses, are prone to produce ZERO_RESULTS.\n If the address cannot be found, ZERO_RESULTS is preferable to a partial\n result (for example returning only the suburb in lieu of an address).\n\n If your application deals with user input of addresses, the\n [Place Autocomplete](/maps/documentation/places/web-service/autocomplete) feature\n in the Places API may produce better quality results.\n Place Autocomplete allows users to select from a set of results based on what\n they've typed, which allows users to choose between similarly named results,\n and to adjust their query if they misspell an address.\n\n If you have an application dealing with ambiguous or incomplete queries or queries\n that may contain errors, we recommend you use the\n [Place Autocomplete](/maps/documentation/places/web-service/autocomplete) feature\n in the Places API rather than the forward geocoder\n available in the Geocoding API. For more details, see\n [Best Practices When Geocoding Addresses](/maps/documentation/geocoding/best-practices) and the\n [Address Geocoding in the Google Maps APIs blog post](https://mapsplatform.google.com/resources/blog/address-geocoding-in-google-maps-apis/).\n\n\nI need fast responses, and the geocoder is too slow for my application. What can\nI use for faster responses?\n\n: We recommend that applications that respond to user input, and therefore are highly\n latency-sensitive, use the [Place Autocomplete](/maps/documentation/places/web-service/autocomplete)\n feature in the Places API (also available in\n [JavaScript](/maps/documentation/javascript/places-autocomplete),\n [Android](/maps/documentation/places/android-sdk/autocomplete), or\n [iOS](/maps/documentation/places/ios-sdk/autocomplete)) rather than address geocoding.\n Place Autocomplete is optimized to be used interactively, and thus has very low latency.\n\n Address geocoding in the Geocoding API is optimized for use with\n complete, unambiguous, well formatted addresses, such as delivery addresses entered into\n online forms, and thus has higher latency than Place Autocomplete. The forward geocoder\n has greater coverage and better result quality, but with somewhat higher latency.\n\n\nHow can I mitigate the latency on the Directions API (Legacy) and\nDistance Matrix API (Legacy)?\n\n: Instead of addresses, use [place IDs](/maps/documentation/places/web-service/place-id) to\n specify waypoints, origin, and destination. Place IDs are best obtained from the\n [Place Autocomplete](/maps/documentation/places/web-service/autocomplete)\n feature in the Places API or the\n [Places library](/maps/documentation/javascript/places-autocomplete) in the\n Maps JavaScript API. See also the information on the\n [`placeIdOnly`](/maps/documentation/javascript/places-autocomplete#placeidonly) option, which can be used to reduce the cost of\n Place Autocomplete.\n\n When the Directions API (Legacy) or Distance Matrix API (Legacy)\n is queried with an address string rather than a place ID or latlng, they use the same\n backend as the Geocoding API to convert that address into a\n place ID prior to calculating directions. Place Autocomplete is faster than address\n geocoding. For applications that use the Directions API (Legacy) or\n Distance Matrix API (Legacy) in highly latency-sensitive situations, such as\n responding to user input, we recommended you use Place Autocomplete to get the place IDs\n corresponding to those addresses, and pass the place IDs to the\n Directions API (Legacy) or Distance Matrix API (Legacy).\n This approach reduces latency significantly. See our documentation for an\n [example of how to use Place Autocomplete with directions](/maps/documentation/javascript/examples/places-autocomplete-directions).\n\n\nHow do I report bugs in the geocoder?\n\n: If you have any\n [bug reports](https://issuetracker.google.com/savedsearches/558483) or\n [feature requests](https://issuetracker.google.com/issues/new?component=188871&template=788905) for the forward geocoder service, let us know using our public\n [issue tracker](https://issuetracker.google.com/issues/new?component=188871&template=788906).\n\n\nThe geocoder isn't producing good results for my use case. What help is available?\n\n: Let us know using our public\n [issue tracker](https://issuetracker.google.com/savedsearches/558483), sharing a few specific queries, so we can investigate to\n see if there are any bugs or systemic issues causing problems with result\n quality, or if there are any changes we can make to the\n [best practices guide](/maps/documentation/geocoding/best-practices)\n to help developers get better results.\n\n\nHow do I get the best results with the geocoder using component filtering?\n\n: In the geocoder, [component filtering](/maps/documentation/geocoding/overview#component-filtering) enforces only `postal_code` and\n `country` restrictions. The following examples illustrate how best to use component\n filtering, depending on the results you need. In the sample request URLs, be sure to\n replace \\`YOUR_API_KEY\\` with your actual API key.\n\n - To restrict postal codes to a specific country, be sure to specify the country restriction using an [ISO 3166-2 country code](https://en.wikipedia.org/wiki/ISO_3166-2). For example: `components=country:CH|postal_code:8000` returns \"8000 Zürich, Switzerland\". \n\n ```scdoc\n https://maps.googleapis.com/maps/api/geocode/json?components=country:CH%7Cpostal_code:8000&key=YOUR_API_KEY\n ```\n - To restrict queries to a specific country, be sure to specify the country restriction using an [ISO 3166-2 country code](https://en.wikipedia.org/wiki/ISO_3166-2). Country names and other abbreviations may not produce the same results as country codes.\n\n Examples:\n - Geocoding for `components=country:FRA|locality:gallus` returns the sublocality of Gallus in Frankfurt am Main, Germany. This is because the 3-letter country code for France (FRA) isn't supported, thus results in any country are allowed and the result in Frankfurt is a better fit than anything in France. \n\n ```scdoc\n https://maps.googleapis.com/maps/api/geocode/json?components=country:FRA%7Clocality:gallus&key=YOUR_API_KEY\n ```\n - Geocoding API won't necessarily return multiple results for ambiguous queries. Such queries are better answered by the Place Autocomplete. Examples:\n\n - Geocoding for `components=country:US|locality:madrid` returns \"Madrid, NM 87010, USA\" but none of the other cities in the USA named \"Madrid\". \n\n ```scdoc\n https://maps.googleapis.com/maps/api/geocode/json?components=country:US%7Clocality:madrid&key=YOUR_API_KEY\n ```\n - Using Place Autocomplete for `input=madrid&components=country:us&types=(regions)`, and also specifying a viewport using `location` and `radius` to [bias the location results](/maps/documentation/places/web-service/autocomplete#location_biasing), generates a response with several cities in the USA named \"Madrid\". \n\n ```carbon\n 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\n ```"]]
