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

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

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

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

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

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