Waypoint

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "location": {
    object (Location)
  },
  "placeId": string,
  "address": string,
  "navigationPointToken": string
  // End of mutually exclusive fields.
}
שדות
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

object (Location)

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

placeId

string

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

address

string

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

navigationPointToken

string

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

סוף השדות הבלעדיים.