مشخص کردن جهت خودرو و سمت جاده

نقاط‌مسیر ممکن است شامل اصلاح‌کننده‌های مکان برای تغییر نحوه محاسبه مسیرها باشند، ازجمله تنظیمات مربوط به heading و sideOfRoad.

مشخص کردن جهت خودرو

برای تعریف نقطه‌مسیر، باید مکان (REST) یا مکان (gRPC) جغرافیایی را به‌صورت جفت مختصات عرض جغرافیایی/طول جغرافیایی مشخص کنید.

مکان همچنین به شما امکان می‌دهد جهتی را که می‌خواهید خودرو هنگام رسیدن به هر نقطه‌مسیر به آن سمت حرکت کند مشخص کنید. می‌توانید از این ویژگی استفاده کنید تا مطمئن شوید که خودرو در همان سمتی از جاده می‌رسد که مصرف‌کننده منتظر سوار شدن است. وقتی جهت را مشخص نکنید، ممکن است خودرو به سمت اشتباه جاده برسد.

مقادیر جهت اعداد صحیحی هستند که با جهت‌های قطب‌نما مطابقت دارند و بنابراین از صفر تا ۳۵۹ متغیرند. برای مثال، مقدار ۰ نشان‌دهنده جهت حرکت به‌سمت شمال است.

مثال زیر نحوه تنظیم heading را برای نقطه‌مسیر نشان می‌دهد.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      },
      "heading": 127
    }
  },
  ...

سمت ترجیحی جاده را مشخص کنید

با ایجاد شیء Waypoint (REST) یا Waypoint (gRPC)، مکانی را نشان می‌دهید. مکانی که با جفت عرض و طول جغرافیایی تعریف می‌شود می‌تواند با سمت خاصی از جاده مطابقت داشته باشد. بااین‌حال، برای پشتیبانی از بهینه‌سازی مسیر، یک مسیر همچنان می‌تواند توقفگاهی را در سمت مقابل جاده نسبت به مکان مشخص‌شده تنظیم کند.

نقطه‌مسیرها از ویژگی sideOfRoad پشتیبانی می‌کنند که نشان می‌دهد مکان نقطه‌مسیر ترجیح می‌دهد خودرو در همان سمت جاده که توسط مکان مشخص شده است توقف کند.

با تنظیم کردن خصوصیت sideOfRoad در «نقطه‌مسیر» روی true، مشخص کنید که مسیر از سمت ترجیحی جاده استفاده می‌کند. سپس مسیر از مکان عبور می‌کند تا خودرو بتواند در سمتی از جاده که مکان به آن متمایل است توقف کند.

مثال زیر نحوه تنظیم sideOfRoad را برای نقطه‌مسیر نشان می‌دهد.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    },
    "sideOfRoad": true
  },
  ...