Package google.maps.routes.v1

אינדקס

RoutesPreferred

ממשק ה-API המועדף של Routes.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

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

הערה: השיטה הזו מחייבת לציין אנונימיזציה של שדות תגובה בקלט. אפשר לספק את המסכה של שדות התגובה באמצעות הפרמטר $fields או fields של כתובת ה-URL, או באמצעות הכותרת 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 של כתובת ה-URL, או באמצעות הכותרת 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)

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

הערה: בשיטה הזו צריך לציין מסכה של שדה תגובה בקלט. אפשר לספק את המסכה של שדה התגובה באמצעות פרמטר כתובת ה-URL $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 וב-'TWO_WHEELER'.
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'. מידע נוסף זמין במאמר מזהה המקום (locale) של Unicode. במאמר שפות תמיכה אפשר למצוא את רשימת השפות הנתמכות. אם לא מציינים את הערך הזה, המערכת מסיקה את שפת התצוגה מהמיקום של בקשת המסלול.
units

Units

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

ComputeCustomRoutesResponse

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

שדות
routes[]

CustomRoute

המסלולים 'הכי טובים' בשביל היעד של המסלול להזנת הקלט.
fastest_route

CustomRoute

המסלול המהיר ביותר.
shortest_route

CustomRoute

מסלול העזרה הקצר ביותר.
fallback_info

FallbackInfo

מידע חלופי למסלולים מותאמים אישית.

FallbackInfo

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

  1. אם הלקוח לא יכול לחשב את המסלול באמצעות ה-routing_preference שהלקוח ביקש, הוא יחזור למצב ניתוב אחר. במקרה כזה, השדות fallback_routing_mode ו-routing_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 ומגדיר את include_tolls כ-true, ואין ל-Google נתונים על מחירי כבישי אגרה עבור המסלול, ה-API חוזר לאפשרות RateCard בלי להביא בחשבון את מחיר כבישי האגרה.

ComputeRouteMatrixRequest

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

שדות
origins[]

RouteMatrixOrigin

חובה. מערך מקורות, שקובע את השורות של מטריצת התגובות. יש כמה הגבלות גודל על העוצמה (cardinality) של המקורות והיעדים:

  • מספר הרכיבים (מקורות × יעדים) לא יכול להיות גדול מ-625 בכל מקרה.
  • אם הערך של routing_preference מוגדר כ-TRAFFIC_AWARE_OPTIMAL, מספר הרכיבים (מקור × יעד) לא יכול להיות גדול מ-100.
  • מספר נקודות הדרך (המקור + היעד) שצוינו כ-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'. מידע נוסף זמין במאמר מזהה המקום (locale) של Unicode. במאמר שפות תמיכה אפשר למצוא את רשימת השפות הנתמכות. אם לא מציינים את הערך הזה, המערכת מסיקה את שפת התצוגה מהמיקום של בקשת המסלול.
units

Units

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

bool

אם האפשרות optimizeWaypointOrder מוגדרת כ-true, המערכת תנסה לשנות את הסדר של נקודות הדרך הביניים שצוינו כדי למזער את העלות הכוללת של המסלול. אם אחת מנקודות הביניים היא דרך ציון דרך, הבקשה תיכשל. משתמשים ב-ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index כדי למצוא את הסדר החדש. אם אין בקשה ל-routes.optimized_intermediate_waypoint_index בכותרת X-Goog-FieldMask, הבקשה תיכשל. אם המדיניות optimize_waypoint_order מוגדרת כ-False, ComputeRoutesResponse.optimized_intermediate_waypoint_index ריקה.

ComputeRoutesResponse

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

שדות
routes[]

Route

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

FallbackInfo

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

CustomRoute

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

שדות
route

Route

המסלול שנחשב ל'הטוב ביותר' לצורך יעד המסלול שהוזן.
token

string

