توصیفگرهای نشانی شامل اطلاعات اضافی است که به توصیف مکان بااستفاده از نشانگرهای مکانی و مناطق کمک می‌کند. برای کاوش این ویژگی، نسخه نمایشی توصیفگرهای نشانی را بررسی کنید.
پارامترهای اضافی
توصیف‌کننده‌های نشانی را می‌توان بااستفاده از پارامتر extra_computations فعال کرد. برای دریافت توصیفگرهای نشانی در پاسخ، extra_computations=ADDRESS_DESCRIPTORS را در درخواست زمین‌کدیابی
، درخواست زمین‌کدیابی معکوس
، یا درخواست زمین‌کدیابی مکان‌ها
بگنجانید.
مثال در زمین‌کدیابی
عبارت جستجوی زیر حاوی نشانی مکانی در دهلی است:
https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
مثال در زمین‌کدیابی مکان‌ها
پُرسمان زیر حاوی شناسه مکان مکانی در دهلی است:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJyxAX8Bj9DDkRgBfAnBYa66Q&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
مثال در زمین‌کدیابی معکوس
پُرسمان زیر حاوی مقدار طول/عرض جغرافیایی برای مکانی در دهلی است:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
پاسخ
نمونه‌ای از 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" ]
}
]
}
}
در هر شیء address_descriptor دو آرایه وجود دارد: landmarks و
areas. آرایه landmarks حداکثر ۵ نتیجه را شامل می‌شود که براساس ارتباط آن‌ها با درنظر گرفتن نزدیکی به مختصات درخواست‌شده، فراوانی نشانه، و رؤیت‌پذیری آن رتبه‌بندی شده است. هر نتیجه نشانگر حاوی مقادیر زیر است:
-
place_idشناسه مکان نتیجه نشانگر جای معروف است. نمای کلی شناسه مکان را ببینید. display_nameنام نمایشی این مکان دیدنی است و حاویlanguage_codeوtextاست.straight_line_distance_metersفاصله نقطه به نقطه برحسب متر بین مختصات ورودی و نتیجه نشان‌یابی است.travel_distance_metersفاصله برحسب متر است که ازطریق شبکه جاده‌ای (با نادیده گرفتن محدودیت‌های جاده‌ای) بین مختصات ورودی و نتیجه نشانگرها طی شده است.-
spatial_relationshipرابطه تخمینی بین مختصات ورودی و نتیجه مکان‌های دیدنی است: "NEAR"رابطه پیش‌فرض است وقتی هیچ‌کدام از موارد زیر اعمال نشود."WITHIN"وقتی مختصات ورودی در محدوده ساختار مرتبط با نشانگر مکان قرار دارد."BESIDE"وقتی مختصات ورودی مستقیماً در مجاورت مکان دیدنی یا نقطه دسترسی مکان دیدنی باشد."ACROSS_THE_ROAD"وقتی مختصات ورودی دقیقاً در مقابل نقطه عطف در طرف دیگر مسیر باشد."DOWN_THE_ROAD"وقتی مختصات ورودی در امتداد همان مسیر نشانگر است، اما"BESIDES"یا"ACROSS_THE_ROAD"نیست."AROUND_THE_CORNER"وقتی مختصات ورودی درطول مسیری عمود بر مکان دیدنی باشد (محدود به یک گردش)."BEHIND"وقتی مختصات ورودی ازنظر فضایی به مکان دیدنی نزدیک است، اما از نقطه دسترسی آن دور است.-
typesانواع مکان این نقطه عطف است.
شیء areas حداکثر ۳ پاسخ دارد و خود را به مکان‌هایی محدود می‌کند که
مناطق کوچک، مانند محله‌ها، زیرمحله‌ها، و مجتمع‌های بزرگ را
نشان می‌دهند. مناطقی که حاوی مختصات درخواستی هستند ابتدا فهرست می‌شوند و
از کوچک‌ترین به بزرگ‌ترین مرتب می‌شوند. هر نتیجه areas حاوی مقادیر زیر است:
-
place_idشناسه مکان نتیجه مناطق است. نمای کلی شناسه مکان را ببینید. -
display_nameنام نمایشی منطقه است و شاملlanguage_codeوtextمی‌شود. -
containmentرابطه تخمینی بین مختصات ورودی و نتیجه مناطق است: "NEAR"رابطه پیش‌فرض است وقتی هیچ‌کدام از موارد زیر اعمال نشود."WITHIN"وقتی مختصات ورودی نزدیک به مرکز منطقه باشد."OUTSKIRTS"وقتی مختصات ورودی نزدیک به لبه منطقه باشد.
پوشش
توصیف‌کننده‌های نشانی در همه مناطق دردسترس است. برای جزئیات، پوشش منطقه‌ای را ببینید.
بازخورد
این ویژگی در همه مناطق دردسترس است و در مرحله «دردسترس عموم» برای هند و در مرحله راه‌اندازی «آزمایشی پیش‌از دردسترس عموم» برای همه مناطق دیگر قرار دارد. از بازخورد شما استقبال می‌کنیم. لطفاً اشکالی را در ردیاب مشکل ثبت کنید.