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

قد تتضمّن نقاط الالتقاء عوامل تعديل الموقع الجغرافي لتغيير طريقة احتساب المسارات، بما في ذلك إعدادات 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
  },
  ...