توصیفگرهای آدرس شامل اطلاعات اضافی هستند که به توصیف یک مکان با استفاده از علائم و مناطق کمک میکنند. برای بررسی این ویژگی ، نسخه آزمایشی توصیفگرهای آدرس را بررسی کنید.
پارامترهای اضافی
توصیفگرهای آدرس را میتوان با استفاده از پارامتر extra_computations فعال کرد. برای دریافت توصیفگرهای آدرس در پاسخ خود، extra_computations=ADDRESS_DESCRIPTORS در یک درخواست geocoding ، درخواست geocoding معکوس یا درخواست geocoding مکانها وارد کنید.
مثال در کدگذاری جغرافیایی
عبارت زیر شامل آدرس مکانی در دهلی است:
https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
مثال در مکانهای جغرافیایی
کوئری زیر شامل شناسه مکان (place ID) یک مکان در دهلی است:
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"وقتی مختصات ورودی نزدیک به لبه منطقه باشد.
پوشش
توصیفگرهای آدرس در همه مناطق موجود است. برای جزئیات بیشتر به پوشش منطقه مراجعه کنید.
بازخورد
این ویژگی در همه مناطق موجود است و برای هند در جورجیا و برای سایر مناطق در مرحله راهاندازی آزمایشی قبل از جورجیا است. ما از بازخورد شما قدردانی میکنیم. لطفاً به آدرس address-descriptors-feedback@google.com برای ما ایمیل بفرستید.