Geocoding API, adreslerin coğrafi kodlamasını ve tersine coğrafi kodlamasını sağlayan bir hizmettir.
Coğrafi kodlama, adresleri (ör. sokak adresi) coğrafi koordinatlara (ör. enlem ve boylam) dönüştürme işlemidir. Bu koordinatları, haritaya işaretçi yerleştirmek veya haritayı konumlandırmak için kullanabilirsiniz.
Ters coğrafi kodlama, coğrafi koordinatların okunabilir bir adrese dönüştürülmesi işlemidir.
Belirli bir yer kimliğinin adresini bulmak için Geocoding API'sini de kullanabilirsiniz.
Örnek istek ve yanıt
Geocoding API'ye bir HTTP arayüzü üzerinden erişirsiniz. Aşağıda, coğrafi kodlama ve tersine coğrafi kodlama istekleriyle ilgili örnekler verilmiştir.
Coğrafi kodlama isteği ve yanıtı (enlem/boylam araması)
Aşağıdaki örnekte "1600 Amphitheatre Parkway, Mountain View, CA" adresinin enlem ve boylamı istenmekte ve çıkışın JSON biçiminde olması gerektiği belirtilmektedir.
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
URL'yi web tarayıcınıza girerek bunu test edebilirsiniz (YOUR_API_KEY kısmını gerçek API anahtarınızla değiştirdiğinizden emin olun).
Yanıtta adresin enlem ve boylam bilgileri yer alır.
Geliştirici kılavuzunu inceleyerek coğrafi kodlama isteği URL'leri oluşturma ve kullanılabilir parametreler hakkında daha fazla bilgi edinin ve yanıtı anlama hakkında bilgi edinin.
Aşağıda, JSON biçiminde örnek bir coğrafi kodlama yanıtı verilmiştir:
{ "results" : [ { "address_components" : [ { "long_name" : "1600", "short_name" : "1600", "types" : [ "street_number" ] }, { "long_name" : "Amphitheatre Parkway", "short_name" : "Amphitheatre Pkwy", "types" : [ "route" ] }, { "long_name" : "Mountain View", "short_name" : "Mountain View", "types" : [ "locality", "political" ] }, { "long_name" : "Santa Clara County", "short_name" : "Santa Clara County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "California", "short_name" : "CA", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "94043", "short_name" : "94043", "types" : [ "postal_code" ] } ], "formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "geometry" : { "location" : { "lat" : 37.4267861, "lng" : -122.0806032 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 37.4281350802915, "lng" : -122.0792542197085 }, "southwest" : { "lat" : 37.4254371197085, "lng" : -122.0819521802915 } } }, "place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE", "plus_code" : { "compound_code" : "CWC8+R3 Mountain View, California, United States", "global_code" : "849VCWC8+R3" }, "types" : [ "street_address" ] } ], "status" : "OK" }
Tersine coğrafi kodlama isteği ve yanıtı (adres arama)
Aşağıdaki örnekte, Brooklyn, NY, ABD'de belirli bir enlem/boylama karşılık gelen adres istenmektedir. Çıkışın JSON biçiminde olması gerektiğini belirtir.
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEYURL'yi web tarayıcınıza girerek bunu test edebilirsiniz ("YOUR_API_KEY" yerine gerçek API anahtarınızı girdiğinizden emin olun). Yanıtta, enlem ve boylam konumunun okunabilir adresi yer alıyor.
Geliştirici kılavuzunu inceleyerek ters coğrafi kodlama isteği URL'leri oluşturma, kullanılabilir parametreler ve yanıtı anlama hakkında daha fazla bilgi edinin.
Aşağıda, JSON biçiminde bir örnek ters coğrafi kodlama yanıtı verilmiştir:
{ "plus_code" : { "compound_code" : "P27Q+MC New York, NY, USA", "global_code" : "87G8P27Q+MC" }, "results" : [ { "address_components" : [ { "long_name" : "279", "short_name" : "279", "types" : [ "street_number" ] }, { "long_name" : "Bedford Avenue", "short_name" : "Bedford Ave", "types" : [ "route" ] }, { "long_name" : "Williamsburg", "short_name" : "Williamsburg", "types" : [ "neighborhood", "political" ] }, { "long_name" : "Brooklyn", "short_name" : "Brooklyn", "types" : [ "political", "sublocality", "sublocality_level_1" ] }, { "long_name" : "Kings County", "short_name" : "Kings County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "New York", "short_name" : "NY", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "11211", "short_name" : "11211", "types" : [ "postal_code" ] } ], "formatted_address" : "279 Bedford Ave, Brooklyn, NY 11211, USA", "geometry" : { "location" : { "lat" : 40.7142484, "lng" : -73.9614103 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 40.71559738029149, "lng" : -73.9600613197085 }, "southwest" : { "lat" : 40.71289941970849, "lng" : -73.96275928029151 } } }, "place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE", "plus_code" : { "compound_code" : "P27Q+MC Brooklyn, New York, United States", "global_code" : "87G8P27Q+MC" }, "types" : [ "bakery", "cafe", "establishment", "food", "point_of_interest", "store" ] }, ... Additional results truncated in this example[] ... ], "status" : "OK" }
İstemci kitaplıklarımızla kodlamaya başlayın
İstemci kitaplıkları, kimlik doğrulama, istek sınırlama ve otomatik yeniden deneme gibi yaygın görevlerin yerleşik uygulamalarını sağlayarak Google Haritalar web hizmeti API'leriyle geliştirme yapmanıza yardımcı olur. Geocoding API, Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi'nde kullanılabilir.
Kimlik doğrulama, kotalar, fiyatlandırma ve politikalar
Kimlik doğrulama
Geocoding API'yi kullanmak için önce API'yi etkinleştirmeniz ve uygun kimlik doğrulama bilgilerini edinmeniz gerekir. Daha fazla bilgi için Google Haritalar Platformu'nu kullanmaya başlama başlıklı makaleyi inceleyin.
Kotalar ve fiyatlandırma
Geocoding API için belirlenen kotalar ve fiyatlandırma hakkında ayrıntılı bilgi için kullanım ve faturalandırma sayfasını inceleyin.
Politikalar
Geocoding API'nin kullanımı API politikalarına uygun olmalıdır.
Daha fazla bilgi
Geocoding API ile yapabilecekleriniz bunlarla sınırlı değil. Ek demolar, örnekler, kullanılabilir parametreler, durum kodları ve hata mesajları ile diğer ayrıntılar için Geocoding API geliştirici kılavuzuna bakın.
Geocoding API geliştirici kılavuzunda Geocoding API web hizmeti açıklanmaktadır. Google Haritalar Platformu API'lerinden biri tarafından sağlanan haritalarda coğrafi kodlama verilerini kullanmak isteyen web sitesi ve mobil uygulama geliştiricileri için tasarlanmıştır.