Coğrafi kodlama, adresleri (açık adres gibi) coğrafi koordinatlara (enlem ve boylam) dönüştürme işlemidir. Bunları bir haritaya işaretçi yerleştirmek veya haritayı konumlandırmak için kullanabilirsiniz. Bu belgede, adreslerin coğrafi kodlamasını yaparken dikkate alınması gereken noktaların netleştirilmesi amaçlanmaktadır. Bu kılavuzda, Coğrafi Kodlama API'sini kullanmanın en uygun olduğu ve Places API Yer Otomatik Tamamlama hizmetinin ne zaman yararlı olduğu açıklanmaktadır.
Genel olarak, tam adreslerin coğrafi kodlamasını yaparken (ör. "48 Pirrama Rd, Pyrmont, NSW, Avustralya") Geocoding API'yi kullanın. Belirsiz (eksik) adreslerin coğrafi kodlamasını yaparken veya kullanıcı girişine yanıt verme gibi gecikmeye duyarlı uygulamalarda Places API Place Autocomplete hizmetini kullanın.
Kullanım alanları ve API önerileri
|Kullanım alanları ve API önerileri
|Kullanıcı girişlerine gerçek zamanlı olarak yanıt verme (kullanıcı tarafından girilen belirsiz, eksik, kötü biçimlendirilmiş veya yanlış yazılmış adresler dahil)
|Yer kimliği almak için Places API Yer Otomatik Tamamlama hizmetini kullanın. Ardından, yer kimliğini enlBoy coğrafi kodla coğrafi kodlamak için Coğrafi Kodlama API'sini kullanın.
|Otomatik sistemlerin eksiksiz, açık, posta adreslerini işlemesi (ör. "48 Pirrama Rd, Pyrmont, NSW, Avustralya")
|Geocoding API web hizmetini kullanın.
|Belirsiz sorguları işleyen otomatik sistemler (ör. eksik, kötü biçimlendirilmiş veya yanlış yazılmış adresler)
|Coğrafi Kodlama API'si web hizmetini kullanan otomatik sistemler önerme. Bununla birlikte, kullanıcı girişlerinden türetilen muğlak, eksik veya yanlış yazılmış sorguların yüksek olduğu otomatik sistemler, kullanıcıların bir sonucu seçip adresi yanlış yazmasını önlemek için etkileşimli bir Otomatik Yer Tamamlama widget'ının eklenmesinden yararlanabilir.
|Adres dizeleri olarak başlangıç noktaları, hedefler veya ara noktalarla ilgili olarak Directions API'nin veya Uzaklık Matrisi API'sinin kullanıldığı gecikme sorunları
|Yer kimliklerini almak için Places API Yer Otomatik Tamamlama hizmetini kullanarak coğrafi kodlama gecikmesini azaltın ve ardından yer kimliklerini Directions API'ye veya DISTANCE Matrix API'ye iletin.
Kullanıcı girişine yanıt verme
Kullanıcı girişlerine gerçek zamanlı olarak yanıt veren uygulamalarda, API seçimini etkileyen iki önemli husus dikkate alınır:
- Kullanıcı girişi genellikle bir adresin kademeli olarak girilmesini içerir (ör. "123 Main Street"), bu nedenle eksik ve belirsiz adreslerin coğrafi kodlamasını yapmak, kullanıcının daha hızlı sonuç almasını sağladığı için faydalıdır.
- Kullanıcı girişine yanıt veren uygulamalar gecikmeye son derece duyarlıdır.
Bu iki nokta, Places API'deki Yer Otomatik Tamamlama hizmetini kullanıcı girişine yanıt verme kullanım alanı için ideal hale getirir. Otomatik Yer Tamamlama, birden çok olası seçeneği döndürecek ve kullanıcının bunlardan birini seçmesine olanak tanıyacak şekilde tasarlanmıştır. Yerler API'si, işletmeleri hariç tutarken yalnızca coğrafi kodları veya adresleri arayacak şekilde kısıtlanabilir. Ayrıca otomatik tamamlama arama işlevi, bir konuma özgü sonuçlar döndürmek için ağırlıklandırılabilir. Yerler API'si, Geocoding API web hizmetine tamamen netleştirilmiş bir konum olarak aktarılabilen bir yer kimliği döndürür. Bu kimlik, daha sonra tam adres ayrıntılarını döndürür ve adresin coğrafi kodunu enlng'e dönüştürür. Yer kimlikleri, Directions API ve DISTANCE Matrix API gibi diğer API'lere de iletilebilir (aşağıya bakın).
Geocoding API'de adres coğrafi kodlaması çok daha yüksek gecikmeye sahiptir ve ayrıca eksik veya belirsiz sorgular için doğruluğu daha düşük sonuçlar üretir. Bu nedenle, kullanıcı girişine gerçek zamanlı olarak yanıt vermesi gereken uygulamalar için önerilmez.
Otomatik sistemler
Otomatik sistemlerin eksiksiz ve açık, posta adreslerini işlemesi: Tam posta adresi dizeleri (ör. "48 Pirrama Rd, Pyrmont, NSW, Australia") gibi belirsiz olmayan sorgular en iyi şekilde Geocoding API web hizmeti tarafından yönetilir. Adres coğrafi kodlaması arka ucu, global olarak adreslerin daha geniş bir kapsamını sunar ve bu tür eksiksiz, açık sorgularla yüksek kaliteli sonuçlar için optimize edilmiştir.
Belirsiz sorguları otomatik olarak işleme koyma: Belirsiz 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 Geocoding API, muğlak sorgularla başa çıkacak şekilde tasarlanmamıştır ve belirsiz sorgulara yanıt olarak daha az doğru sonuçlar veya sıfır sonuç üretebilir. Otomatik sisteminiz, kullanıcı girişlerinden türetilen çok sayıda belirsiz sorgu işlerse Yerler API'deki Otomatik Yer Tamamlama hizmetini kullanarak uygulamanıza etkileşimli bir öğe ekleyebilirsiniz. Bu hizmet, birden çok olası seçeneği döndürecek ve kullanıcının bu seçenekler arasından seçim yapmasına olanak tanıyacak şekilde tasarlanmıştır. Yerler API'si, Geocoding API web hizmetine tamamen netleştirilmiş bir konum olarak iletilebilecek bir yer kimliği döndürür. Bu kimlik, daha sonra tam adres bilgilerini döndürür ve adresin coğrafi kodunu enlng'e dönüştürür. 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
Kaynaklar, hedefler veya ara noktalar adres dizeleri olarak belirtildiğinde Directions API ve Mesafe Matrisi API'si, yol tarifini hesaplamadan önce bu adreslerin coğrafi kodlamasını yapmak için Geocoding API ile aynı arka ucu kullanır. Bu, enlng'ler veya yer kimlikleriyle aynı konumları belirtmeye kıyasla gecikmeyi önemli ölçüde artırır.
Uygulamanız, kullanıcı girişine yanıt vermek gibi gecikmeye duyarlı bir durumda Directions API'yi veya Uzaklık Matrisi API'sini kullanıyorsa ve başlangıç noktalarınız, varış noktalarınız veya ara noktalarınız başlangıçta adres dizesi olarak belirtiliyorsa adres dizelerini yer kimliklerine dönüştürmek için Places API'nin Place Autocomplete hizmetini kullanarak gecikmeyi en aza indirmenizi öneririz. Ardından, yer kimliklerini Directions API'ye veya Uzaklık Matris API'sine geçirin. Android, iOS, JavaScript ve Places API için Otomatik Yer Tamamlama hizmeti hakkında daha fazla bilgi edinin. Yer otomatik tamamlama ve yol tarifleri JavaScript örneğine de bakın.
Sonuç
Kullanım alanınıza bağlı olarak, adreslerin coğrafi kodlamasını yaparken Coğrafi Kodlama API'sini veya Otomatik Yer Tamamlama hizmetini Coğrafi Kodlama API'siyle birlikte kullanmak, kullanıcılara doğru coğrafi kodlama sonuçları ve daha düşük gecikme sunan uygulamalar oluşturmanıza olanak tanır.
Hataları ve yeniden denemeleri yönetme
UNKNOWN_ERROR yanıtları alırsanız bunların nedeni geçici hatalardır ve kısa bir gecikmeden sonra yeniden denemek en iyi yöntemdir. Yeniden deneme mantığı içeren ve Google Haritalar Platformu Premium Plan kimlik doğrulamasını destekleyen Google Haritalar Platformu web hizmetleri
istemci kitaplıklarından yararlanmanızı öneririz.
Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi, topluluk tarafından desteklenen istemci kitaplıklarıdır. GitHub'dan indirilebilir ve katkıda bulunabilirsiniz. Burada kurulum talimatlarını ve örnek kodu da bulabilirsiniz.