Geocoding API v4, adreslerin ve yer kimliklerinin coğrafi kodlamasını, ters coğrafi kodlamasını ve hedef bilgilerini sağlayan bir hizmettir.
Coğrafi kodlama, adresleri (ör. sokak adresi) haritada 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.
Ayrıca, belirli bir yer kimliğinin adresini bulmak ve SearchDestinations yöntemini kullanarak çeşitli hedefler hakkında ayrıntılı bilgi almak için Geocoding API'yi de kullanabilirsiniz.
Örnek istek ve yanıt
Geocoding API'ye bir HTTP arayüzü üzerinden erişirsiniz. Aşağıda, coğrafi kodlama ve ters coğrafi kodlama isteklerine örnekler verilmiştir.
Coğrafi kodlama isteği ve yanıtı (enlem/boylam arama)
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/v4/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 örnek bir 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" ] } ] }
Ters 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/v4/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 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 örnek bir tersine 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'sini kullanmak için önce API'yi etkinleştirmeniz ve uygun kimlik doğrulama bilgileri 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.