למשל, אם רוצים להגדיר עצירה במסלול, למשל לאיסוף או להורדה, צריך לציין ציון דרך כציון דרך. לשם כך, משתמשים במאפיין vehicleStopover
של ציון דרך, Waypoint (ב-REST) או Waypoint (ב-gRPC).
ההגדרה הזו מבטיחה שהמסלול המחושב לא יתחיל או יסתיים בכביש שלא מתאים לאיסוף ולפריקה, כמו כביש מהיר או מנהרה.
ניקח לדוגמה מצב שבו כביש פנימי חוצה כביש בתוך מנהרה. אם תציינו נקודת ציון שנמצאת בצומת של שני הכבישים (כפי שמוצג במפה), המסלול שייווצר יתחיל או יסתיים בכביש היבשתי או במנהרה. התוצאה הזו יוצרת בעיה כי אי אפשר לעצור במנהרות כדי לאסוף או להוריד נוסעים.
אם רוצים להשתמש בנקודת הציון לצורך איסוף או מסירה, צריך להגדיר את השדה vehicleStopover
לערך true
כדי לוודא שהמסלול שנוצר מתחיל או מסתיים בכביש שבו מותר לבצע איסוף או מסירה.
תוכלו להיעזר בדוגמה הבאה כדי להגדיר את המאפיין vehicleStopover
:
{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 } }, "vehicleStopover": true }, ... }