Adres tanımlayıcılar, önemli noktaları ve alanları 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. Yanıtınızda adres tanımlayıcıları almak için coğrafi kodlama isteğine
, tersine coğrafi kodlama isteğine
veya yerler coğrafi kodlama isteğine
extra_computations=ADDRESS_DESCRIPTORS parametresini ekleyin.
Coğrafi kodlama örneği
Aşağıdaki sorgu, Delhi'deki bir yerin adresini içeriyor:
https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Yerlerin coğrafi kodlamasıyla ilgili örnek
Aşağıdaki sorgu, Delhi'deki bir yerin 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
Örnek bir address_descriptor şu şekildedir:
{
"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, 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 yerler sonucunun yer kimliğidir. Yer kimliğine genel bakış bölümünü inceleyin.display_name, önemli noktanın görünen adıdır velanguage_codeiletextdeğerlerini içerir.straight_line_distance_meters, giriş koordinatı ile önemli nokta sonucu arasındaki metre cinsinden noktadan noktaya mesafedir.travel_distance_meters, giriş koordinatı ile önemli nokta sonucu arasında yol ağı üzerinden (yol kısıtlamaları dikkate alınmadan) kat edilen mesafeyi metre cinsinden gösterir.spatial_relationship, giriş koordinatı ile önemli nokta sonucu arasındaki tahmini ilişkidir:- Aşağıdakilerden 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". "BESIDE"(giriş koordinatı, önemli noktaya veya önemli noktanın erişim noktasına doğrudan bitişik olduğunda)."ACROSS_THE_ROAD", giriş koordinatı rotanın diğer tarafındaki önemli noktanın tam karşısındaysa."DOWN_THE_ROAD", giriş koordinatı önemli yerle aynı rota üzerindeyse kullanılır."BESIDES"veya"ACROSS_THE_ROAD"kullanılmaz.- Giriş koordinatı, önemli nokta ile dikey bir rota üzerindeyse (tek bir dönüşle sınırlı)
"AROUND_THE_CORNER". "BEHIND", giriş koordinatı önemli noktaya mekansal olarak yakın ancak erişim noktasına uzak olduğunda.types, önemli noktanın yer türleridir.
areas nesnesi en fazla 3 yanıt içerir ve kendisini mahalleler, alt yerleşim yerleri ve büyük kompleksler gibi küçük bölgeleri temsil eden yerlerle sınırlar. İ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, alanlar sonucunun yer kimliğidir. Yer kimliğine genel bakış bölümünü inceleyin.display_name, alanın görünen adıdır velanguage_codeiletextdeğerlerini içerir.containment, giriş koordinatı ile alan sonucu arasındaki tahmini kapsama ilişkisidir:- 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". "OUTSKIRTS", giriş koordinatı alanın kenarına yakın olduğunda.
Kapsam
Adres tanımlayıcılar tüm bölgelerde kullanılabilir. Ayrıntılar için bölge kapsamı bölümüne bakın.
Geri bildirim
Bu özellik tüm bölgelerde kullanılabilir. Hindistan'da GKST'ye sunulmuştur. Diğer tüm bölgelerde ise GKST öncesi deneysel lansman aşamasındadır. Geri bildirimlerinizi bekliyoruz. Lütfen Issue Tracker'da hata bildiriminde bulunun.