Routes Preferred API זמין כרגע ללקוחות נבחרים בלבד. אפשר לפנות למחלקת המכירות לקבלת מידע נוסף.

דף זה תורגם על ידי Cloud Translation API.

Package google.maps.routes.v1

אינדקס

RoutesPreferred (ממשק)
ComputeCustomRoutesRequest (הודעה)
ComputeCustomRoutesResponse (הודעה)
ComputeCustomRoutesResponse.FallbackInfo (הודעה)
ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective (טיפוס enum)
ComputeRouteMatrixRequest (הודעה)
ComputeRoutesRequest (הודעה)
ComputeRoutesResponse (הודעה)
CustomRoute (הודעה)
FallbackInfo (הודעה)
FallbackReason (טיפוס enum)
FallbackRoutingMode (טיפוס enum)
Location (הודעה)
Maneuver (טיפוס enum)
NavigationInstruction (הודעה)
Polyline (הודעה)
PolylineEncoding (טיפוס enum)
PolylineQuality (טיפוס enum)
Route (הודעה)
RouteLeg (הודעה)
RouteLegStep (הודעה)
RouteLegStepTravelAdvisory (הודעה)
RouteLegTravelAdvisory (הודעה)
RouteMatrixDestination (הודעה)
RouteMatrixElement (הודעה)
RouteMatrixElementCondition (טיפוס enum)
RouteMatrixOrigin (הודעה)
RouteModifiers (הודעה)
RouteObjective (הודעה)
RouteObjective.RateCard (הודעה)
RouteObjective.RateCard.MonetaryCost (הודעה)
RouteTravelAdvisory (הודעה)
RouteTravelMode (טיפוס enum)
RoutingPreference (טיפוס enum)
SpeedReadingInterval (הודעה)
SpeedReadingInterval.Speed (טיפוס enum)
TollInfo (הודעה)
TollPass (טיפוס enum)
Units (טיפוס enum)
VehicleEmissionType (טיפוס enum)
VehicleInfo (הודעה)
Waypoint (הודעה)

RoutesPreferred

ה-API המועדף של המסלולים.

ComputeCustomRoutes

ComputeCustomRoutes
`rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)` בהינתן קבוצה של נקודות ציון מתווכות ומובילות, וכן יעד של מסלול, מחשב את המסלול הטוב ביותר ליעד של המסלול. מחזירה גם את המסלול המהיר ביותר ואת המסלול הקצר ביותר כמסלולי עזר. הערה: השיטה הזו מחייבת לציין אנונימיזציה של שדות תגובה בקלט. אפשר לספק את המסכה של שדות התגובה באמצעות הפרמטר `$fields` או `fields` של כתובת האתר, או באמצעות הכותרת HTTP/gRPC `X-Goog-FieldMask` (מידע נוסף זמין בפרמטרים הזמינים של כתובות URL ובכותרות. הערך הוא רשימה של נתיבי שדות שמופרדים בפסיקים. במסמכי התיעוד המפורטים מוסבר איך ליצור את נתיבי השדות. לדוגמה, בשיטה הזו: אנונימיזציה של כל השדות הזמינים (לבדיקה ידנית): `X-Goog-FieldMask: ` מסכת שדות של מידע על מרחקים, משכי זמן, אסימונים וכבישי אגרה: `X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo` Google לא ממליצה להשתמש במסכה של שדות התגובה עם התו הכללי לחיפוש (``), או לציין את מסיכת השדות ברמה העליונה (`routes`), מהסיבות הבאות: אם תבחרו רק את השדות שנחוצים לכם, השרת שלנו יוכל לשמור מחזורי חישוב כדי לאפשר לנו להחזיר לכם את התוצאה בזמן אחזור קצר יותר. בחירה רק בשדות שדרושים במשימת הייצור מבטיחה ביצועים יציבים של זמן אחזור. יכול להיות שנוסיף עוד שדות תגובה בעתיד, והשדות החדשים האלה עשויים לדרוש זמן חישוב נוסף. אם תבחרו את כל השדות או אם תבחרו את כל השדות ברמה העליונה, יכול להיות שתבחינו בירידה בביצועים כי כל שדה חדש שנוסיף ייכלל בתשובה באופן אוטומטי. אם תבחרו רק את השדות שנחוצים לכם, יתקבל גודל תגובה קטן יותר וכתוצאה מכך תפוקה רשת גבוהה יותר. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/maps-platform.routespreferred` למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

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

הערה: השיטה הזו מחייבת לציין אנונימיזציה של שדות תגובה בקלט. אפשר לספק את המסכה של שדות התגובה באמצעות הפרמטר $fields או fields של כתובת האתר, או באמצעות הכותרת HTTP/gRPC X-Goog-FieldMask (מידע נוסף זמין בפרמטרים הזמינים של כתובות URL ובכותרות. הערך הוא רשימה של נתיבי שדות שמופרדים בפסיקים. במסמכי התיעוד המפורטים מוסבר איך ליצור את נתיבי השדות.

לדוגמה, בשיטה הזו:

אנונימיזציה של כל השדות הזמינים (לבדיקה ידנית): X-Goog-FieldMask: *
מסכת שדות של מידע על מרחקים, משכי זמן, אסימונים וכבישי אגרה: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

Google לא ממליצה להשתמש במסכה של שדות התגובה עם התו הכללי לחיפוש (*), או לציין את מסיכת השדות ברמה העליונה (routes), מהסיבות הבאות:

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

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

https://www.googleapis.com/auth/maps-platform.routespreferred

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

ComputeRouteMatrix

ComputeRouteMatrix
`rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)` מקבלת רשימת מקורות ויעדים ומחזירה זרם עם מידע על המסלול לכל שילוב של נקודת מוצא ויעד. הערה: השיטה הזו מחייבת לציין אנונימיזציה של שדות תגובה בקלט. אפשר לספק את המסכה של שדות התגובה באמצעות הפרמטר `$fields` או `fields` של כתובת האתר, או באמצעות הכותרת HTTP/gRPC `X-Goog-FieldMask` (מידע נוסף זמין בפרמטרים הזמינים של כתובות URL ובכותרות. הערך הוא רשימה של נתיבי שדות שמופרדים בפסיקים. במסמכי התיעוד המפורטים מוסבר איך ליצור את נתיבי השדות. לדוגמה, בשיטה הזו: אנונימיזציה של כל השדות הזמינים (לבדיקה ידנית): `X-Goog-FieldMask: ` מסכת שדות של משכי זמן של מסלולים, מרחקים, סטטוס רכיב, מצב ואינדקסים של רכיבים (הגדרת דוגמה לסביבת ייצור): `X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration` חשוב מאוד לכלול את `status` במסכת השדות, כי אחרת כל ההודעות ייראו בסדר. Google לא ממליצה להשתמש באנונימיזציה של שדות התגובה עם התו הכללי לחיפוש (``), מהסיבות הבאות: אם תבחרו רק את השדות שנחוצים לכם, השרת שלנו יוכל לשמור מחזורי חישוב כדי לאפשר לנו להחזיר לכם את התוצאה בזמן אחזור קצר יותר. בחירה רק בשדות שדרושים במשימת הייצור מבטיחה ביצועים יציבים של זמן אחזור. יכול להיות שנוסיף עוד שדות תגובה בעתיד, והשדות החדשים האלה עשויים לדרוש זמן חישוב נוסף. אם תבחרו את כל השדות או אם תבחרו את כל השדות ברמה העליונה, יכול להיות שתבחינו בירידה בביצועים כי כל שדה חדש שנוסיף ייכלל בתשובה באופן אוטומטי. אם תבחרו רק את השדות שנחוצים לכם, יתקבל גודל תגובה קטן יותר וכתוצאה מכך תפוקה רשת גבוהה יותר. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/maps-platform.routespreferred` למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

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

לדוגמה, בשיטה הזו:

אנונימיזציה של כל השדות הזמינים (לבדיקה ידנית): X-Goog-FieldMask: *
מסכת שדות של משכי זמן של מסלולים, מרחקים, סטטוס רכיב, מצב ואינדקסים של רכיבים (הגדרת דוגמה לסביבת ייצור): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

