Coğrafi kodlama, adresleri (ör. açık adres) haritaya işaretçi yerleştirmek veya haritayı konumlandırmak için kullanabileceğiniz coğrafi koordinatlara (enlem ve boylam) dönüştürme işlemidir. Bu belgenin odak noktası, adreslerin coğrafi kodlanmasıyla ilgili dikkate alınması gereken noktaları açıklığa kavuşturmaktır. Geocoding API'nin ne zaman kullanılmasının en uygun olduğunu ve Yerler API Yer Otomatik Tamamlama hizmetinin ne zaman kullanılmasının yararlı olduğunu açıklar.
Genel olarak, tam adresleri (ör. "48 Pirrama Rd, Pyrmont, NSW, Avustralya") coğrafi kodlarken Geocoding API'yi kullanın. Belirsiz (eksik) adresleri coğrafi kodlarken veya kullanıcı girişine yanıt verirken gecikmeye duyarlı uygulamalar için Places API Otomatik Yer Tamamlama hizmetini kullanın.
Kullanım alanları ve API önerileri
| Kullanım alanları ve API önerileri | |
|---|---|
| Kullanıcı girişine anında yanıt verme (Kullanıcı tarafından girilen belirsiz, eksik, kötü biçimlendirilmiş veya yanlış yazılmış adresler dahildir) | Yer kimliği almak için Places API Yer Otomatik Tamamlama hizmetini, ardından yer kimliğini latlng olarak coğrafi kodlamak için Geocoding API'yi kullanın. |
| Tam ve net posta adreslerini işleyen otomatik sistemler (ör. "48 Pirrama Rd, Pyrmont, NSW, Avustralya") | Geocoding API web hizmetini kullanın. |
| Anlamsız sorguları işleyen otomatik sistemler (örneğin, eksik, kötü biçimlendirilmiş veya yanlış yazılmış adresler) | Otomatik sistemlerin Geocoding API web hizmetini kullanmasını önerin. Ancak, kullanıcı girişlerinden elde edilen belirsiz, eksik veya yanlış yazılmış sorgu oranı yüksek olan otomatik sistemler, kullanıcıların bir sonuç seçmesine ve böylece adresin yanlış yazılmasını önlemesine olanak tanıyan etkileşimli bir Yer Otomatik Tamamlama widget'ı ekleyerek fayda sağlayabilir. |
| Başlangıç, varış noktası veya yol işaretleri adres dizesi olarak belirtilmişken Directions API ya da Distance Matrix API'yi kullanarak gecikme sorunları | Yer kimlikleri almak için Places API Otomatik Yer Tamamlama hizmetini kullanarak coğrafi kodlama gecikmesini azaltın ve ardından yer kimliklerini Directions API veya Distance Matrix API'ye iletin. |
Kullanıcı girişine yanıt verme
Kullanıcı girişine gerçek zamanlı olarak yanıt veren uygulamalarda, API seçimini etkileyen iki önemli husus vardır:
- Kullanıcı girişi genellikle bir adresi kademeli olarak girmeyi içerir ("123 Ana Cadde" gibi). Bu nedenle, eksik ve belirsiz adresleri coğrafi kodlayabilmek, kullanıcının daha hızlı sonuç almasını sağladığı için yararlıdır.
- Kullanıcı girişine yanıt veren uygulamalar, gecikmeye karşı son derece hassastır.
Bu iki husus, Places API'deki Yer Adı Otomatik Tamamlama hizmetini kullanıcı girişine yanıt verme kullanım alanı için ideal kılar. Yer otomatik tamamlama, birden fazla olası seçenek döndürmek ve kullanıcının bu seçenekler arasından seçim yapmasına izin vermek için tasarlanmıştır. Yerler API'si, işletmeleri hariç tutarak yalnızca coğrafi kodları veya adresleri aramak için kısıtlanabilir. Ayrıca, otomatik tamamlama arama işlevi bir konuma özgü sonuçlar döndürecek şekilde önyargılı olabilir. Places API, tam olarak anlamlandırılmış bir konum olarak Geocoding API web hizmetine iletilebilecek bir yer kimliği döndürür. Bu hizmet daha sonra tam adres ayrıntılarını döndürür ve adresi bir enlem/boylam olarak coğrafi kodlar. Konum kimlikleri, Directions API ve Distance Matrix API gibi diğer API'lere de iletilebilir (Aşağıya bakın).
Coğrafi Kodlama API'sindeki adres coğrafi kodlaması çok daha yüksek gecikmeye sahiptir ve ayrıca eksik veya belirsiz sorgular için daha az doğru sonuçlar verir. Bu nedenle, kullanıcı girişine anında yanıt vermesi gereken uygulamalar için önerilmez.
Android, iOS, JavaScript ve Places API için Otomatik Yer Tamamlama hizmeti hakkında daha fazla bilgi edinin.
Otomatik sistemler
Tam ve net posta adreslerini işleyen otomatik sistemler: Tam posta adresi dizeleri (ör. "48 Pirrama Rd, Pyrmont, NSW, Avustralya") gibi net sorgular en iyi şekilde Coğrafi Kodlama API web hizmeti tarafından işlenir. Adres coğrafi kodlama arka ucu, dünya genelinde daha fazla adres kapsamı sunar ve bu tür eksiksiz, net sorgularla yüksek kaliteli sonuçlar için optimize edilmiştir.
Anlamsız sorguları işleyen otomatik sistem: Anlamsız sorgular, kötü biçimlendirilmiş adresler, eksik adresler veya yazım hataları içeren sorgulardır. Otomatik sistemler için Geocoding API web hizmetini kullanmanızı öneririz. Ancak Coğrafi Kodlama API'si, belirsiz sorgularla başa çıkmak için tasarlanmamıştır ve belirsiz sorgulara yanıt olarak daha az doğru sonuçlar veya sıfır sonuç verebilir. Otomatik sisteminiz, kullanıcı girişinden türetilen çok sayıda belirsiz sorgu işleyip döndürüyorsa Places API'deki Place Autocomplete hizmetini kullanarak uygulamanıza etkileşimli bir öğe ekleyebilirsiniz. Bu hizmet, birden fazla olası seçenek döndürmek ve kullanıcının bunlar arasından seçim yapmasına olanak tanımak için tasarlanmıştır. Places API, tam olarak anlamlandırılmış bir konum olarak Geocoding API web hizmetine iletilebilecek bir yer kimliği döndürür. Bu hizmet daha sonra tam adres ayrıntılarını döndürür ve adresi bir enlem/boylam olarak coğrafi kodlar. Android, iOS, JavaScript ve Places API için Otomatik Yer Tamamlama hizmeti hakkında daha fazla bilgi edinin.
Directions API ve Distance Matrix API için gecikmeyi azaltma
Başlangıç, varış noktası veya yol işaretleri adres dizesi olarak belirtildiğinde, Directions API ve Distance Matrix API, rotaları hesaplamadan önce bu adresleri coğrafi kodlamak için Geocoding API ile aynı arka uç sunucusu kullanır. Bu, latlngs veya yer kimlikleriyle aynı konumları belirtmeye kıyasla gecikmeyi önemli ölçüde artırır.
Uygulamanız, kullanıcı girişine yanıt verme gibi gecikmeye duyarlı bir durumda Directions API'yi veya Distance Matrix API'yi kullanıyorsa ve başlangıç, varış noktaları veya yol işaretçileriniz başlangıçta adres dizeleri olarak belirtilmişse adres dizelerini yer kimliklerine dönüştürmek için Places API'nin Yer Otomatik Tamamlama hizmetini kullanarak gecikmeyi en aza indirmenizi ve ardından yer kimliklerini Directions API'ye veya Distance Matrix API'ye iletmenizi öneririz. Android, iOS, JavaScript ve Places API için Otomatik Yer Tamamlama hizmeti hakkında daha fazla bilgi edinin. Bir yer otomatik tamamlama ve yol tarifi JavaScript örneğine de göz atın.
Sonuç
Kullanım alanınıza bağlı olarak, adresleri coğrafi kodlarken Geocoding API'yi veya Yerler Autocomplete hizmetini Geocoding API ile birlikte kullanmak, kullanıcılara doğru coğrafi kodlama sonuçlarının yanı sıra daha düşük gecikme süresi sunan uygulamalar oluşturmanıza olanak tanır.
Hataları ve yeniden denemeleri yönetme
UNKNOWN_ERROR yanıtları geçici hatalardan kaynaklanır ve kısa bir süre sonra yeniden denemek en iyi çözümdür. Yeniden deneme mantığını içeren ve Google Haritalar Platformu Premium Plan kimlik doğrulamasını destekleyen Google Haritalar Platformu web hizmetleri
istemci kitaplıklarını kullanmanızı öneririz.
Google Haritalar Hizmetleri için Java İstemcisi,
Python İstemcisi,
Go İstemcisi ve Node.js İstemcisi, topluluğumuz tarafından desteklenen istemci kitaplıklarıdır. GitHub'da indirilebilir ve katkıda bulunulabilir. Burada kurulum talimatlarını ve örnek kodu da bulabilirsiniz.
Yanıt olarak OVER_QUERY_LIMIT durum kodu alırsanız API'nin kullanım sınırlarını aştınız. Bu
kullanım optimizasyon stratejilerini denemenizi öneririz.