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

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

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

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

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

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

يوضح المثال التالي كيفية إعداد 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
  },
  ...