Waypoint

עטיפה של ציון דרך. נקודות ציון מסמנות את ההתחלה והסיום של מסלול, וכוללות תחנות ביניים לאורך המסלול.

ייצוג ב-JSON
{
  "via": boolean,
  "vehicleStopover": boolean,
  "sideOfRoad": boolean,

  // Union field location_type can be only one of the following:
  "location": {
    object (Location)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
שדות
via

boolean

סימון נקודת הדרך הזו כציון דרך ולא כתחנה. לכל נקודת ציון בבקשה שאינה דרך, התשובה מצרפת רשומה למערך legs כדי לספק את הפרטים של תחנות הביניים בחלק הזה של הנסיעה. מגדירים את הערך הזה כ-true כשרוצים שהמסלול יעבור דרך נקודת הציון הזו בלי לעצור בה. ציוני דרך בדרך לא גורמים להוספת רשומה למערך legs, אבל הם כן מגדירים את המסלול דרך ציון הדרך. אפשר להגדיר את הערך הזה רק בנקודות דרך שהן ביניים. הבקשה תיכשל אם תגדירו את השדה הזה בנקודות דרך סופיות. אם השדה ComputeRoutesRequest.optimize_waypoint_order מוגדר כ-true, לא ניתן להגדיר את השדה הזה כ-true. אחרת, הבקשה תיכשל.

vehicleStopover

boolean

מציין שציון הדרך מיועד לכלי רכב לעצירה, כאשר הכוונה היא לאיסוף או להורדה. כשמגדירים את הערך הזה, המסלול המחושב לא יכלול נקודות דרך שאינן מסוג via בכבישים שלא מתאימים לאיסוף או להורדה. האפשרות הזו פועלת רק לסוגי התחבורה DRIVE ו-TWO_WHEELER, וכאשר הערך של locationType הוא Location.

sideOfRoad

boolean

מציין שהמיקום של נקודת הציון הזו מיועד להעדפה של כלי הרכב לעצור בצד מסוים של הכביש. כשמגדירים את הערך הזה, המסלול עובר דרך המיקום כדי שהרכב יוכל לעצור בצד הכביש שאליו המיקום מוטה ממרכז הכביש. האפשרות הזו פועלת רק ב-DRIVE וב-TWO_WHEELER RouteTravelMode.

שדה האיחוד location_type. דרכים שונות לייצוג מיקום. הערך של location_type יכול להיות רק אחת מהאפשרויות הבאות:
location

object (Location)

נקודה שצוינה באמצעות קואורדינטות גיאוגרפיות, כולל כיוון אופציונלי.

placeId

string

מזהה המקום של נקודת העניין שמשויך לנקודת הציון.

address

string

כתובת שאנשים יכולים לקרוא או קוד Plus. פרטים נוספים זמינים בכתובת https://plus.codes.