Geocoding API v4, adreslerin ve yer kimliklerinin coğrafi kodlamasını, tersine coğrafi kodlamasını ve hedef bilgilerini sağlayan bir hizmettir.
Coğrafi kodlama, adresleri (ör. açık adres) harita üzerinde işaretçi yerleştirmek veya haritayı konumlandırmak için kullanabileceğiniz coğrafi koordinatlara (ör. enlem ve boylam) dönüştürme işlemidir.
Tersine coğrafi kodlama, coğrafi koordinatları kullanıcı tarafından okunabilir bir adrese dönüştürme işlemidir.
Belirli bir yer kimliğinin adresini bulmak için Coğrafi Kodlama 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 isteklerinin örnekleri 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ı isteniyor ve çıkışın JSON biçiminde olması gerektiği belirtiliyor.
curl -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
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 enlemi ve boylamı yer alıyor.
Geliştirici kılavuzunu inceleyerek 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 coğrafi kodlama yanıtı verilmiştir:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ", "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ", "location": { "latitude": 37.4438238, "longitude": -122.0869895 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.4424748197085, "longitude": -122.0883384802915 }, "high": { "latitude": 37.445172780291493, "longitude": -122.08564051970852 } }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043-1351", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] }, { "longText": "1351", "shortText": "1351", "types": [ "postal_code_suffix" ] } ], "types": [ "premise", "street_address" ] } ] }
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 isteniyor. Çıkışın JSON biçiminde olması gerektiğini belirtir.
https://geocode.googleapis.com/v4beta/geocode/location/37.4225508,-122.0846338?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 kullanıcı tarafından 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:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "location": { "latitude": 37.4225657, "longitude": -122.08465439999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.421214719708509, "longitude": -122.08603273029148 }, "high": { "latitude": 37.423912680291508, "longitude": -122.0833347697085 } }, "bounds": { "low": { "latitude": 37.4225178, "longitude": -122.08484599999998 }, "high": { "latitude": 37.422609600000008, "longitude": -122.0845215 } }, "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "Google Building 40", "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "Google Building 40", "shortText": "Google Building 40", "types": [ "premise" ], "languageCode": "en" }, { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] } ], "types": [ "street_address", "subpremise" ] }, ... Additional results truncated in this example[] ... }
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 kimlik bilgilerini almanız 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 edinmek için kullanım ve faturalandırma sayfasını inceleyin.
Politikalar
Geocoding API'nin kullanımı API politikalarına uygun olmalıdır.