Geocoding API, coğrafi kodlama ve tersine coğrafi kodlama sağlayan bir hizmettir. sayısı.
Coğrafi kodlama, adresleri (ör. açık adres) dönüştürme işlemidir koordinatlar (enlem ve boylam gibi) halinde gösterilir. konumlandırabilir veya haritayı konumlandırabilirsiniz.
Ters coğrafi kodlama, coğrafi koordinatları dönüştürme işlemidir bir adrese dönüştürülebilir.
Bir web sitesinin adresini bulmak için Geocoding API'yi de yer kimliği verilir.
Örnek istek ve yanıt
Geocoding API'ye bir HTTP arayüzü üzerinden erişirsiniz. Takip edilenler coğrafi kodlama ve ters coğrafi kodlama isteklerine örnek olarak verilebilir.
Coğrafi kodlama isteği ve yanıtı (enlem/boylam araması)
Aşağıdaki örnekte "1600 Amphitheatre" enlemi ve boylamı istenmektedir Parkway, Mountain View, CA" ile başlar ve çıkışın JSON biçiminde olması gerektiğini belirtir.
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
Bunu, URL'yi web tarayıcınıza girerek test edebilirsiniz (
YOUR_API_KEY gerçek API anahtarınızla) girin.
Yanıt, adresin enlem ve boylam bilgisini içerir.
Geliştirici kılavuzunu görüntüle ve talep URL'leri oluşturarak ve kullanılabilir parametreler ve daha iyi anlamanızı sağlayın.
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"
}
Coğrafi kodlama isteğini ve yanıtını tersine çevirme (adres arama)
Aşağıdaki örnekte, belirli bir enlem/boylama karşılık gelen adres istenmektedir bir proje yöneticisiyim. Çı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_KEY
Bunu, URL'yi web tarayıcınıza girerek test edebilirsiniz ( "API_ANAHTARINIZ" ifadesini gerçek API anahtarınızla değiştirin). Yanıt, enlem ve boylam için kullanıcıların okuyabileceği bir adres içermelidir konum.
Geliştirici kılavuzunu görüntüle ve tersine coğrafi kodlama istek URL'leri oluşturmak ve kullanılabilir parametreler ve daha iyi anlamanızı sağlayın.
Aşağıda, JSON biçiminde bir tersine coğrafi kodlama yanıtı örneği 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ızı kullanarak kodlamaya başlayın
İstemci kitaplıkları Google Haritalar web hizmeti API'leriyle geliştirmeyi kolaylaştırmak için basit, kimlik doğrulama, istek gönderme gibi yaygın görevlerin yerel otomatik olarak yeniden deneme özelliğini kullanabilirsiniz. Geocoding API kullanıma sunuldu Java İstemcisi, Google Haritalar Hizmetleri için Python İstemcisi, Go İstemcisi ve Node.js İstemcisi.
Kimlik doğrulama, kotalar, fiyatlandırma ve politikalar
Kimlik doğrulama
Coğrafi Kodlama API'sini kullanmak için önce API'yi etkinleştirmeniz gerekir ve doğru kimlik doğrulama bilgilerini alın. Daha fazla bilgi için bkz. Google Haritalar Platformu'nu Kullanmaya Başlama.
Kotalar ve fiyatlandırma
Kullanımı ve faturalandırmayı inceleme sayfasındaki ayrıntılara göz atın.
Politikalar
Coğrafi Kodlama API'sinin kullanımı, API politikaları.
Daha fazla bilgi
Geocoding API ile yapabileceğiniz daha birçok şey var. Bkz. Ek demolar için Coğrafi Kodlama API'si geliştirici kılavuzu, örnekler, kullanılabilir parametreler, durum kodları, hata mesajları ve diğer ayrıntılar.
Coğrafi Kodlama API'si geliştirici kılavuzunda, Geocoding API web hizmeti. Web sitesi ve mobil uygulama geliştiricileri içindir Google Haritalar Platformu'ndan biri tarafından sağlanan haritalarda coğrafi kodlama verilerini kullanmak isteyen API'ler.