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, ters coğrafi kodlama isteğine veya yer coğrafi kodlama isteğine extra_computations=ADDRESS_DESCRIPTORS ekleyin.
Coğrafi kodlamada örnek
Aşağıdaki sorguda Delhi'deki bir yerin adresi var:
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ında örnek
Aşağıdaki sorgu, Delhi'deki bir yerin yer kimliğini içeriyor:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJyxAX8Bj9DDkRgBfAnBYa66Q&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Ters coğrafi kodlamada örnek
Aşağıdaki sorguda, Delhi'deki bir konumun enlem/boylam değeri yer alıyor:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Yanıt
Bir örnek address_descriptor:
{
"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, simgenin 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ış başlıklı makaleyi inceleyin.display_name, önemli yerin görünen adıdır velanguage_codeiletextkarakterlerini içerir.straight_line_distance_meters, giriş koordinatı ile önemli yerler sonucu arasındaki nokta nokta mesafedir (metre cinsinden).travel_distance_meters, giriş koordinatı ile önemli yerler sonucu arasındaki yol ağında (yol kısıtlamaları göz ardı edilerek) gidilen mesafeyi metre cinsinden ifade eder.spatial_relationship, giriş koordinatı ile önemli yerler sonucu arasındaki tahmini ilişkidir:- Aşağıdakilerden hiçbiri geçerli olmadığında varsayılan ilişki
"NEAR"olur. "WITHIN"Giriş koordinatı, belirgin işaretle ilişkili yapının sınırları içinde yer aldığında."BESIDE"Giriş koordinatı, önemli noktanın 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 yer işaretinin tam karşısında olduğunda."DOWN_THE_ROAD"Giriş koordinatı, önemli yerle aynı rota üzerinde olduğunda ancak"BESIDES"veya"ACROSS_THE_ROAD"olmadığında."AROUND_THE_CORNER"Giriş koordinatı, önemli yerle aynı yönde olmayan bir rota üzerindeyken (tek bir dönüşle sınırlıdır)."BEHIND"Giriş koordinatı, önemli yere yakın ancak erişim noktasına uzak olduğundatypes, simge yapının yer türleridir.
areas nesnesi en fazla 3 yanıt içerir ve kendisini mahalleler, alt yerleşim birimleri ve büyük kompleksler gibi küçük bölgeleri temsil eden yerlerle sınırlar. İstenen koordinatı içeren alanlar önce listelenir ve küçükten 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ış başlıklı makaleyi inceleyin.display_name, alanın görünen adıdır velanguage_codeiletext'yi içerir.containment, giriş koordinatı ile alan sonuçları 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ı başlıklı makaleyi inceleyin.
Geri bildirim
Bu özellik tüm bölgelerde kullanılabilir. Hindistan'da GKST'ye sunulmuş olup diğer tüm bölgelerde GKST öncesi Deneysel lansman aşamasındadır. Geri bildirimlerinizi bekliyoruz. Lütfen sorun izleyicide hata bildiriminde bulunun.