Adres tanımlayıcıları, önemli yerleri ve bölgeleri kullanarak bir konumu tanımlamaya yardımcı olan ek bilgiler içerir. Özelliği keşfetmek için adres tanımlayıcıları demosuna göz atın.
Ek parametreler
Adres tanımlayıcıları, extra_computations
parametresi kullanılarak etkinleştirilebilir. Coğrafi kodlama isteğine extra_computations=ADDRESS_DESCRIPTORS
ekleme
, coğrafi kodlama isteğini tersine çevirme
veya yer coğrafi kodlama isteği
ve yanıtınızda adres tanımlayıcıları alabilirsiniz.
Coğrafi kodlama örneği
Aşağıdaki sorgu, Delhi'deki bir yerin adresini içerir:
https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Yer coğrafi kodlamasına örnek
Aşağıdaki sorgu, Delhi'deki bir yerin yer kimliğini içerir:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJyxAX8Bj9DDkRgBfAnBYa66Q&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Tersine coğrafi kodlama örneği
Aşağıdaki sorgu, Delhi'deki bir konumun enlem/boylam değerini içerir:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Yanıt
address_descriptor
için aşağıdaki gibi bir örnek verilebilir:
{
"address_descriptor" : {
"areas" : [
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Turkman Gate"
},
"place_id" : "ChIJ_7LLvyb9DDkRMKKxP9YyXgs"
},
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Chandni Chowk"
},
"place_id" : "ChIJWcXciBr9DDkRUb4dCDykTwI"
},
{
"containment" : "NEAR",
"display_name" : {
"language_code" : "en",
"text" : "Katar Ganj"
},
"place_id" : "ChIJH3cWUyH9DDkRaw-9CjvcRvY"
}
],
"landmarks" : [
{
"display_name" : {
"language_code" : "en",
"text" : "Delite Cinema"
},
"straight_line_distance_meters" : 29.9306755065918,
"place_id" : "ChIJLfiYDCT9DDkROoEa7NdupUM",
"travel_distance_meters" : 418.7794799804688,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "establishment", "movie_theater", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "YES Bank"
},
"straight_line_distance_meters" : 66.83731079101562,
"place_id" : "ChIJFYHM3yb9DDkRRKGkZl2mpSQ",
"travel_distance_meters" : 489.0340270996094,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "UCO Bank"
},
"straight_line_distance_meters" : 25.38849639892578,
"place_id" : "ChIJ-c6_wCb9DDkRjIk1LeqRtGM",
"travel_distance_meters" : 403.2246398925781,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "atm", "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Delhi By Cycle Meeting Point"
},
"straight_line_distance_meters" : 44.02867126464844,
"place_id" : "ChIJNxVfkSb9DDkRJD22l-eGFdM",
"travel_distance_meters" : 97.41281890869141,
"spatial_relationship" : "AROUND_THE_CORNER",
"types" : [
"establishment",
"point_of_interest",
"tourist_attraction",
"travel_agency"
]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Axis Bank Branch"
},
"straight_line_distance_meters" : 102.3495178222656,
"place_id" : "ChIJr3uaDCT9DDkR8roHTVSn1x4",
"travel_distance_meters" : 330.8566284179688,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
}
]
}
}
Her address_descriptor
nesnesinde iki dizi vardır: landmarks
ve areas
. landmarks
dizisi, aşağıdaki sıralamaya göre sıralanmış en fazla 5 sonuç içerir:
istenen koordinata yakınlık dikkate alınarak,
ve görünürlüğü. Her bir önemli yer sonucu aşağıdaki değerleri içerir:
place_id
, önemli yerler sonucunun yer kimliğidir. Yer kimliğini görün genel bakış bölümüne bakın.display_name
, önemli noktanın görünen adı oluplanguage_code
iletext
kelimelerini içerir.straight_line_distance_meters
, giriş koordinatı ile önemli yerler sonucu arasındaki noktadan noktaya mesafedir (metre cinsinden).travel_distance_meters
, yol ağında (yol kısıtlamaları yok sayılarak) giriş koordinatı ile önemli nokta sonucu arasındaki katedilen mesafedir.spatial_relationship
, giriş koordinatı ile yer işaretleri sonucu arasındaki tahmini ilişkidir:- Aşağıdakilerin hiçbiri geçerli olmadığında varsayılan ilişki
"NEAR"
olur. - Giriş koordinatı, önemli noktayla ilişkili yapının sınırları içinde olduğunda
"WITHIN"
. - Giriş koordinatı, önemli noktanın veya önemli noktanın erişim noktasının hemen bitişiğinde olduğunda
"BESIDE"
. - Giriş koordinatı, rotanın diğer tarafındaki yer işaretinin tam karşısında olduğunda
"ACROSS_THE_ROAD"
. - Giriş koordinatı yer işaretiyle aynı rota üzerindeyse ancak
"BESIDES"
veya"ACROSS_THE_ROAD"
değilse"DOWN_THE_ROAD"
. - Giriş koordinatı, yer işareti olarak dik bir rota üzerindeyse (tek bir dönüşle sınırlıdır)
"AROUND_THE_CORNER"
. - Giriş koordinatı, yer işaretine yakın, ancak erişim noktasından uzak olduğunda
"BEHIND"
. types
, yer işaretinin yer türleridir.
areas
nesnesi en fazla 3 yanıt içerir ve kendisini
mahalleler, semtler ve büyük mahalleler gibi küçük bölgeleri
kompleksler. İstenen koordinatı içeren bölgeler listenin başında ve
en küçükten en büyüğe doğru sıralanır. Her areas
sonucu şunları içerir
değerleri:
place_id
, alan sonucunun yer kimliğidir. Yer kimliğine genel bakış başlıklı makaleyi inceleyin.display_name
, alanın görünen adıdır velanguage_code
iletext
içerir.containment
, giriş koordinatı ile alanlar sonucu arasındaki tahmini kapsayıcı ilişkidir:- Aşağıdakilerden hiçbiri geçerli olmadığında varsayılan ilişki
"NEAR"
olur. - Giriş koordinatı alanın merkezine yakın olduğunda
"WITHIN"
. - Giriş koordinatı alanın kenarına yakın olduğunda
"OUTSKIRTS"
.
Kapsam
Adres tanımlayıcıları tüm bölgelerde kullanılabilir. Görüntüleyin bölge konusunu inceleyin.
Geri bildirim
Bu bir Önizleme özelliğidir ve geri bildirimlerinizi almaktan memnuniyet duyarız. Lütfen e-posta gönderin address-descriptors-feedback@google.com adresinden bize ulaşın.