Coğrafi Kodlama API'sine genel bakış

Avrupa Ekonomik Alanı (AEA) geliştiricileri

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

Geocoding API ile yapabilecekleriniz

Aşağıdakiler de dahil olmak üzere bir veya daha fazla adres ya da yer için coğrafi kodlama verileri almak üzere Geocoding API'yi kullanabilirsiniz:

  • Adreslerin coğrafi koordinatları.
  • Enlem ve boylam koordinatları kümeleri için adresler.
  • Yer kimlikleri için adresler.

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ünüm çerçevesi içinde ortalamak ya da yeniden konumlandırmak için kullanabilirsiniz.
  • Tersine coğrafi kodlama: Enlem/boylam koordinatlarını veya yer kimliğini, okunabilir bir adrese dönüştürür. Teslimatlar veya teslim alma işlemleri de dahil olmak üzere çeşitli senaryolarda adresleri kullanabilirsiniz.

Aşağıdaki demoda, Geocoding API'nin nasıl çalıştığını göstermek için Maps JavaScript API aracılığıyla Coğrafi Kodlama 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 uç noktanın 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 kodlama 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 nasıl kullanılır?

1 Ayarları yapın. Google Cloud projenizi ayarlama ile başlayın ve kurulum talimatlarını tamamlayın.
2 Coğrafi kodlama isteğini deneyin 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ğinde bulunmayı deneyin Bu konum için en yakın insan tarafından okunabilir adresin adres bileşenlerini almak üzere API anahtarınızla birlikte enlem/boylam koordinatları sağlayın. Ayrıntılar için Ters coğrafi kodlama istekleri bölümüne bakın.
4 Yanıtlarla ilgili temel bilgileri öğrenme Coğrafi Kodlama API'sindeki tüm uç noktalar, aynı verileri JSON veya XML biçiminde döndürür. Veriler, durum kodları ve hata mesajları hakkında açıklama için Coğrafi kodlama yanıtları başlıklı makaleyi inceleyin.
5 Coğrafi kodlama verilerini kendi uygulamanıza dahil edin. Harita işaretçilerinden adres almak veya bilinen bir adrese göre harita üzerinde işaretçi sağlamak için coğrafi kodlama verilerini kullanabilirsiniz.

Kullanılabilen istemci kitaplıkları

Bu API'yi aşağıdaki istemci kitaplıklarından birini kullanarak tercih ettiğiniz dilde çağırın:

Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi, Apache 2.0 Lisansı kapsamında açık kaynaklı olarak sunulan ve topluluk tarafından desteklenen istemci kitaplıklarıdır. Bu kitaplıkları GitHub'dan indirebilirsiniz. GitHub'da kurulum talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?