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