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

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

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

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

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

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

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

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

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

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

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

حدِّد أن المسار يستخدم الجانب المفضَّل من الطريق من خلال ضبط خاصية "نقطة الطريق" sideOfRoad على true. يمر المسار بعد ذلك عبر الموقع بحيث يمكن للمركبة التوقف على جانب الطريق الذي يتحيز الموقع نحوه.

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

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