נקודות ציון יכולות לכלול משני מיקום כדי לשנות את אופן חישוב המסלולים, כולל הגדרות של 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
},
...