הגדרת עצירה לאורך מסלול

כדי להגדיר עצירה במסלול, למשל לאיסוף או להורדה, צריך לסמן נקודת ציון כנקודת ציון של עצירה ביניים. לשם כך, משתמשים במאפיין vehicleStopover של ציון דרך, Waypoint (ב-REST) או Waypoint (ב-gRPC). ההגדרה הזו מבטיחה שהמסלול המחושב לא יתחיל או יסתיים בכביש שלא מתאים לאיסוף ולפריקה, כמו כביש מהיר או מנהרה.

אזהרה: בקשות שמוגשות באמצעות vehicleStopover מחוייבות לפי תעריפ גבוה יותר. מידע נוסף על חיוב ב-Routes API

ניקח לדוגמה מצב שבו כביש פנימי חוצה כביש בתוך מנהרה. אם תציינו נקודת ציון שנמצאת בצומת של שני הכבישים (כפי שמוצג במפה), המסלול שייווצר יתחיל או יסתיים בכביש היבשתי או במנהרה. התוצאה הזו יוצרת בעיה כי אי אפשר לעצור במנהרות כדי לאסוף או להוריד נוסעים.

אם רוצים להשתמש בנקודת הציון לצורך איסוף או מסירה, צריך להגדיר את השדה vehicleStopover לערך true כדי לוודא שהמסלול שנוצר מתחיל או מסתיים בכביש שבו מותר לבצע איסוף או מסירה.

בדוגמה הבאה מוסבר איך להגדיר את המאפיין vehicleStopover:

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