درخواست و پاسخ توصیفگرهای آدرس

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

توصیف‌گرهای آدرس شامل اطلاعات اضافی هستند که به توصیف یک مکان با استفاده از علائم و مناطق کمک می‌کنند. برای بررسی این ویژگی ، نسخه آزمایشی توصیف‌گرهای آدرس را بررسی کنید.

پارامترهای اضافی

توصیف‌گرهای آدرس را می‌توان با استفاده از پارامتر 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 برای ما ایمیل بفرستید.