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