Geocode API'ye 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 Yer Kimliği'ne dönüştürür, 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 istiyorsanız web sitesi veya mobil uygulama için Geocoding API'yi kullanın. Coğrafi Kodlama API'sı sayesinde, bir 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 bir haritaya yerleştirilmesi için önceden tanımlanmış, statik adreslere coğrafi kodlama uygulanması amacıyla tasarlanmıştır.

Geocoding API 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:

  • Adresler için coğrafi koordinatlar.
  • Enlem ve boylam koordinatlarının adresleri.
  • Yer kimliklerinin adresleri.

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

Geocoding API'nin işleyiş şekli

Geocoding API, hem coğrafi kodlama hem de ters 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ı, bir haritaya işaretleyici yerleştirmek veya haritayı, görüntüleme çerçevesi içinde ortalamak veya yeniden konumlandırmak için kullanabilirsiniz.
  • Ters 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 demo, Geocoding API'nin nasıl çalıştığını göstermek için Maps JavaScript API aracılığıyla Coğrafi Kodlama Hizmeti'ni kullanır. Daha fazla seçenek ve ayrıntı için haritayı ayrı bir sekmede açın.

Kaynaklar

Aşağıdaki tabloda her bir uç noktanın döndürdüğü verilerle birlikte Geocoding API aracılığıyla kullanılabilen kaynaklar özetlenmektedir.

Veri kaynakları Veri döndürüldü 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
Coğrafi kodlamanın tersi Adresi, adres bileşenlerini ve adres türlerini döndürür. Coğrafi coğrafi kodlama isteği ve yanıtı kılavuzundaki Coğrafi kodlama yanıtlarını tersine çevirme başlıklı makaleyi inceleyin.
Coğrafi kodlama Adresi, adres bileşenlerini 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ünü inceleyin.

Geocoding API nasıl kullanılır?

1 Hazırlanın. Google Cloud projenizi ayarlama ile başlayın ve sonraki kurulum talimatlarını uygulayın.
2 Coğrafi kodlama isteğini deneme Bir API anahtarınız olduktan sonra Geocoding API'yi doğrudan cURL 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 Parametrelerde coğrafi kodlama bölümüne bakın.
3 Geri coğrafi kodlama isteği deneyin İlgili konum için okunabilir en yakın adrese yönelik adres bileşenlerini almak üzere API anahtarınızla birlikte enlem/boylam koordinatlarını sağlayın. Ayrıntılar için Coğrafi kodlama isteklerini tersine çevirme konusuna bakın.
4 Yanıtlarla ilgili temel bilgileri anlama Geocoding API'deki tüm uç noktalar, JSON veya XML'de aynı verileri döndürür. Veriler, durum kodları ve hata mesajlarının açıklaması için Yanıtları coğrafi kodlama bölümüne bakın.
5 Coğrafi kodlama verilerini kendi uygulamanıza dahil edin. Harita işaretçilerinden adres almak veya bilinen bir adresi temel alarak bir haritadaki işaretçileri 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:

Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi, Apache 2.0 Lisansı ile açık kaynaklı, topluluk tarafından desteklenen istemci kitaplıklarıdır. Kurulum talimatlarını ve örnek kodu da bulabileceğiniz GitHub'dan indirin.

Sırada ne var?