Coğrafi Kodlama API'sine genel bakış

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Geocoding API; bir yeri adres, enlem ve boylam koordinatları veya yer kimliği olarak kabul eden bir hizmettir. Adresi enlem ve boylam koordinatları ile bir yer kimliğine dönüştürür veya enlem ve boylam koordinatlarını ya da bir yer kimliğini adrese dönüştürür.

Geocoding API ile yapabilecekleriniz

Geocoding API'yi kullanarak bir veya daha fazla adres ya da yer için coğrafi kodlama verileri elde edebilirsiniz. Bu veriler arasında şunlar yer alır:

  • Adreslerin coğrafi koordinatları.
  • Enlem ve boylam koordinat kümelerinin adresleri.
  • Yer kimliklerinin adresleri.

Sonuçların nerede görüneceğini kontrol edebilir ve sonuçları belirli bir bölge, ilçe veya posta koduyla sınırlayabilirsiniz.

Geocoding API'nin işleyiş şekli

Geocoding API hem coğrafi kodlama hem de tersine coğrafi kodlama yapar:

  • Coğrafi kodlama: "1600 Amphitheatre Parkway, Mountain View, CA" gibi adresleri enlem ve boylam koordinatlarına veya yer kimliklerine dönüştürür. Bu koordinatları, haritaya işaretçi yerleştirmek veya haritayı görüntüleme çerçevesinde ortalamak ya da yeniden konumlandırmak için kullanabilirsiniz.
  • Tersine coğrafi kodlama: Enlem/boylam koordinatlarını veya yer kimliğini, kullanıcıların okuyabileceği bir adrese dönüştürür. Adresleri, teslimat veya teslim alma gibi çeşitli senaryolar için kullanabilirsiniz.

Aşağıdaki demoda, Geocoding API'nin nasıl çalıştığını göstermek için Maps JavaScript API üzerinden Geocoding Hizmeti kullanılmaktadır. Daha fazla seçenek ve ayrıntı görmek için haritayı ayrı bir sekmede açın.

Kaynaklar

Aşağıdaki tabloda, Geocoding API aracılığıyla kullanılabilen kaynaklar ve her yöntemin döndürdüğü veriler özetlenmiştir.

Veri kaynakları Döndürülen veriler Dönüş biçimi
Coğrafi kodlama Adresi, adres bileşenlerini ve adres türlerini döndürür. Coğrafi kodlama isteği ve yanıtı kılavuzundaki Sonuçlar bölümüne bakın.
  • JSON
  • XML
Tersine coğrafi kodlama Adresi, adres bileşenlerini ve adres türlerini döndürür. Tersine coğrafi kodlama isteği ve yanıtı kılavuzundaki Tersine coğrafi kodlama yanıtları bölümüne bakın.
Yer coğrafi kodlaması Adresi, adres bileşenlerini ve adres türlerini döndürür. Yer coğrafi kodlama isteği ve yanıtı kılavuzundaki Tersine coğrafi kodlama yanıtları bölümüne bakın.

Geocoding API'yi kullanma

1 Kurulum yapın. Google Cloud projenizi ayarlama ile başlayın ve sonraki kurulum talimatlarını tamamlayın.
2 Coğrafi kodlama isteği gönderme API anahtarınız olduğunda Geocoding API'yi doğrudan curl veya tarayıcıdan test etmeye başlayabilirsiniz. Adres veya bileşen aramaları için doğru arama parametrelerini sağlamanız gerekir. Ayrıntılar için Coğrafi kodlama parametreleri bölümüne bakın.
3 Tersine coğrafi kodlama isteği gönderme Enlem/boylam koordinatlarını API anahtarınızla birlikte göndererek ilgili konumun en yakın okunabilir adresinin adres bileşenlerini alabilirsiniz. Ayrıntılar için Tersine coğrafi kodlama istekleri başlıklı makaleyi inceleyin.
4 Yanıtlarla ilgili temel bilgileri anlama Geocoding API'deki tüm yöntemler, JSON veya XML biçiminde aynı verileri döndürür. Veriler, durum kodları ve hata mesajlarının açıklaması için Coğrafi kodlama yanıtları bölümüne bakın.
5 Coğrafi kodlama verilerini kendi uygulamanıza ekleyin. Harita işaretçilerinden adres almak veya bilinen bir adrese göre haritaya işaretçi eklemek için coğrafi kodlama verilerini kullanabilirsiniz.

Kullanılabilir istemci kitaplıkları

Bu API'yi, aşağıdaki istemci kitaplıklarından biri aracılığıyla istediğiniz dilde çağırabilirsiniz:

Google Haritalar Hizmetleri için Java İstemci Kitaplığı, Python İstemci Kitaplığı, Go İstemci Kitaplığı ve Node.js İstemci Kitaplığı, Apache 2.0 Lisansı kapsamında açık kaynaklı olan, topluluk destekli istemci kitaplıklarıdır. Bu kitaplıkları GitHub'dan indirebilirsiniz. Kurulum talimatlarını ve örnek kodu da GitHub'da bulabilirsiniz.

Sırada ne var?