חשוב מאוד לכלול את status במסכת השדות, כי אחרת כל ההודעות ייראו בסדר. Google לא ממליצה להשתמש באנונימיזציה של שדות התגובה עם התו הכללי לחיפוש (*), מהסיבות הבאות:

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

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

https://www.googleapis.com/auth/maps-platform.routespreferred

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

ComputeRoutes

ComputeRoutes
`rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)` מחזירה את המסלול הראשי יחד עם מסלולים חלופיים אופציונליים, בהינתן קבוצה של ציוני דרך בטרמינל ובנקודת ביניים. הערה: השיטה הזו מחייבת לציין אנונימיזציה של שדות תגובה בקלט. אפשר לספק את המסכה של שדות התגובה באמצעות פרמטר של כתובת אתר `$fields` או `fields`, או באמצעות כותרת HTTP/gRPC `X-Goog-FieldMask` (מידע נוסף זמין בפרמטרים הזמינים של כתובות URL ובכותרות. הערך הוא רשימה של נתיבי שדות שמופרדים בפסיקים. במסמכי התיעוד המפורטים מוסבר איך ליצור את נתיבי השדות. לדוגמה, בשיטה הזו: אנונימיזציה של כל השדות הזמינים (לבדיקה ידנית): `X-Goog-FieldMask: ` מסכת שדות של משך הזמן, המרחק וקו הפוליגוני ברמת המסלול (הגדרת דוגמה לסביבת הייצור): `X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline` Google לא ממליצה להשתמש במסכה של שדות התשובה עם התו הכללי לחיפוש (``), או לציין את מסיכת השדות ברמה העליונה (`routes`), מהסיבות הבאות: אם תבחרו רק את השדות שנחוצים לכם, השרת שלנו יוכל לשמור מחזורי חישוב כדי לאפשר לנו להחזיר לכם את התוצאה בזמן אחזור קצר יותר. בחירה רק בשדות שדרושים במשימת הייצור מבטיחה ביצועים יציבים של זמן אחזור. יכול להיות שנוסיף עוד שדות תגובה בעתיד, והשדות החדשים האלה עשויים לדרוש זמן חישוב נוסף. אם תבחרו את כל השדות או אם תבחרו את כל השדות ברמה העליונה, יכול להיות שתבחינו בירידה בביצועים כי כל שדה חדש שנוסיף ייכלל בתשובה באופן אוטומטי. אם תבחרו רק את השדות שנחוצים לכם, יתקבל גודל תגובה קטן יותר וכתוצאה מכך תפוקה רשת גבוהה יותר. היקפי הרשאות נדרש היקף ההרשאות הבא של OAuth: `https://www.googleapis.com/auth/maps-platform.routespreferred` למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

הערה: השיטה הזו מחייבת לציין אנונימיזציה של שדות תגובה בקלט. אפשר לספק את המסכה של שדות התגובה באמצעות פרמטר של כתובת אתר $fields או fields, או באמצעות כותרת HTTP/gRPC X-Goog-FieldMask (מידע נוסף זמין בפרמטרים הזמינים של כתובות URL ובכותרות. הערך הוא רשימה של נתיבי שדות שמופרדים בפסיקים. במסמכי התיעוד המפורטים מוסבר איך ליצור את נתיבי השדות.

לדוגמה, בשיטה הזו:

אנונימיזציה של כל השדות הזמינים (לבדיקה ידנית): X-Goog-FieldMask: *
מסכת שדות של משך הזמן, המרחק וקו הפוליגוני ברמת המסלול (הגדרת דוגמה לסביבת הייצור): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google לא ממליצה להשתמש במסכה של שדות התשובה עם התו הכללי לחיפוש (*), או לציין את מסיכת השדות ברמה העליונה (routes), מהסיבות הבאות:

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

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

https://www.googleapis.com/auth/maps-platform.routespreferred

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

ComputeCustomRoutesRequest

הודעת הבקשה של ComputeCustomRoutes.

שדות
`origin`	`Waypoint` חובה. ציון דרך במקור.
`destination`	`Waypoint` חובה. ציון דרך ליעד.
`intermediates[]`	`Waypoint` זה שינוי אופציונלי. קבוצה של נקודות דרך לאורך המסלול (לא כולל נקודות סופיות), לעצירה או למעבר. יש תמיכה ב-25 ציוני דרך ברמת הביניים.
`travel_mode`	`RouteTravelMode` זה שינוי אופציונלי. מציין את אמצעי התחבורה. כרגע יש תמיכה רק ב-Drive.
`routing_preference`	`RoutingPreference` זה שינוי אופציונלי. מציינת איך לחשב את המסלול. השרת מנסה להשתמש בהעדפת הניתוב שנבחרה כדי לחשב את הנתיב. אם העדפת הניתוב גורמת לשגיאה או לזמן אחזור ארוך במיוחד, תוחזר שגיאה. בעתיד, ייתכן שניישם מנגנון חלופי כדי להשתמש באפשרות אחרת כאשר האפשרות המועדפת לא תיתן תוצאה חוקית. אפשר להגדיר את האפשרות הזו רק כאשר `travel_mode` הוא `DRIVE` או `TWO_WHEELER`, אחרת הבקשה תיכשל.
`polyline_quality`	`PolylineQuality` זה שינוי אופציונלי. מציין את ההעדפה שלך לאיכות של הקו הפוליגוני.
`polyline_encoding`	`PolylineEncoding` זה שינוי אופציונלי. מציינת את הקידוד המועדף לקו הפוליגוני.
`departure_time`	`Timestamp` זה שינוי אופציונלי. שעת היציאה. אם לא מגדירים את הערך הזה, ברירת המחדל של הערך הזה היא השעה שבה שלחתם את הבקשה. אם תגדירו את הערך הזה למועד שכבר התרחש, הבקשה תיכשל.
`route_modifiers`	`RouteModifiers` זה שינוי אופציונלי. קבוצה של תנאים שמשפיעים על אופן החישוב של נתיבים.
`route_objective`	`RouteObjective` חובה. יעד למסלול לאופטימיזציה.
`language_code`	`string` זה שינוי אופציונלי. קוד השפה BCP-47, כמו 'en-US' או 'sr-Latn'. מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. במאמר שפות תמיכה אפשר למצוא את רשימת השפות הנתמכות. אם לא מציינים את הערך הזה, המערכת מסיקה את שפת התצוגה מהמיקום של בקשת המסלול.
`units`	`Units` זה שינוי אופציונלי. מציינת את יחידות המידה של שדות התצוגה. זה כולל את השדה `instruction` ב-`NavigationInstruction`. יחידות המדידה של המסלול, הרגל, מרחק הצעדים ומשך הזמן לא מושפעות מהערך הזה. אם לא מציינים את הערך הזה, המערכת מסיקה את יחידות התצוגה מהמיקום של הבקשה.

ComputeCustomRoutesResponse

הודעת תגובה של ComputeCustomRoutes.

שדות
`routes[]`	`CustomRoute` המסלולים 'הכי טובים' בשביל היעד של המסלול להזנת הקלט.
`fastest_route`	`CustomRoute` מסלול העזר המהיר ביותר.
`shortest_route`	`CustomRoute` מסלול העזר הקצר ביותר.
`fallback_info`	`FallbackInfo` מידע חלופי למסלולים מותאמים אישית.

FallbackInfo

כולל מידע חלופי על ComputeCustomRoutes. ב-ComputeCustomRoutes יש שני סוגים של חלופות:

אם הלקוח לא יכול לחשב את הנתיב באמצעות ה-ניתוב הרצוי של הלקוח, הוא יחזור למצב ניתוב אחר. במקרה הזה, הפרמטרים fallback_routing_mode ו-Rout_mode_fallback_reason משמשים כדי לציין את מצב הניתוב החלופי, וגם את הסיבה לחלופה.
אם הוא לא יכול לחשב את 'הטוב ביותר' נתיב ליעד של המסלול שהלקוח ציין, הוא עשוי לחזור למטרה אחרת. נעשה שימוש ב-fallback_route_objective כדי לתאר את המטרה של הנתיב החלופי.

שדות

שדות
`routing_mode`	`FallbackRoutingMode` מצב הניתוב ששימש לתשובה. אם החלופה הופעלה, המצב עשוי להיות שונה מהעדפת הניתוב שהוגדרה בבקשת הלקוח המקורית.
`routing_mode_reason`	`FallbackReason` הסיבה לכך שנעשה שימוש בתשובה החלופית במקום בתשובה המקורית. השדה הזה מאוכלס רק כשמצב החלופה מופעל, ומוחזרת התשובה החלופית.
`route_objective`	`FallbackRouteObjective` היעד של הנתיב ששימש לתשובה. אם הופעלה חלופה, היעד יכול להיות שונה מהיעד של המסלול שצוין בבקשת הלקוח המקורית.

routing_mode

FallbackRoutingMode

מצב הניתוב ששימש לתשובה. אם החלופה הופעלה, המצב עשוי להיות שונה מהעדפת הניתוב שהוגדרה בבקשת הלקוח המקורית.

routing_mode_reason

FallbackReason

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

route_objective

FallbackRouteObjective

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

FallbackRouteObjective

RouteObjective שבו נעשה שימוש לתגובה.

טיפוסים בני מנייה (enum)
`FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED`	לא צוינה מטרה של מסלול חלופי.
`FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA`	אם לקוח מבקש מ-RateCard ומגדיר את הפרמטר contains_tolls כ-true, ואין ל-Google נתונים על מחירי האגרה במסלול, ה-API מחזיר את ה-API ל-RateCard בלי להביא בחשבון את מחיר האגרה.

ComputeRouteMatrixRequest

הודעת הבקשה של ComputeRouteMatrix

שדות
`origins[]`	`RouteMatrixOrigin` חובה. מערך מקורות, שקובע את השורות של מטריצת התגובות. יש כמה הגבלות גודל על העוצמה (cardinality) של המקורות והיעדים: מספר הרכיבים (מקורות × יעדים) לא יכול להיות גדול מ-625 בכל מקרה. מספר הרכיבים (מקורות × יעדים) לא יכול להיות גדול מ-100 אם path_preference מוגדר כ-`TRAFFIC_AWARE_OPTIMAL`. מספר ציוני הדרך (מקורות + יעדים) שמצוין כ-`place_id` לא יכול להיות גדול מ-50.
`destinations[]`	`RouteMatrixDestination` חובה. מערך יעדים, שקובע את העמודות של מטריצת התגובות.
`travel_mode`	`RouteTravelMode` זה שינוי אופציונלי. מציין את אמצעי התחבורה.
`routing_preference`	`RoutingPreference` זה שינוי אופציונלי. מציינת איך לחשב את המסלול. השרת מנסה להשתמש בהעדפת הניתוב שנבחרה כדי לחשב את הנתיב. אם העדפת הניתוב גורמת לשגיאה או לזמן אחזור ארוך במיוחד, תוחזר שגיאה. בעתיד, ייתכן שניישם מנגנון חלופי כדי להשתמש באפשרות אחרת כאשר האפשרות המועדפת לא תיתן תוצאה חוקית. אפשר להגדיר את האפשרות הזו רק כאשר `travel_mode` הוא `DRIVE` או `TWO_WHEELER`, אחרת הבקשה תיכשל.
`departure_time`	`Timestamp` זה שינוי אופציונלי. שעת היציאה. אם לא מגדירים את הערך הזה, ברירת המחדל תהיה השעה שבה שלחתם את הבקשה. אם תגדירו את הערך הזה לזמן שכבר התרחש, הבקשה תיכשל.

ComputeRoutesRequest

הודעת הבקשה של ComputeRoutes.

שדות
`origin`	`Waypoint` חובה. ציון דרך במקור.
`destination`	`Waypoint` חובה. ציון דרך ליעד.
`intermediates[]`	`Waypoint` זה שינוי אופציונלי. קבוצה של נקודות דרך לאורך המסלול (לא כולל נקודות סופיות), לעצירה או למעבר. יש תמיכה ב-25 ציוני דרך ברמת הביניים.
`travel_mode`	`RouteTravelMode` זה שינוי אופציונלי. מציין את אמצעי התחבורה.
`routing_preference`	`RoutingPreference` זה שינוי אופציונלי. מציינת איך לחשב את המסלול. השרת מנסה להשתמש בהעדפת הניתוב שנבחרה כדי לחשב את הנתיב. אם העדפת הניתוב גורמת לשגיאה או לזמן אחזור ארוך במיוחד, מוחזרת שגיאה. בעתיד, ייתכן שניישם מנגנון חלופי כדי להשתמש באפשרות אחרת כאשר האפשרות המועדפת לא תיתן תוצאה חוקית. אפשר להגדיר את האפשרות הזו רק כאשר `travel_mode` הוא `DRIVE` או `TWO_WHEELER`, אחרת הבקשה תיכשל.
`polyline_quality`	`PolylineQuality` זה שינוי אופציונלי. מציין את ההעדפה שלך לאיכות של הקו הפוליגוני.
`polyline_encoding`	`PolylineEncoding` זה שינוי אופציונלי. מציינת את הקידוד המועדף לקו הפוליגוני.
`departure_time`	`Timestamp` זה שינוי אופציונלי. שעת היציאה. אם לא מגדירים את הערך הזה, ברירת המחדל של הערך הזה היא השעה שבה שלחתם את הבקשה. אם תגדירו את הערך הזה למועד שכבר התרחש, הבקשה תיכשל.
`compute_alternative_routes`	`bool` מציינת אם לחשב מסלולים חלופיים בנוסף למסלול.
`route_modifiers`	`RouteModifiers` זה שינוי אופציונלי. קבוצה של תנאים שמשפיעים על אופן החישוב של נתיבים.
`language_code`	`string` זה שינוי אופציונלי. קוד השפה BCP-47, כמו 'en-US' או 'sr-Latn'. מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. במאמר שפות תמיכה אפשר למצוא את רשימת השפות הנתמכות. אם לא מציינים את הערך הזה, המערכת מסיקה את שפת התצוגה מהמיקום של בקשת המסלול.
`units`	`Units` זה שינוי אופציונלי. מציינת את יחידות המידה של שדות התצוגה. זה כולל את השדה `instruction` ב-`NavigationInstruction`. יחידות המדידה של המסלול, הרגל, מרחק הצעדים ומשך הזמן לא מושפעות מהערך הזה. אם לא מציינים את הערך הזה, המערכת מסיקה את יחידות התצוגה מהמיקום של הבקשה.
`optimize_waypoint_order`	`bool` אם הפרמטר OptimizeWaypointOrder מוגדר כ-True, מתבצע ניסיון לשנות את הסדר של נקודות הביניים שצוינו כדי לצמצם את העלות הכוללת של המסלול. אם אחת מנקודות הביניים היא דרך ציון דרך, הבקשה תיכשל. משתמשים ב-ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index כדי למצוא את הסדר החדש. אם לא נשלחת בקשה ל-Paths.Optimization_intermediate_waypoint_index בכותרת `X-Goog-FieldMask`, הבקשה תיכשל. אם OptimizeWaypointOrder מוגדר כ-false, הערך של ComputeRoutesResponse.optimized_intermediate_waypoint_index ריק.

ComputeRoutesResponse

חישוב הניתוב של הודעת התשובה.

שדות

שדות
`routes[]`	`Route` מכילה מערך של נתיבים מחושבים (עד שלושה) כשמציינים את compute_alternatives_routes, ומכילה רק נתיב אחד אם לא עושה זאת. כאשר המערך הזה מכיל מספר רשומות, הראשונה היא הנתיב המומלץ ביותר. אם המערך ריק, המשמעות היא שלא נמצא מסלול.
`fallback_info`	`FallbackInfo` במקרים מסוימים שבהם השרת לא יכול לחשב את תוצאות המסלול עם כל העדפות הקלט, הוא עשוי להשתמש בשיטת חישוב אחרת. כשמשתמשים במצב חלופי, השדה הזה מכיל מידע מפורט על התשובה החלופית. אחרת, השדה הזה לא מוגדר.

routes[]

Route

מכילה מערך של נתיבים מחושבים (עד שלושה) כשמציינים את compute_alternatives_routes, ומכילה רק נתיב אחד אם לא עושה זאת. כאשר המערך הזה מכיל מספר רשומות, הראשונה היא הנתיב המומלץ ביותר. אם המערך ריק, המשמעות היא שלא נמצא מסלול.

fallback_info

FallbackInfo

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

CustomRoute

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

שדות

שדות
`route`	`Route` המסלול נחשב 'הטוב ביותר' ליעד של נתיב הקלט.
`token`	`string` אסימון מסלול בקידוד base64 עם הגנה בטוחה באינטרנט שניתן להעביר ל-NavSDK, וכך לאפשר ל-NavSDK לשחזר את המסלול במהלך הניווט, ובמקרה של ניתוב מחדש יצייתו לכוונה המקורית בזמן קריאה ל-Routes Preferred ComputeCustomRoutes. הלקוחות צריכים להתייחס לאסימון הזה כאל blob אטום.

route

Route

המסלול נחשב 'הטוב ביותר' ליעד של נתיב הקלט.

token

string

אסימון מסלול בקידוד base64 עם הגנה בטוחה באינטרנט שניתן להעביר ל-NavSDK, וכך לאפשר ל-NavSDK לשחזר את המסלול במהלך הניווט, ובמקרה של ניתוב מחדש יצייתו לכוונה המקורית בזמן קריאה ל-Routes Preferred ComputeCustomRoutes. הלקוחות צריכים להתייחס לאסימון הזה כאל blob אטום.

FallbackInfo

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

שדות

שדות
`routing_mode`	`FallbackRoutingMode` מצב הניתוב ששימש לתשובה. אם החלופה הופעלה, המצב עשוי להיות שונה מהעדפת הניתוב שהוגדרה בבקשת הלקוח המקורית.
`reason`	`FallbackReason` הסיבה לכך שנעשה שימוש בתשובה החלופית במקום בתשובה המקורית. השדה הזה מאוכלס רק כשמצב החלופה מופעל, ומוחזרת התשובה החלופית.

routing_mode

FallbackRoutingMode

מצב הניתוב ששימש לתשובה. אם החלופה הופעלה, המצב עשוי להיות שונה מהעדפת הניתוב שהוגדרה בבקשת הלקוח המקורית.

reason

FallbackReason

FallbackReason

סיבות לשימוש בתשובה חלופית.

טיפוסים בני מנייה (enum)
`FALLBACK_REASON_UNSPECIFIED`	לא צוינה סיבה לחלופה.
`SERVER_ERROR`	אירעה שגיאת שרת במהלך חישוב מסלולים במצב הניתוב המועדף עליך, אבל הצלחנו להחזיר תוצאה שחושבה באמצעות מצב חלופי.
`LATENCY_EXCEEDED`	לא הצלחנו לסיים את החישוב במצב הניתוב המועדף עליך בזמן, אבל הצלחנו להחזיר תוצאה שחושבה באמצעות מצב חלופי.

FallbackRoutingMode

מצב הניתוב בפועל המשמש לתגובת החלופה המוחזרת.

טיפוסים בני מנייה (enum)
`FALLBACK_ROUTING_MODE_UNSPECIFIED`	לא בשימוש.
`FALLBACK_TRAFFIC_UNAWARE`	מציין את "TRAFFIC_UNAWARE" מצב הניתוב שימש לחישוב התגובה.
`FALLBACK_TRAFFIC_AWARE`	מציין את "TRAFFIC_AWARE" מצב הניתוב שימש לחישוב התגובה.

מיקום

כולל מיקום (נקודה גיאוגרפית וכותרת אופציונלית).

שדות

שדות
`lat_lng`	`LatLng` הקואורדינטות הגיאוגרפיות של ציון הדרך.
`heading`	`Int32Value` כותרת המצפן המשויכת לכיוון זרימת התנועה. הערך הזה משמש כדי לציין את צד הכביש שישמש לאיסוף ולהורדה. ערכי כותרות יכולים להיות בין 0 ל-360, כאשר 0 מציין את הכותרת לצפון, 90 מציין את הכותרת ל'מזרח' וכו'. ניתן להשתמש בשדה זה רק עבור אמצעי נסיעה של `DRIVE` ו-`TWO_WHEELER`.

lat_lng

LatLng

הקואורדינטות הגיאוגרפיות של ציון הדרך.

heading

Int32Value

כותרת המצפן המשויכת לכיוון זרימת התנועה. הערך הזה משמש כדי לציין את צד הכביש שישמש לאיסוף ולהורדה. ערכי כותרות יכולים להיות בין 0 ל-360, כאשר 0 מציין את הכותרת לצפון, 90 מציין את הכותרת ל'מזרח' וכו'. ניתן להשתמש בשדה זה רק עבור אמצעי נסיעה של DRIVE ו-TWO_WHEELER.

תמרון

קבוצת ערכים שמציינים את פעולת הניווט שיש לבצע בשלב הנוכחי (למשל: פנייה שמאלה, מיזוג, ישר וכו').

טיפוסים בני מנייה (enum)
`MANEUVER_UNSPECIFIED`	לא בשימוש.
`TURN_SLIGHT_LEFT`	צריך לסובב קצת שמאלה.
`TURN_SHARP_LEFT`	פונים פנייה חדה שמאלה.
`UTURN_LEFT`	בצעו פניית פרסה שמאלה.
`TURN_LEFT`	צריך לפנות שמאלה.
`TURN_SLIGHT_RIGHT`	צריך לפנות מעט ימינה.
`TURN_SHARP_RIGHT`	פונים פנייה חדה ימינה.
`UTURN_RIGHT`	בצעו פניית פרסה ימינה.
`TURN_RIGHT`	צריך לפנות ימינה.
`STRAIGHT`	עליך להמשיך ישר.
`RAMP_LEFT`	השתמשו ברמפה השמאלית.
`RAMP_RIGHT`	השתמשו ברמפה הימנית.
`MERGE`	מיזוג לתנועה.
`FORK_LEFT`	לוקחים את המזלג השמאלי.
`FORK_RIGHT`	קחו את המזלג הימני.
`FERRY`	קח את המעבורת.
`FERRY_TRAIN`	לוקחים את הרכבת שמובילה למעבורת.
`ROUNDABOUT_LEFT`	בכיכר יש לפנות שמאלה.
`ROUNDABOUT_RIGHT`	יש לפנות ימינה בכיכר.

NavigationInstruction

שדות

maneuver

Maneuver

כולל את הוראות הניווט עבור השלב הנוכחי (למשל: פנייה שמאלה, מיזוג, ישר וכו'). השדה הזה קובע איזה סמל יוצג.

instructions

string

הוראות לניווט בשלב הזה.

מצולע פתוח

כוללת קו פוליגוני מקודד.

שדות

שדות
שדה איחוד `polyline_type`. כולל את סוג קו הפוליגוני. ברירת המחדל היא encoded_polyline. `polyline_type` יכול להיות רק אחת מהאפשרויות הבאות:
`encoded_polyline`	`string` קידוד המחרוזת של הקו הפוליגוני באמצעות אלגוריתם הקידוד של קו פוליגוני
`geo_json_linestring`	`Struct` מציין קו פוליגוני באמצעות פורמט GeoJSON LineString

שדה איחוד polyline_type. כולל את סוג קו הפוליגוני. ברירת המחדל היא encoded_polyline. polyline_type יכול להיות רק אחת מהאפשרויות הבאות:

encoded_polyline

string

קידוד המחרוזת של הקו הפוליגוני באמצעות אלגוריתם הקידוד של קו פוליגוני

geo_json_linestring

Struct

מציין קו פוליגוני באמצעות פורמט GeoJSON LineString

PolylineEncoding

מציין את הסוג המועדף של קו פוליגוני שצריך להחזיר.

טיפוסים בני מנייה (enum)
`POLYLINE_ENCODING_UNSPECIFIED`	לא צוינה העדפה לסוג קו פוליגוני. ברירת המחדל היא `ENCODED_POLYLINE`.
`ENCODED_POLYLINE`	מציינת קו פוליגוני שמקודד באמצעות אלגוריתם הקידוד של קו פוליגוני.
`GEO_JSON_LINESTRING`	מציין קו פוליגוני באמצעות פורמט GeoJSON LineString

PolylineQuality

קבוצת ערכים המציינים את איכות הקו הפוליגוני.

טיפוסים בני מנייה (enum)
`POLYLINE_QUALITY_UNSPECIFIED`	לא צוינה העדפת איכות לקו פוליגוני. ברירת המחדל היא `OVERVIEW`.
`HIGH_QUALITY`	מציין קו פוליגוני באיכות גבוהה – שמורכב ממספר נקודות גדול יותר מ-`OVERVIEW`, במחיר של תגובה גדולה יותר. כדאי להשתמש בערך הזה כשרוצים לשפר את הדיוק.
`OVERVIEW`	מציין קו פוליגוני של סקירה כללית - שמורכב ממספר קטן של נקודות. אפשר להשתמש בערך הזה להצגת סקירה כללית של המסלול. כשמשתמשים באפשרות הזו, זמן האחזור של הבקשה קצר יותר בהשוואה לשימוש באפשרות `HIGH_QUALITY`.

נתיב

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

שדות
`legs[]`	`RouteLeg` אוסף של רגליים (קטעי נתיב בין ציוני דרך) שמרכיבות את המסלול. כל רגל תואמת לנסיעה בין שתי נקודות דרך שאינן של `via`. לדוגמה, למסלול ללא ציוני דרך באמצע יש רק רגל אחת. למסלול שכולל ציון דרך אחד שאינו `via` יש שתי רגליים. למסלול שכולל ציון דרך אחד ברמת ביניים `via` יש רגל אחת. הסדר של הנקודות תואם לסדר של 'ציוני הדרך' מ-`origin` עד `intermediates` עד `destination`.
`distance_meters`	`int32` מרחק הנסיעה של המסלול, במטרים.
`duration`	`Duration` משך הזמן שנדרש כדי לנווט במסלול. אם מגדירים את `routing_preference` לערך `TRAFFIC_UNAWARE`, הערך הזה יהיה זהה לערך `static_duration`. אם מגדירים את הערך בשדה `routing_preference` לערך `TRAFFIC_AWARE` או לערך `TRAFFIC_AWARE_OPTIMAL`, הערך הזה מחושב על סמך מצב התנועה.
`static_duration`	`Duration` משך הנסיעה במסלול בלי להביא בחשבון את מצב התנועה.
`polyline`	`Polyline` הקו הפוליגוני של הנתיב הכולל. הקו הפוליגוני הזה יהיה הקו הפוליגוני המשולב של כל `legs`.
`description`	`string` תיאור של המסלול.
`warnings[]`	`string` מערך אזהרות שיוצגו במהלך הצגת המסלול.
`viewport`	`Viewport` התיבה התוחמת של אזור התצוגה של הקו הפוליגוני.
`travel_advisory`	`RouteTravelAdvisory` מידע נוסף על המסלול.
`optimized_intermediate_waypoint_index[]`	`int32` אם השדה ComputeRoutesRequest.Optimize_waypoint_order מוגדר כ-True, השדה הזה מכיל את הסדר האופטימלי של נקודות הדרך בתהליך הביניים. אחרת, השדה הזה יהיה ריק. לדוגמה, נניח שהקלט הוא Origin: LA, ביניים: דאלאס, בנגור, פיניקס; יעד: תל אביב. וסדר הביניים שעבר אופטימיזציה הוא: פיניקס, דאלאס, בנגור. השדה הזה מכיל את הערכים [2, 0, 1]. האינדקס מתחיל ב-0 לציון ציון הביניים הראשון.

RouteLeg

כולל מקטע בין נקודות ציון שאינן via.

שדות
`distance_meters`	`int32` המרחק של המסלול במטרים.
`duration`	`Duration` משך הזמן שנדרש כדי לנווט בקטע. אם המדיניות `route_preference` מוגדרת לערך `TRAFFIC_UNAWARE`, הערך הזה זהה לערך `static_duration`. אם הערך של `route_preference` הוא `TRAFFIC_AWARE` או `TRAFFIC_AWARE_OPTIMAL`, הערך הזה מחושב על סמך מצב התנועה.
`static_duration`	`Duration` משך הזמן שחולף במסלול, מחושב בלי להביא בחשבון את מצב התנועה.
`polyline`	`Polyline` הקו הפוליגוני הכולל של הקטע הזה. זה כולל את הקו הפוליגוני של כל `step`.
`start_location`	`Location` מיקום ההתחלה של הקטע הזה. הוא עשוי להיות שונה מהשדה `origin` שסופק. לדוגמה, אם ה-`origin` שצוין לא נמצא ליד כביש, זוהי נקודה על הכביש.
`end_location`	`Location` מיקום הסיום של הרגל הזו. הוא עשוי להיות שונה מהשדה `destination` שסופק. לדוגמה, אם ה-`destination` שצוין לא נמצא ליד כביש, זוהי נקודה על הכביש.
`steps[]`	`RouteLegStep` מערך של שלבים לסימון קטעים בתוך הקטע הזה. כל שלב מייצג הוראת ניווט אחת.
`travel_advisory`	`RouteLegTravelAdvisory` כולל את המידע הנוסף שהמשתמשים צריכים לקבל לגביו, כמו מגבלות אפשריות של אזורי תנועה וכו' במסלול כלשהו.

RouteLegStep

כולל מקטע של RouteLeg. שלב תואם להוראת ניווט אחת. רגלי המסלול מורכבים ממדים.

שדות
`distance_meters`	`int32` המרחק של השלב הזה במטרים. במקרים מסוימים יכול להיות שהשדה הזה לא מכיל ערך.
`static_duration`	`Duration` משך הנסיעה בשלב הזה בלי להביא בחשבון את מצב התנועה. במקרים מסוימים יכול להיות שהשדה הזה לא מכיל ערך.
`polyline`	`Polyline` הקו הפוליגוני המשויך לשלב הזה.
`start_location`	`Location` מיקום ההתחלה של השלב הזה.
`end_location`	`Location` מיקום הסיום של השלב הזה.
`navigation_instruction`	`NavigationInstruction` הוראות ניווט.
`travel_advisory`	`RouteLegStepTravelAdvisory` כולל את המידע הנוסף שהמשתמשים צריכים לקבל לגביו, כמו הגבלה אפשרית של אזור התנועה בשלב הצעדים.

RouteLegStepTravelAdvisory

כולל את המידע הנוסף שהמשתמשים צריכים לקבל לגביו, כמו הגבלה אפשרית של אזור התנועה בשלב הצעדים.

שדות

שדות
`speed_reading_intervals[]`	`SpeedReadingInterval` מרווחי זמן לקריאה של מהירות המפרטים את צפיפות התנועה. רלוונטי להעדפות ניתוב `TRAFFIC_AWARE` ו-`TRAFFIC_AWARE_OPTIMAL`. המרווחים מכסים את כל הקו הפוליגוני של RouteLegStep ללא חפיפה. נקודת ההתחלה של מרווח מוגדר זהה לנקודת הסיום של המרווח הקודם. דוגמה: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

speed_reading_intervals[]

SpeedReadingInterval

מרווחי זמן לקריאה של מהירות המפרטים את צפיפות התנועה. רלוונטי להעדפות ניתוב TRAFFIC_AWARE ו-TRAFFIC_AWARE_OPTIMAL. המרווחים מכסים את כל הקו הפוליגוני של RouteLegStep ללא חפיפה. נקודת ההתחלה של מרווח מוגדר זהה לנקודת הסיום של המרווח הקודם.

דוגמה:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteLegTravelAdvisory

כולל את המידע הנוסף שהמשתמשים צריכים לקבל לגביו, כמו מגבלות אפשריות של אזורי תנועה וכו' במסלול כלשהו.

שדות

שדות
`toll_info`	`TollInfo` כוללת מידע על כבישי האגרה במסלול הספציפי. השדה הזה יאוכלס רק אם אנחנו צופים שיהיו כבישי אגרה. אם השדה הזה מוגדר אבל שדה המשנה estimated_price לא מאוכלס, פירוש הדבר הוא שהכביש מכיל כבישי אגרה, אבל אנחנו לא יודעים מה המחיר המשוער. אם השדה הזה לא קיים, אין כבישי אגרה.
`speed_reading_intervals[]`	`SpeedReadingInterval` מרווחי זמן לקריאה של מהירות המפרטים את צפיפות התנועה. רלוונטי להעדפות ניתוב `TRAFFIC_AWARE` ו-`TRAFFIC_AWARE_OPTIMAL`. המרווחים מכסים את כל הקו הפוליגוני של ה-RouteLg, ללא חפיפה. נקודת ההתחלה של מרווח מוגדר זהה לנקודת הסיום של המרווח הקודם. דוגמה: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

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

speed_reading_intervals[]

SpeedReadingInterval

מרווחי זמן לקריאה של מהירות המפרטים את צפיפות התנועה. רלוונטי להעדפות ניתוב TRAFFIC_AWARE ו-TRAFFIC_AWARE_OPTIMAL. המרווחים מכסים את כל הקו הפוליגוני של ה-RouteLg, ללא חפיפה. נקודת ההתחלה של מרווח מוגדר זהה לנקודת הסיום של המרווח הקודם.

דוגמה:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

יעד יחיד ל-ComputeRouteMatrixRequest

שדות

שדות
`waypoint`	`Waypoint` חובה. ציון דרך

waypoint

Waypoint

חובה. ציון דרך

RouteMatrixElement

כולל מידע על מסלולים שמחושב עבור צמד מקור/יעד ב-ComputeRouteMatrix API. ניתן לשדר את ה-Proto הזה ללקוח.

שדות
`origin_index`	`int32` אינדקס מבוסס אפס של מקור הבקשה.
`destination_index`	`int32` אינדקס מבוסס אפס של היעד בבקשה.
`status`	`Status` קוד הסטטוס של שגיאה לאלמנט הזה.
`condition`	`RouteMatrixElementCondition` מציין אם המסלול נמצא או לא. ללא תלות בסטטוס.
`distance_meters`	`int32` מרחק הנסיעה של המסלול, במטרים.
`duration`	`Duration` משך הזמן שנדרש כדי לנווט במסלול. אם מגדירים את `routing_preference` לערך `TRAFFIC_UNAWARE`, הערך הזה יהיה זהה לערך `static_duration`. אם מגדירים את הערך בשדה `routing_preference` לערך `TRAFFIC_AWARE` או לערך `TRAFFIC_AWARE_OPTIMAL`, הערך הזה מחושב על סמך מצב התנועה.
`static_duration`	`Duration` משך הנסיעה במסלול בלי להביא בחשבון את מצב התנועה.
`travel_advisory`	`RouteTravelAdvisory` מידע נוסף על המסלול. לדוגמה: מידע על הגבלות ומידע על כבישי אגרה
`fallback_info`	`FallbackInfo` במקרים מסוימים שבהם השרת לא יכול לחשב את המסלול עם ההעדפות הנתונים עבור צמד המקור/היעד הספציפי, יכול להיות שהוא יחזור להשתמש במצב חישוב אחר. כשמשתמשים במצב חלופי, השדה הזה מכיל מידע מפורט על התשובה החלופית. אחרת, השדה הזה לא מוגדר.

RouteMatrixElementCondition

המצב של המסלול שהוחזר.

טיפוסים בני מנייה (enum)
`ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED`	בשימוש רק אם הערך `status` של הרכיב לא תקין.
`ROUTE_EXISTS`	נמצא מסלול, והפרטים התואמים מולאו לגבי הרכיב.
`ROUTE_NOT_FOUND`	לא נמצא מסלול. שדות שמכילים פרטי מסלול, כמו `distance_meters` או `duration`, לא ימולאו ברכיב.

RouteMatrixOrigin

מקור יחיד ל-ComputeRouteMatrixRequest

שדות

שדות
`waypoint`	`Waypoint` חובה. נקודת ציון בנקודת המוצא
`route_modifiers`	`RouteModifiers` זה שינוי אופציונלי. מגבילי התאמה לכל מסלול שמבוסס על נקודת המוצא

waypoint

Waypoint

חובה. נקודת ציון בנקודת המוצא

route_modifiers

RouteModifiers

זה שינוי אופציונלי. מגבילי התאמה לכל מסלול שמבוסס על נקודת המוצא

RouteModifiers

כוללת קבוצה של תנאים אופציונליים שמתקיימים במהלך חישוב המסלולים.

שדות
`avoid_tolls`	`bool` ההגדרה קובעת אם להימנע מכבישי אגרה במקומות סבירים. תינתן עדיפות למסלולים שלא כוללים כבישי אגרה. רלוונטי רק למצבי הנסיעה `DRIVE` ו-`TWO_WHEELER`.
`avoid_highways`	`bool` מציינת אם להימנע מכבישים מהירים במקרים סבירים. תינתן העדפה למסלולים שאינם מכילים כבישים מהירים. רלוונטי רק למצבי הנסיעה `DRIVE` ו-`TWO_WHEELER`.
`avoid_ferries`	`bool` ההגדרה מציינת אם להימנע ממעבורות במקרים סבירים. תינתן עדיפות למסלולים שאינם כוללים נסיעות במעבורות. רלוונטי רק למצבי הנסיעה `DRIVE` ו`TWO_WHEELER`.
`avoid_indoor`	`bool` המדיניות מציינת אם להימנע מניווט בתוך מבנים במקרים סבירים. תינתן עדיפות למסלולים שאינם כוללים ניווט בתוך מבנים. רלוונטי רק למצב הנסיעה `WALK`.
`vehicle_info`	`VehicleInfo` מציין את פרטי הרכב.
`toll_passes[]`	`TollPass` כולל מידע על אישורי הנסיעה בכבישי אגרה. אם תספקו אישורי מעבר, ממשק ה-API ינסה להחזיר את מחיר הכרטיס. אם לא תספקו את אישורי המעבר לכבישי אגרה, ממשק ה-API מתייחס לכביש האגרה כלא ידוע ומנסה להחזיר את המחיר במזומן. רלוונטי רק למצבי הנסיעה drive ו-TWO_WHEELER.

RouteObjective

כולל יעד לאופטימיזציה באמצעות ComputeCustomRoutes.

שדות

שדות
`rate_card`	`RateCard` היעד RateCard.

rate_card

RateCard

היעד RateCard.

RateCard

כולל יעד של מסלול ב-RateCard.

שדות

שדות
`cost_per_minute`	`MonetaryCost` זה שינוי אופציונלי. עלות לדקה.
`cost_per_km`	`MonetaryCost` זה שינוי אופציונלי. עלות לקילומטר.
`include_tolls`	`bool` זה שינוי אופציונלי. האם לכלול את עלות האגרה בעלות הכוללת.

cost_per_minute

MonetaryCost

זה שינוי אופציונלי. עלות לדקה.

cost_per_km

MonetaryCost

זה שינוי אופציונלי. עלות לקילומטר.

include_tolls

bool

זה שינוי אופציונלי. האם לכלול את עלות האגרה בעלות הכוללת.

MonetaryCost

כולל את העלות שנוצלה בכרטיס המחיר.

שדות

שדות
`value`	`double` חובה. ערך העלות במטבע המקומי שהוסק מהבקשה.

value

double

חובה. ערך העלות במטבע המקומי שהוסק מהבקשה.

RouteTravelAdvisory

כולל את המידע הנוסף שצריך ליידע את המשתמש, כמו הגבלה אפשרית של אזור התנועה וכו'.

שדות

שדות
`toll_info`	`TollInfo` כולל מידע על כבישי האגרה במסלול. השדה הזה יאוכלס רק אם אנחנו צופים שיהיו כבישי אגרה. אם השדה הזה מוגדר אבל שדה המשנה estimated_price לא מאוכלס, פירוש הדבר הוא שהכביש מכיל כבישי אגרה, אבל אנחנו לא יודעים מה המחיר המשוער. אם השדה הזה לא מוגדר, סביר להניח שלא תהיה אגרה על המסלול.
`speed_reading_intervals[]`	`SpeedReadingInterval` מרווחי זמן לקריאה של מהירות המפרטים את צפיפות התנועה. רלוונטי להעדפות ניתוב `TRAFFIC_AWARE` ו-`TRAFFIC_AWARE_OPTIMAL`. המרווחים כוללים את כל הקו הפוליגוני של הנתיב, ללא חפיפה. נקודת ההתחלה של מרווח מוגדר זהה לנקודת הסיום של המרווח הקודם. דוגמה: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

כולל מידע על כבישי האגרה במסלול. השדה הזה יאוכלס רק אם אנחנו צופים שיהיו כבישי אגרה. אם השדה הזה מוגדר אבל שדה המשנה estimated_price לא מאוכלס, פירוש הדבר הוא שהכביש מכיל כבישי אגרה, אבל אנחנו לא יודעים מה המחיר המשוער. אם השדה הזה לא מוגדר, סביר להניח שלא תהיה אגרה על המסלול.

speed_reading_intervals[]

SpeedReadingInterval

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

דוגמה:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteTravelMode

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

טיפוסים בני מנייה (enum)
`TRAVEL_MODE_UNSPECIFIED`	לא צוין מצב נסיעה. ברירת המחדל היא `DRIVE`.
`DRIVE`	נוסעים ברכב נוסעים.
`BICYCLE`	רכיבה על אופניים.
`WALK`	נסיעה בהליכה.
`TWO_WHEELER`	רכב דו-גלגלי ממונע. למשל, אופנוע. לתשומת ליבכם: המצב הזה שונה ממצב הנסיעה של `BICYCLE`, שמכסה את מצב ההפעלה של אנשים.
`TAXI`	נסיעה במוניות ברישיון עשויה לאפשר לרכב לנסוע בנתיבי מוניות ייעודיים באזורים מסוימים. מצב TAXI הוא תכונה ניסיונית. אם לקוח מבקש מסלול TAXI בעיר שבה אין נתונים זמינים על נתיבי המוניות, מוחזר מסלול drive.

RoutingPreference

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

טיפוסים בני מנייה (enum)
`ROUTING_PREFERENCE_UNSPECIFIED`	לא צוינה העדפת ניתוב. ברירת המחדל היא `TRAFFIC_AWARE`.
`TRAFFIC_UNAWARE`	מחשב את המסלולים בלי להביא בחשבון את מצב התנועה. מתאים כשמצב התנועה לא משנה. השימוש בערך הזה מספק את זמן האחזור הנמוך ביותר.
`TRAFFIC_AWARE`	מחשבת מסלולים תוך התחשבות בתנאי התנועה. בניגוד ל-`TRAFFIC_AWARE_OPTIMAL`, חלק מהאופטימיזציות חלות כדי לצמצם באופן משמעותי את זמן האחזור.
`TRAFFIC_AWARE_OPTIMAL`	מחשבת את המסלולים תוך התחשבות בתנאי התנועה, בלי להחיל את רוב האופטימיזציות של הביצועים. השימוש בערך הזה מוביל לזמן אחזור ארוך ככל האפשר.

SpeedReadingInterval

מדד צפיפות התנועה בקטע רציף של קו פוליגוני או נתיב. בהינתן נתיב עם נקודות P_0, P_1, ... , P_N (אינדקס מבוסס אפס), ה- SpeedReadingInterval מגדיר מרווח ומתאר את התנועה באמצעות הקטגוריות הבאות.

שדות

שדות
`start_polyline_point_index`	`int32` האינדקס ההתחלתי של המרווח הזה בקו הפוליגוני. ב-JSON, כשהאינדקס הוא 0, נראה שהשדה לא מאוכלס.
`end_polyline_point_index`	`int32` אינדקס הסיום של המרווח הזה בקו הפוליגוני. ב-JSON, כשהאינדקס הוא 0, נראה שהשדה לא מאוכלס.
`speed`	`Speed` מהירות התנועה במרווח הזה.

start_polyline_point_index

int32

האינדקס ההתחלתי של המרווח הזה בקו הפוליגוני. ב-JSON, כשהאינדקס הוא 0, נראה שהשדה לא מאוכלס.

end_polyline_point_index

int32

אינדקס הסיום של המרווח הזה בקו הפוליגוני. ב-JSON, כשהאינדקס הוא 0, נראה שהשדה לא מאוכלס.

speed

Speed

מהירות התנועה במרווח הזה.

מהירות

סיווג מהירות של קו פוליגוני על סמך נתוני תנועה.

טיפוסים בני מנייה (enum)
`SPEED_UNSPECIFIED`	ערך ברירת המחדל. הערך הזה לא בשימוש.
`NORMAL`	מהירות רגילה, לא מזוהה האטה.
`SLOW`	זוהתה האטה, אבל לא נוצר עומס תנועה.
`TRAFFIC_JAM`	זוהה עומס תנועה.

TollInfo

כולל את פרטי האגרה בRoute או בRouteLeg.

שדות

שדות
`estimated_price[]`	`Money` הסכום הכספי של כבישי האגרה בשביל המסלול או המסלול המתאימים. הרשימה הזו מכילה סכום כספי של כל מטבע שצפוי לחייב תחנות האגרה. בדרך כלל הרשימה הזו תכלול רק פריט אחד למסלולים עם כבישי אגרה במטבע אחד. עבור נסיעות בינלאומיות, הרשימה הזו עשויה להכיל כמה פריטים כדי לשקף את כבישי האגרה במטבעות שונים.

estimated_price[]

Money

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

TollPass

רשימה של אישורי מעבר לכבישי אגרה ברחבי העולם שאנחנו תומכים בהם.

טיפוסים בני מנייה (enum)
`TOLL_PASS_UNSPECIFIED`	לא בשימוש. אם נעשה שימוש בערך הזה, הבקשה תיכשל.
`AU_ETOLL_TAG`	אחד מהספקים הרבים של מינויים לכבישי אגרה בסידני. https://www.myetoll.com.au
`AU_EWAY_TAG`	אחד מהספקים הרבים של מינויים לכבישי אגרה בסידני. https://www.tollpay.com.au/
`AU_LINKT`	מינוי לכביש אגרה בכל אוסטרליה פרטים נוספים זמינים בכתובת https://www.linkt.com.au/.
`AR_TELEPASE`	מינוי לכביש אגרה בארגנטינה. פרטים נוספים זמינים בכתובת https://telepase.com.ar
`BR_AUTO_EXPRESO`	מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://www.autoexpreso.com
`BR_CONECTCAR`	מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://conectcar.com.
`BR_MOVE_MAIS`	מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://movemais.com.
`BR_PASSA_RAPIDO`	מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://pasorapido.gob.do/
`BR_SEM_PARAR`	מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://www.semparar.com.br.
`BR_TAGGY`	מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://taggy.com.br.
`BR_VELOE`	מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://veloe.com.br/site/onde-usar.
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	מעבר גבול בין קנדה לארצות הברית.
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	מעבר גבול בין קנדה לארצות הברית.
`CA_US_BLUE_WATER_EDGE_PASS`	מעבר גבול עם ארצות הברית, אונטריו, קנדה למישיגן
`CA_US_CONNEXION`	מעבר גבול עם ארצות הברית, אונטריו, קנדה למישיגן
`CA_US_NEXUS_CARD`	מעבר גבול בין קנדה לארצות הברית.
`ID_E_TOLL`	אינדונזיה. כרטיס אלקטרוני שמסופק על ידי כמה בנקים שמשמשים לתשלום האגרות. כל הכרטיסים האלקטרוניים דרך בנקים מחויבים באופן זהה, כך שנדרש רק ערך enum אחד. לדוגמה Bank Mandiri https://www.bankmandiri.co.id/e-money BCA https://www.bca.co.id/flazz BNI https://www.bni.co.id/id-id/ebanking/tapcash
`IN_FASTAG`	India.‎
`IN_LOCAL_HP_PLATE_EXEMPT`	הודו, פטור מרישיון של מדינת HP.
`MX_TAG_IAVE`	כבישי אגרה במקסיקו.
`MX_TAG_TELEVIA`	חברה לכבישי אגרה במקסיקו. אחד מהארגונים רבים שפועלים במקסיקו סיטי. אפשר לקרוא פרטים נוספים בכתובת https://www.televia.com.mx.
`MX_VIAPASS`	כבישי אגרה במקסיקו. פרטים נוספים זמינים בכתובת https://www.viapass.com.mx/viapass/web_home.aspx.
`US_AL_FREEDOM_PASS`	אלבמה, ארה"ב.
`US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS`	AK, ארה"ב
`US_CA_FASTRAK`	קנדה, ארה"ב.
`US_CA_FASTRAK_CAV_STICKER`	מעיד על כך שלנהג יש אישור FasTrak כלשהו בנוסף למדבקה של כלי הרכב האוויר הנקי (CAV) שהונפק על ידי משרד הרישוי. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	קולורדו, ארה"ב.
`US_CO_GO_PASS`	קולורדו, ארה"ב.
`US_DE_EZPASSDE`	גרמניה, ארה"ב.
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	פלורידה, ארה"ב.
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	פלורידה, ארה"ב.
`US_FL_EPASS`	פלורידה, ארה"ב.
`US_FL_GIBA_TOLL_PASS`	פלורידה, ארה"ב.
`US_FL_LEEWAY`	פלורידה, ארה"ב.
`US_FL_SUNPASS`	פלורידה, ארה"ב.
`US_FL_SUNPASS_PRO`	פלורידה, ארה"ב.
`US_IL_EZPASSIL`	אילינוי, ארה"ב.
`US_IL_IPASS`	אילינוי, ארה"ב.
`US_IN_EZPASSIN`	הודו, ארה"ב.
`US_KS_BESTPASS_HORIZON`	קנזס, ארה"ב.
`US_KS_KTAG`	קנזס, ארה"ב.
`US_KS_NATIONALPASS`	קנזס, ארה"ב.
`US_KS_PREPASS_ELITEPASS`	קנזס, ארה"ב.
`US_KY_RIVERLINK`	קנטקי, ארה"ב.
`US_LA_GEAUXPASS`	לואיזיאנה, ארה"ב.
`US_LA_TOLL_TAG`	לואיזיאנה, ארה"ב.
`US_MA_EZPASSMA`	מסצ'וסטס
`US_MD_EZPASSMD`	מרי, ארה"ב.
`US_ME_EZPASSME`	ME, ארה"ב.
`US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD`	מישיגן, ארה"ב.
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	מישיגן, ארה"ב.
`US_MI_IQ_PROX_CARD`	מישיגן, ארה"ב.
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	מישיגן, ארה"ב.
`US_MI_NEXPRESS_TOLL`	מישיגן, ארה"ב.
`US_MN_EZPASSMN`	מינסוטה, ארה"ב.
`US_NC_EZPASSNC`	קרוליינה הצפונית, ארה"ב.
`US_NC_PEACH_PASS`	קרוליינה הצפונית, ארה"ב.
`US_NC_QUICK_PASS`	קרוליינה הצפונית, ארה"ב.
`US_NH_EZPASSNH`	NH, ארה"ב.
`US_NJ_DOWNBEACH_EXPRESS_PASS`	ניו ג'רזי, ארה"ב.
`US_NJ_EZPASSNJ`	ניו ג'רזי, ארה"ב.
`US_NY_EXPRESSPASS`	ניו יורק, ארה"ב.
`US_NY_EZPASSNY`	ניו יורק, ארה"ב.
`US_OH_EZPASSOH`	אוהיו, ארה"ב.
`US_PA_EZPASSPA`	פנסילבניה, ארה"ב.
`US_RI_EZPASSRI`	RI, ארה"ב.
`US_SC_PALPASS`	SC, ארה"ב.
`US_TX_BANCPASS`	טקסס, ארה"ב.
`US_TX_DEL_RIO_PASS`	טקסס, ארה"ב.
`US_TX_EFAST_PASS`	טקסס, ארה"ב.
`US_TX_EAGLE_PASS_EXPRESS_CARD`	טקסס, ארה"ב.
`US_TX_EPTOLL`	טקסס, ארה"ב.
`US_TX_EZ_CROSS`	טקסס, ארה"ב.
`US_TX_EZTAG`	טקסס, ארה"ב.
`US_TX_LAREDO_TRADE_TAG`	טקסס, ארה"ב.
`US_TX_PLUSPASS`	טקסס, ארה"ב.
`US_TX_TOLLTAG`	טקסס, ארה"ב.
`US_TX_TXTAG`	טקסס, ארה"ב.
`US_TX_XPRESS_CARD`	טקסס, ארה"ב.
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	יוטה, ארה"ב.
`US_VA_EZPASSVA`	וירג'יניה, ארה"ב.
`US_WA_BREEZEBY`	וושינגטון, ארה"ב.
`US_WA_GOOD_TO_GO`	וושינגטון, ארה"ב.
`US_WV_EZPASSWV`	WV, ארה"ב.
`US_WV_MEMORIAL_BRIDGE_TICKETS`	WV, ארה"ב.
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	WV, ארה"ב.

יחידות

קבוצת ערכים המציינים את יחידת המידה שמשמשת בתצוגה.

טיפוסים בני מנייה (enum)
`UNITS_UNSPECIFIED`	לא צוינו יחידות מידה. ברירת המחדל היא יחידת המידה שהוסקו על סמך הבקשה.
`METRIC`	יחידות מדידה מטריות.
`IMPERIAL`	יחידות מידה אימפריאליות (אנגלית).

VehicleEmissionType

קבוצת ערכים שמתארים את סוג הפליטה של הרכב. רלוונטי רק למצב הנסיעה drive.

טיפוסים בני מנייה (enum)
`VEHICLE_EMISSION_TYPE_UNSPECIFIED`	לא ציינת את סוג הפליטה. השתמשו ב-GASOLINE כברירת מחדל.
`GASOLINE`	רכב עם דלק בנזין/בנזין.
`ELECTRIC`	רכב חשמלי.
`HYBRID`	דלק היברידי (למשל בנזין + רכב חשמלי).

VehicleInfo

כולל את פרטי הרכב, למשל התו האחרון בלוחית הרישוי.

שדות

שדות
`emission_type`	`VehicleEmissionType` מיועד לתיאור של סוג הפליטה של הרכב. רלוונטי רק למצב הנסיעה drive.

emission_type

VehicleEmissionType

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

נקודת ציון

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

שדות
`via`	`bool` סימון ציון הדרך הזה כציון דרך ולא כנקודת עצירה. עבור כל ציון דרך שאינו דרך הבקשה, התשובה מצרפת רשומה למערך `legs` כדי לספק את הפרטים לגבי עצירות ביניים באותו קטע בנסיעה. יש להגדיר את הערך הזה כ-True אם רוצים שהמסלול יעבור דרך נקודת הציון הזו בלי לעצור. ציוני דרך לא יגרמו להוספת כניסה למערך `legs`, אבל הם כן מנתבים את המסלול דרך ציון הדרך. אפשר להגדיר את הערך הזה רק בנקודות ציון ביניים. הבקשה תיכשל אם תגדירו את השדה הזה בנקודות ציון במסוף. אם ComputeRoutesRequest.Optimize_waypoint_order מוגדר כ-True, לא ניתן להגדיר את השדה הזה כ-true; אחרת, הבקשה תיכשל.
`vehicle_stopover`	`bool` מציין שנקודת הדרך מיועדת לעצירה של כלי רכב, כשהכוונה היא לאיסוף או להורדה. אם מגדירים את הערך הזה, המסלול המחושב לא יכלול ציוני דרך שאינם `via` בכבישים שלא מתאימים לאיסוף ולהורדה. האפשרות הזו פועלת רק במצבי נסיעה `DRIVE` ו`TWO_WHEELER`, וכשה`location_type` הוא `location`.
`side_of_road`	`bool` מציין שמיקום ציון הדרך הזה נועד לתת לרכב העדפה בצד מסוים של הכביש. כשמגדירים את הערך הזה, המסלול עובר דרך המיקום כדי שהרכב יוכל לעצור בצד הכביש שאליו נוטה המיקום ממרכז הכביש. האפשרות הזו פועלת רק עבור 'Drive' ו-'TWO_WHEELER' ואם במאפיין סוג המיקום מופיע הערך 'location_type' מוגדר כ'מיקום'.
שדה איחוד `location_type`. דרכים שונות לייצוג מיקום. `location_type` יכול להיות רק אחת מהאפשרויות הבאות:
`location`	`Location` נקודה שמצוינת באמצעות קואורדינטות גיאוגרפיות, כולל כותרת אופציונלית.
`place_id`	`string` מזהה המקום של נקודת העניין המשויך לציון הדרך.