Coğrafi Kodlama API'sine genel bakış

Coğrafi Kodlama API'si bir yeri adres, enlem ve boylam koordinatları veya Yer Kimliği olarak kabul eden bir hizmettir. Adresi enlem ve boylam koordinatlarına ve yer kimliğine veya enlem ve boylam koordinatlarına ya da yer kimliklerine dönüştürür.

Coğrafi Kodlama API'sini neden kullanmalısınız?

Google Haritalar Platformu API'lerinden biri tarafından sağlanan haritalarda coğrafi kodlama verilerini kullanmak istediğinizde, web sitesi veya mobil uygulama için Geocoding API'den yararlanabilirsiniz. Coğrafi Kodlama API'si ile, haritaya işaretçi yerleştirmek veya haritadaki bir işaretçiyi adrese dönüştürmek için adresleri kullanırsınız. Bu hizmet, uygulama içeriğinin haritalara yerleştirilmesi için önceden tanımlanmış statik adreslerin coğrafi kodlamasını yapmak için tasarlanmıştır.

Coğrafi Kodlama API'si ile neler yapabilirsiniz?

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

  • Adreslerin coğrafi koordinatları.
  • Enlem ve boylam koordinatlarının adresleri.
  • Yer kimliklerine ait adresler.

Sonuçların nerede gösterileceğini kontrol edebilir ve belirli bir bölge, ilçe veya posta koduyla sınırlandırabilirsiniz.

Coğrafi Kodlama API'sinin işleyiş şekli

Coğrafi Kodlama API'si hem coğrafi kodlamayı hem de tersine coğrafi kodlamayı gerçekleştirir:

  • 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ı, bir haritaya işaretçi yerleştirmek veya görünüm çerçevesi içinde ortalamak ya da yeniden konumlandırmak için kullanabilirsiniz.
  • Ters coğrafi kodlama: Enlem/boylam koordinatlarını veya yer kimliğini kullanıcılar tarafından okunabilir bir adrese dönüştürür. Adresleri, teslimat veya teslim alma gibi çeşitli senaryolar için kullanabilirsiniz.

Aşağıdaki demoda, Coğrafi Kodlama API'sinin işleyiş şeklini göstermek için Maps JavaScript API üzerinden 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, Coğrafi Kodlama API'si aracılığıyla kullanılabilen kaynaklar, her uç noktanın döndürdüğü verilerle birlikte özetlenmektedir.

Veri kaynakları Döndürülen veriler İade biçimi
Coğrafi kodlama Adres, adres bileşenleri 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
Ters coğrafi kodlama Adres, adres bileşenleri ve adres türlerini döndürür. Coğrafi kodlama isteği ve yanıtı ters çevirme kılavuzundaki Coğrafi kodlama yanıtlarını tersine çevirme bölümüne bakın.
Yer coğrafi kodlama Adres, adres bileşenleri ve adres türlerini döndürür. Coğrafi kodlama isteği ve yanıtı yerleştirme kılavuzundaki Coğrafi kodlama yanıtlarını tersine çevirme bölümüne bakın.

Coğrafi Kodlama API'si nasıl kullanılır?

1 Hazırlanın. Google Cloud projenizi oluşturma işlemiyle başlayın ve aşağıdaki kurulum talimatlarını tamamlayın.
2 Coğrafi kodlama isteğini deneyin API anahtarınızı oluşturduktan sonra Coğrafi Kodlama API'sini 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 Ters coğrafi kodlama isteğini deneme Söz konusu konum için kullanıcıların okuyabileceği en yakın adres için adres bileşenlerini elde etmek amacıyla 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 anlama Geocoding API'deki tüm uç noktalar JSON veya XML olarak aynı verileri döndürür. Verilerin, durum kodların ve hata mesajlarının açıklaması için Yanıtların coğrafi kodlamasını yapma bölümünü inceleyin.
5 Coğrafi kodlama verilerini kendi uygulamanıza entegre edin. Harita işaretçilerinden adres almak veya bir haritada bilinen bir adrese dayalı işaretçiler sağlamak için coğrafi kodlama verilerini kullanabilirsiniz.

Kullanılabilir istemci kitaplıkları

Aşağıdaki istemci kitaplıklarından birini kullanarak bu API'yi istediğiniz dilde çağırın:

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

Sırada ne var?