Coğrafi Kodlama API'sine genel bakış

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 dönüştürür veya enlem ve boylam koordinatlarını veya Yer Kimliği'ni adrese dönüştürür.

Geocoding API'yi 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'yi kullanın. Geocoding API ile, adresleri bir haritaya işaretçi yerleştirmek veya haritadaki bir işaretçiyi adrese dönüştürmek için kullanırsınız. Bu hizmet, uygulama içeriğinin haritaya yerleştirilmesi için önceden tanımlanmış statik adreslerin coğrafi kodlamasını yapmak amacıyla tasarlanmıştır.

Geocoding API ile yapabilecekleriniz

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

  • Adreslerin coğrafi koordinatları.
  • Enlem ve boylam koordinat grubu adresleri.
  • Yer kimliklerinin adresleri.

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

Geocoding API'nin işleyiş şekli

Coğrafi Kodlama API'si 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. İşaretçileri haritaya yerleştirmek veya görünüm çerçevesi içinde haritayı ortalamak ya da yerini değiştirmek için bu koordinatları kullanabilirsiniz.
  • Ters coğrafi kodlama: Enlem/boylam koordinatlarını veya Yer Kimliği'ni kullanıcılar tarafından okunabilen bir adrese dönüştürür. Adresleri teslimatlar veya teslim almalar 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 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, her uç noktanın döndürdüğü verilerle birlikte Geocoding API aracılığıyla kullanılabilen kaynaklar ö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. İstek ve yanıt için coğrafi kodlama 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. Ters coğrafi kodlama isteği ve yanıtı kılavuzundaki Ters coğrafi kodlama yanıtlarının 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 Ters coğrafi kodlama yanıtlarının bölümünü inceleyin.

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

1 Kurulumu tamamlayın. Google Cloud projenizi oluşturun bölümüne geçin ve sonraki kurulum talimatlarını tamamlayın.
2 Coğrafi kodlama isteğini deneme API anahtarınız olduğunda Geocoding API'yi doğrudan cURL'den veya bir 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 konumda insanlar tarafından okunabilen en yakın adresin adres bileşenlerini elde etmek için API anahtarınızla birlikte enlem/boylam koordinatlarını 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 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ının açıklaması için Yanıtların coğrafi kodlamasını yapma bölümüne bakın.
5 Coğrafi kodlama verilerini kendi uygulamanızda kullanın. Harita işaretçilerinden adres elde etmek veya bilinen bir adrese dayalı haritada işaretçiler sağlamak için coğrafi kodlama verilerini kullanabilirsiniz.

Kullanılabilir istemci kitaplıkları

Aşağıdaki istemci kitaplıklarından biri aracılığıyla 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ı kapsamında açık kaynaklı, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bu uygulamaları GitHub'dan indirin. Burada yükleme talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?