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,
  "navigationPointToken": 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

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

navigationPointToken

string

אסימון שמזהה NavigationPoint, שמתקבל מה-method ‏SearchDestinations של Geocoding API.