הצטרפו אלינו לאירוע הבא של
Google Maps Platform Developer Community Day בסן פרנסיסקו בדצמבר.
להגשת בקשה להשתתפות.
Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.
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.
|
| סוף השדות הבלעדיים. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2026-09-07 (שעון UTC).
[null,null,["עדכון אחרון: 2026-09-07 (שעון UTC)."],[],["Waypoints, marking route start, end, and intermediate stops, are defined using a JSON format. Key properties include `via` (boolean) for non-stopping waypoints, `vehicleStopover` (boolean) for pickup/drop-off locations, and `sideOfRoad` (boolean) for preferred stopping side. A waypoint's `location_type` can be specified via geographic coordinates (`location`), a place ID (`placeId`), or a human-readable address (`address`). `via` cannot be true for terminal waypoints or if `optimize_waypoint_order` is true.\n"]]