نقاط ناوبری

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

فیلد navigation_points در پاسخ Geocoding شامل فهرستی از نقاطی است که برای پیمایش به آن مکان مفید هستند. به طور خاص، آنها باید هنگام مسیریابی در یک شبکه جاده‌ای از یا به آن مکان، به عنوان نقاط شروع یا پایان استفاده شوند. هر نقطه ناوبری شامل مقادیر زیر است:

  • location شامل مقادیر طول و عرض جغرافیایی نقطه ناوبری است. این مکان همیشه بسیار نزدیک به شبکه جاده‌ای خواهد بود و نشان دهنده یک نقطه توقف یا شروع ایده‌آل برای ناوبری به/از یک مکان است. این نقطه عمداً کمی از خط مرکزی جاده انحراف دارد تا به وضوح سمت جاده‌ای که مکان در آن قرار دارد را مشخص کند.
  • restricted_travel_modes فهرستی از حالت‌های سفر است که نقطه ناوبری از آنها قابل دسترسی نیست:
    • "DRIVE" حالت سفر مربوط به مسیرهای رانندگی است.
    • "WALK" حالت سفر مربوط به مسیرهای پیاده‌روی است.
  • road_name شامل نام جاده‌ای است که نقطه ناوبری از آن فاصله دارد.

نقاط ناوبری برای اکثر مکان‌هایی که موقعیت مکانی دقیقی دارند، مانند آدرس خیابان‌ها، ساختمان‌ها و مؤسسات، بازگردانده می‌شوند. مکان‌هایی که نشان‌دهنده مناطق وسیعی هستند، مانند شهرها و مناطقی که موقعیت مکانی دقیق آنها می‌تواند مبهم باشد، ممکن است هیچ نقطه ناوبری را برنگردانند.

اطلاعیه مهاجرت

از ۱۷ آوریل، اکنون باید پارامتر محاسبات اضافی NAVIGATION_POINTS را در درخواست دریافت نقاط ناوبری ارائه دهید. کلاینت‌ها می‌توانند این را با تأیید اینکه فیلد road_name در برخی از نقاط ناوبری بازگردانده می‌شود و فیلد location در هر نقطه ناوبری دارای چهار زیرفیلد زیر ( lat ، lng ، latitude ، longitude ) است، آزمایش کنند.

علاوه بر این، شما باید به جای فیلدهای location.lat و location.longitude به فیلدهای location.latitude و location.lng مهاجرت کنید. در نسخه‌های آینده، درخواست‌هایی که حاوی پارامتر محاسبات اضافی NAVIGATION_POINTS نباشند، هیچ نقطه ناوبری در پاسخ نخواهند داشت و فیلدهای location.latitude و location.longitude دیگر بازگردانده نمی‌شوند.

درخواست جزئیات

شما می‌توانید امتیازهای ناوبری را در انواع درخواست‌های زیر به دست آورید:

برای هر یک از این درخواست‌ها، شما این پارامتر را ارائه می‌دهید: extra_computations=NAVIGATION_POINTS .

درخواست نمونه

پرس‌وجوی زیر از ژئوکدینگ مکانی برای بدست آوردن نقاط ناوبری برای یک رستوران در مانتین ویو، کالیفرنیا، ایالات متحده استفاده می‌کند:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJZ54APTS3j4ARBYZD956MHq8&extra_computations=NAVIGATION_POINTS&key=YOUR_API_KEY

پاسخ نمونه

پاسخ حاصل از پرس و جوی بالا، آرایه‌ای از نقاط ناوبری را نشان می‌دهد:

{
  "navigation_points": [
    {
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Castro Street"
    },
    {
      "location": {
        "lat": 37.394273,
        "lng": -122.0793078,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Wild Cherry Lane"
    },
    {
      "location": {
        "lat": 37.3941202,
        "lng": -122.0789189,
      },
      "restricted_travel_modes": ["DRIVE"]
    }
  ]
}

بازخورد

این یک ویژگی آزمایشی است. ما از دریافت بازخورد در geocoding-feedback-channel@google.com استقبال می‌کنیم.