تحديد عنوان المركبة وجانبها

قد تتضمّن نقاط الطريق معدِّلات الموقع الجغرافي لتغيير طريقة احتساب المسارات، بما في ذلك إعدادات heading وsideOfRoad.

تحديد اتجاه المركبة

لتحديد نقطة طريق، عليك تحديد الموقع الجغرافي (REST) أو الموقع الجغرافي (gRPC) كزوج من إحداثيات خط العرض وخط الطول.

يتيح لك الموقع الجغرافي أيضًا تحديد الاتجاه الذي تريد أن تتّخذه المركبة عند وصولها إلى كل نقطة طريق. يمكنك استخدام هذه الميزة لضمان وصول المركبة إلى الجانب نفسه من الطريق الذي ينتظر فيه المستهلك. عند عدم تحديد اتجاه، قد تصل المركبة إلى الجانب الخاطئ من الطريق.

قيم العنوان هي أعداد صحيحة تتوافق مع اتجاهات البوصلة، وبالتالي تتراوح بين صفر و359. على سبيل المثال، تشير القيمة 0 إلى اتجاه العنوان شمالًا.

يوضّح المثال التالي كيفية ضبط heading لنقطة طريق.

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

تحديد الجانب المفضّل من الطريق

يمكنك تمثيل موقع جغرافي من خلال إنشاء عنصر Waypoint (REST) أو Waypoint (gRPC). يمكن أن يتطابق الموقع الجغرافي المحدّد بزوج من خطوط الطول والعرض مع جانب معيّن من الطريق. ومع ذلك، لدعم ميزة تحسين المسار، يمكن أن يضبط المسار نقطة توقّف على الجانب الآخر من الطريق من الموقع الجغرافي المحدّد.

تتيح نقاط الطريق استخدام السمة sideOfRoad، التي تشير إلى أنّ الموقع الجغرافي لنقطة الطريق يفضّل أن تتوقف المركبة على الجانب نفسه من الطريق كما هو محدّد في الموقع الجغرافي.

حدِّد أنّ المسار يستخدم الجانب المفضّل من الطريق من خلال ضبط قيمة السمة Waypoint sideOfRoad على true. بعد ذلك، يمرّ المسار بالموقع الجغرافي لكي تتمكّن المركبة من التوقّف على جانب الطريق الذي يقع فيه الموقع الجغرافي.

يوضّح المثال التالي كيفية ضبط sideOfRoad لنقطة طريق.

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