توصیف‌کننده‌های نشانی شامل اطلاعات اضافی است که به توصیف مکان بااستفاده از نشانگرهای مکانی و مناطق کمک می‌کند. برای کاوش این ویژگی، نسخه نمایشی توصیف‌کننده‌های نشانی را بررسی کنید.
پارامترهای اضافی
توصیف‌کننده‌های نشانی را می‌توان بااستفاده از پارامتر 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"وقتی مختصات ورودی نزدیک به لبه منطقه باشد.
پوشش
توصیف‌کننده‌های نشانی در همه مناطق دردسترس است. برای جزئیات، پوشش منطقه‌ای را ببینید.
بازخورد
این ویژگی در همه مناطق دردسترس است و در مرحله «دردسترس عموم» برای هند و در مرحله راه‌اندازی «آزمایشی پیش‌از دردسترس عموم» برای همه مناطق دیگر قرار دارد. از بازخورد شما قدردانی می‌کنیم. لطفاً اشکالی را در ردیاب مشکل ثبت کنید.