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