אסימון מסלול בקידוד base64 שמתאים לאינטרנט, שניתן להעביר ל-NavSDK. האסימון מאפשר ל-NavSDK לשחזר את המסלול במהלך הניווט, ובמקרה של שינוי מסלול, לשמור על הכוונה המקורית כשמפעילים את RoutesPreferred 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 יש לפנות ימינה בכיכר.
DEPART תמרון ראשוני.
NAME_CHANGE משמש לציון שינוי בשם הרחוב.
שדות
maneuver

Maneuver

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

string

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

מצולע פתוח

תיבת תכולה של קו מרובה (polyline) מקודד.

שדות
שדה האיחוד 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, הוא מכיל את הסדר המותאם של נקודות הדרך הביניים. אחרת, השדה הזה ריק. לדוגמה, נניח שהקלט הוא: מוצא: LA; תחנות ביניים: Dallas,‏ Bangor,‏ Phoenix; יעד: New York, והסדר האופטימלי של נקודות הציון הביניים הוא: Phoenix,‏ Dallas,‏ Bangor. במקרה כזה, השדה הזה מכיל את הערכים [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

הערה: השדה הזה לא מלא כרגע.

RouteLegTravelAdvisory

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

שדות
toll_info

TollInfo

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

SpeedReadingInterval

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

דוגמה:

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

כשהערך מוגדר כ-true, המערכת תנסה להימנע מכבישי אגרה במקרים שבהם זה הגיוני, ותעדיף מסלולים שלא כוללים כבישי אגרה. רלוונטי רק למצבי הנסיעה DRIVE ו-TWO_WHEELER.
avoid_highways

bool

אם המדיניות מוגדרת כ-True, היא נמנעת מכבישים מהירים במידת הסבירות, ומעניקה עדיפות למסלולים שאינם מכילים כבישים מהירים. המאפיין הזה רלוונטי רק לסוגי התחבורה DRIVE ו-TWO_WHEELER.
avoid_ferries

bool

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

bool

אם המדיניות מוגדרת כ-True, המערכת נמנעת מניווט בתוך מבנים במקרים סבירים, כך שיש עדיפות למסלולים שלא כוללים ניווט בתוך מבנים. רלוונטי רק למצב הנסיעה WALK.
vehicle_info

VehicleInfo

מציין את פרטי הרכב.
toll_passes[]

TollPass

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

RouteObjective

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

שדות
שדה האיחוד objective. יעד המסלול. הערך של objective יכול להיות רק אחת מהאפשרויות הבאות:
rate_card

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 הוא תכונה ניסיונית. אם הלקוח מבקש מסלול לנסיעה במונית בעיר שבה נתוני נתיב המוניות לא זמינים, המערכת תחזיר מסלול לנסיעה ברכב.

RoutingPreference

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

טיפוסים בני מנייה (enum)
ROUTING_PREFERENCE_UNSPECIFIED לא צוינה העדפת ניתוב. ברירת המחדל היא TRAFFIC_AWARE.
TRAFFIC_UNAWARE חישוב המסלולים בלי להביא בחשבון את תנאי התנועה בזמן אמת. מתאים כשתנאי התנועה לא חשובים או לא רלוונטיים. השימוש בערך הזה מניב את זמן האחזור הנמוך ביותר. הערה: ב-RouteTravelMode Drive וב-TWO_WHEELER, המסלול ומשך הזמן שנבחרו מבוססים על רשת הכבישים ועל מצב התנועה שמשתנה לפי הזמן הממוצע, ולא על מצב הכבישים הנוכחיים. כתוצאה מכך, המסלולים עשויים לכלול כבישים שסגורים באופן זמני. התוצאות של בקשה מסוימת עשויות להשתנות עם הזמן, עקב שינויים ברשת הכבישים, עדכון תנאי התנועה הממוצעים ואופי המבוזר של השירות. התוצאות עשויות גם להשתנות בין מסלולים כמעט זהים בכל שלב או תדירות.
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

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

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.
JP_ETC Japan ETC. מערכת אלחוטית אלקטרונית לאיסוף כבישי אגרה. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. גרסה חדשה של ETC עם הנחה נוספת ותקשורת דו-כיוונית בין מכשירים ברכבים ואנטנות בדרך. https://www.go-etc.jp/etc2/index.html
MX_IAVE מקסיקו https://iave.capufe.gob.mx/#/
MX_PASE מקסיקו https://www.pase.com.mx
MX_QUICKPASS מקסיקו https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA מקסיקו http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE מקסיקו
MX_TAG_TELEVIA חברה למינויים לכביש אגרה במקסיקו. אחד מהארגונים רבים שפועלים במקסיקו סיטי. פרטים נוספים זמינים בכתובת https://www.televia.com.mx.
MX_TELEVIA חברה לכבישי אגרה במקסיקו. אחת מהחברות הרבות שפועלות במקסיקו סיטי. https://www.televia.com.mx
MX_VIAPASS כבישי אגרה במקסיקו. פרטים נוספים זמינים בכתובת https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, ארה"ב.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, ארה"ב
US_CA_FASTRAK קנדה, ארה"ב.
US_CA_FASTRAK_CAV_STICKER המשמעות היא לנהג יש כרטיס FasTrak כלשהו בנוסף לסטיקר 'כלי רכב לאוויר נקי' (CAV) שהונפק על ידי DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL קולורדו, ארה"ב.
US_CO_GO_PASS קולורדו, ארה"ב.
US_DE_EZPASSDE DE, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, ארה"ב.
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 FL, ארה"ב.
US_IL_EZPASSIL IL, ארה"ב.
US_IL_IPASS אילינוי, ארה"ב.
US_IN_EZPASSIN אינדיאנה, ארה"ב.
US_KS_BESTPASS_HORIZON KS, ארה"ב.
US_KS_KTAG KS, ארה"ב.
US_KS_NATIONALPASS KS, ארה"ב.
US_KS_PREPASS_ELITEPASS KS, ארה"ב.
US_LA_GEAUXPASS לוס אנג'לס, ארה"ב.
US_LA_TOLL_TAG לוס אנג'לס, ארה"ב.
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD מרילנד, ארה"ב.
US_ME_EZPASSME ME, ארה"ב.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD מישיגן, ארה"ב.
US_MI_BCPASS מישיגן, ארה"ב.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG מישיגן, ארה"ב.
US_MI_IQ_PROX_CARD

MI, ארה"ב. סוג הכרטיס הזה הוצא משימוש כי הוא כבר לא קיים.
US_MI_IQ_TAG מישיגן, ארה"ב.
US_MI_MACKINAC_BRIDGE_MAC_PASS מישיגן, ארה"ב.
US_MI_NEXPRESS_TOLL MI, ארה"ב.
US_MN_EZPASSMN מינסוטה, ארה"ב.
US_NC_EZPASSNC צפון קרוליינה, ארה"ב.
US_NC_PEACH_PASS קרוליינה הצפונית, ארה"ב.
US_NC_QUICK_PASS קרוליינה הצפונית, ארה"ב.
US_NH_EZPASSNH ניו המפשייר, ארה"ב.
US_NJ_DOWNBEACH_EXPRESS_PASS ניו ג'רזי, ארה"ב.
US_NJ_EZPASSNJ ניו ג'רזי, ארה"ב.
US_NY_EXPRESSPASS ניו יורק, ארה"ב.
US_NY_EZPASSNY ניו יורק, ארה"ב.
US_OH_EZPASSOH אוהיו, ארה"ב.
US_PA_EZPASSPA PA, ארה"ב.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, ארה"ב.
US_TX_AVI_TAG טקסס, ארה"ב.
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_FUEGO_TAG טקסס, ארה"ב.
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 VA, ארה"ב.
US_WA_BREEZEBY וושינגטון, ארה"ב.
US_WA_GOOD_TO_GO וושינגטון, ארה"ב.
US_WV_EZPASSWV WV, ארה"ב.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, ארה"ב.
US_WV_MOV_PASS וירג'יניה המערבית, ארה"ב
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 RouteTravelMode.

נקודת ציון

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

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

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

Location

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

string

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