Adres tanımlayıcılar, önemli noktaları ve alanları kullanarak bir konumun tanımlanmasına 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. Yanıtınızda adres tanımlayıcıları almak için bir coğrafi kodlama isteğine, ters coğrafi kodlama isteğine veya bir yer coğrafi kodlama isteğine extra_computations=ADDRESS_DESCRIPTORS
ekleyin.
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, 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 bulunur: landmarks
ve areas
. landmarks
dizisi, istenen koordinata yakınlık, önemli noktanın yaygınlığı ve görünürlüğü dikkate alınarak alaka düzeyine göre sıralanmış en fazla 5 sonuç içerir. Her önemli nokta sonucu aşağıdaki değerleri içerir:
place_id
, önemli noktalar sonucunun yer kimliğidir. Yer kimliğine genel bakış sayfasını inceleyin.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, alt konumlar ve büyük kompleksler gibi küçük bölgeleri temsil eden yerlerle sınırlandırır. İstenen koordinatı içeren alanlar ilk sırada listelenir ve en küçükten en büyüğe doğru sıralanır. Her areas
sonucu aşağıdaki değerleri içerir:
place_id
, alan sonucunun yer kimliğidir. Yer kimliğine genel bakış sayfasını inceleyin.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 ülkelerde kullanılabilir.
Geri bildirim
Bu bir Önizleme özelliğidir ve geri bildirimlerinizi almaktan memnuniyet duyarız. Lütfen address-descriptors-feedback@google.com adresinden bize e-posta gönderin.