Adres tanımlayıcıları, bir konumu açıklamaya yardımcı olan ek bilgiler içerir önemli noktaları ve alanları kullanarak. Adres tanımlayıcılar demosuna göz atın ziyaret edebilirsiniz.
Ek parametreler
Adres tanımlayıcıları, extra_computations
kullanılarak etkinleştirilebilir
parametresinden sonra bir değer girin. extra_computations=ADDRESS_DESCRIPTORS
öğesini bir coğrafi kodlama isteğine dahil edin
, 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
.
Ters coğrafi kodlama örneği
Aşağıdaki sorgu, Türkiye'deki bir konumun enlem/boylam değerini Delhi:
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 bulunur: 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 önemli nokta sonucu
şu değerlere sahiptir:
place_id
, önemli noktalar 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 nokta sonucu arasındaki metre cinsinden nokta-nokta mesafesidir.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 önemli nokta 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 önemli noktanın doğrudan tersi olduğunda
"ACROSS_THE_ROAD"
. - Giriş koordinatı, önemli noktayla aynı rota üzerinde olduğunda ancak
"BESIDES"
veya"ACROSS_THE_ROAD"
olmadığında"DOWN_THE_ROAD"
. - Giriş koordinatı, önemli nokta olarak dikey bir rota üzerinde olduğunda (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
, önemli noktanın 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 şunu içerir:
değerleri:
place_id
, alan sonucunun yer kimliğidir. Yer kimliğini görün genel bakış bölümüne bakın.display_name
, alanın görünen adı oluplanguage_code
iletext
kelimelerini içerir.containment
, giriş koordinatı ile alan sonucu arasındaki tahmini kapsama ilişkisidir:- Aşağıdakilerin 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
Bu özellik yalnızca belirli ülke.
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.