توصیفگرهای آدرس شامل اطلاعات اضافی است که به توصیف یک مکان با استفاده از نشانهها و مناطق کمک میکند. برای بررسی این ویژگی ، نسخه ی نمایشی توصیفگر آدرس را بررسی کنید.
پارامترهای اضافی
توصیف کننده های آدرس را می توان با استفاده از پارامتر 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 شامل حداکثر 5 نتیجه است که به ترتیب مرتبط با در نظر گرفتن نزدیکی به مختصات درخواستی، شیوع نقطه عطف و قابلیت مشاهده آن رتبهبندی شدهاند. هر نتیجه مشخصه حاوی مقادیر زیر است:
-
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 دارای حداکثر 3 پاسخ است و خود را محدود به مکان هایی می کند که مناطق کوچک را نشان می دهد، مانند همسایگی ها، مناطق فرعی و مجتمع های بزرگ. مناطقی که حاوی مختصات درخواستی هستند ابتدا فهرست شده و از کوچکترین به بزرگتر مرتب می شوند. نتیجه هر areas حاوی مقادیر زیر است:
-
place_idشناسه مکان نتایج مناطق است. نمای کلی شناسه مکان را ببینید. -
display_nameنام نمایشی منطقه است و حاویlanguage_codeوtextاست. -
containmentرابطه محفظه تخمینی بین مختصات ورودی و ناحیه حاصل است: -
"NEAR"رابطه پیشفرض زمانی است که هیچ یک از موارد زیر اعمال نمیشود. - زمانی که مختصات ورودی نزدیک به مرکز منطقه باشد،
"WITHIN". - زمانی که مختصات ورودی نزدیک به لبه ناحیه باشد،
"OUTSKIRTS".
پوشش
توصیفگرهای آدرس در همه مناطق موجود است. برای جزئیات بیشتر به پوشش منطقه مراجعه کنید.
بازخورد
این ویژگی در همه مناطق در دسترس است و در GA برای هند و در مرحله راه اندازی آزمایشی قبل از GA برای همه مناطق دیگر است. ما از بازخورد قدردانی خواهیم کرد. لطفاً به آدرس address-descriptors-feedback@google.com ایمیل بزنید.