Package google.maps.routes.v1

אינדקס

RoutesPreferred

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

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.

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.

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.

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 יש שני סוגים של חלופות:

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

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

שדות
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

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

CustomRoute

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

שדות
route

Route

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

token

string

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

FallbackInfo

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

שדות
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.

תמרון

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

טיפוסים בני מנייה (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 יש לפנות ימינה בכיכר.
שדות
maneuver

Maneuver

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

instructions

string

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

מצולע פתוח

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

שדות
שדה איחוד 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).

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).

RouteMatrixDestination

יעד יחיד ל-ComputeRouteMatrixRequest

שדות
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

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

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.

RateCard

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

שדות
cost_per_minute

MonetaryCost

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

cost_per_km

MonetaryCost

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

include_tolls

bool

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

MonetaryCost

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

שדות
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).

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

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

מהירות

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

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

TollInfo

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

שדות
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_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.

נקודת ציון

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

שדות
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

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