قد تتضمّن نقاط المرور معدِّلات الموقع الجغرافي لتغيير طريقة احتساب المسارات، بما في ذلك إعدادات heading وsideOfRoad.
تحديد اتجاه المركبة
لتحديد نقطة مرور، عليك تحديد الموقع الجغرافي الموقع الجغرافي (REST) أو الموقع الجغرافي (gRPC) كزوج من إحداثيات خطوط الطول والعرض.
يتيح لك الموقع الجغرافي أيضًا تحديد الاتجاه الذي تريد أن تتّخذه المركبة عند وصولها إلى كل نقطة مرور. يمكنك استخدام هذه الميزة لضمان وصول المركبة إلى الجانب نفسه من الطريق الذي ينتظر فيه المستهلك ليتم اصطحابه. عند عدم تحديد اتجاه، يمكن أن تصل المركبة إلى الجانب الخطأ من الطريق.
قيم الاتجاه هي أعداد صحيحة تتوافق مع اتجاهات البوصلة، وبالتالي تتراوح بين صفر و359. على سبيل المثال، تشير القيمة 0 إلى اتجاه شمالي تمامًا.
يوضّح المثال التالي كيفية ضبط
heading لنقطة مرور.
{
"origin":{
"location":{
"latLng":{
"latitude": 37.419734,
"longitude": -122.0827784
},
"heading": 127
}
},
...تحديد جانب الطريق المفضّل
يمكنك تمثيل موقع جغرافي من خلال إنشاء كائن Waypoint (REST) أو Waypoint (gRPC) . يمكن أن يتوافق الموقع الجغرافي المحدّد بزوج من خطوط الطول والعرض مع جانب معيّن من الطريق. ومع ذلك، من أجل دعم تحسين المسار، يمكن أن يضبط المسار نقطة توقف على الجانب المقابل من الطريق للموقع الجغرافي المحدّد.
تتيح نقاط المرور استخدام السمة sideOfRoad، ما
يشير إلى أنّ موقع نقطة المرور يفضّل أن تتوقف المركبة على
الجانب نفسه من الطريق الذي يحدّده الموقع الجغرافي.
حدِّد أنّ المسار يستخدم الجانب المفضّل من الطريق من خلال ضبط السمة sideOfRoad في Waypoint على true. بعد ذلك، يمرّ المسار بالموقع الجغرافي حتى تتمكّن المركبة من التوقف على جانب الطريق الذي يفضّله الموقع الجغرافي.
يوضّح المثال التالي كيفية ضبط sideOfRoad لنقطة مرور.
{
"origin":{
"location":{
"latLng":{
"latitude": 37.419734,
"longitude": -122.0827784
}
},
"sideOfRoad": true
},
...