Package google.maps.routes.v1

אינדקס

RoutesPreferred

ה-Routes Preferred API.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

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

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

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

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

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

הערה: לשיטה הזו צריך לציין אנונימיזציה של שדות תגובה בקלט. אפשר לספק את האנונימיזציה של שדות התגובה באמצעות הפרמטר של כתובת ה-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 נתמך עכשיו.
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. אם אין אפשרות לחשב את המסלול באמצעות Tracking_preference המבוקש על ידי הלקוח, הוא יחזור למצב ניתוב אחר. במקרה הזה, הערכים fallback_routing_mode ו-route_mode_fallback_reason משמשים להעברת מצב הניתוב החלופי שבו נעשה שימוש, וכן לסיבת החלופה.

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

שדות
routing_mode

FallbackRoutingMode

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

FallbackReason

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

FallbackRouteObjective

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

FallbackRouteObjective

RouteObjective משמש לתשובה.

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

ComputeRouteMatrixRequest

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

שדות
origins[]

RouteMatrixOrigin

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

  • בכל מקרה, מספר הרכיבים (מקורות × יעדים) לא יכול להיות גדול מ-625.
  • מספר הרכיבים (מקורות × יעדים) לא יכול להיות גדול מ-100 אם הערך Outline_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 אם לא מוצגת בקשה למסלולים.optimized_intermediate_waypoint_index בכותרת X-Goog-FieldMask, הבקשה תיכשל. אם ההגדרה OptimizeWaypointOrder מוגדרת כ-False, הערך ComputeRoutesResponse.optimized_intermediate_waypoint_index ריק.

ComputeRoutesResponse

ComputeRoutes את הודעת התגובה.

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

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

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

FallbackRoutingMode

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

טיפוסים בני מנייה (enums)
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.

תמרון

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

טיפוסים בני מנייה (enums)
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. מחזירה את סוג הקו polyline. ברירת המחדל היא code_polyline. הערך של polyline_type יכול להיות רק אחת מהאפשרויות הבאות:
encoded_polyline

string

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

Struct

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

PolylineEncoding

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

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

PolylineQuality

קבוצת ערכים שמציינים את איכות ה-polyline.

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

הקו הפוליגוני הכולל עבור קטע זה. כולל קו 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

כולל מידע לגבי כבישי אגרה ב-RouteLeg הספציפי. השדה הזה יאוכלס רק אם אנחנו צופים שיהיו כבישי אגרה ב-RouteLeg. אם השדה הזה מוגדר אבל שדה המשנה destination_price לא יאוכלס, אנחנו צופים שהכביש יכלול כבישי אגרה, אבל אנחנו לא יודעים מחיר משוער. אם השדה הזה לא קיים, לא יחול אגרה על RouteLeg.
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

התנאי של המסלול שמוחזר.

טיפוסים בני מנייה (enums)
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

כולל מידע על כבישי אגרה. השדה הזה יאוכלס רק אם אנחנו צופים שיהיו כבישי אגרה. אם השדה הזה מוגדר אבל שדה המשנה destination_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

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

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

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

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

RoutingPreference

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

טיפוסים בני מנייה (enums)
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

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

מהירות

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

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

TollInfo

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

שדות
estimated_price[]

Money

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

TollPass

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

טיפוסים בני מנייה (enums)
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 הודו, פטור מרישיון לוחית רישוי של מדינה בארה"ב.
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) שהונפק על ידי ה-DMV. 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, ארה"ב.

יחידות

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

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

VehicleEmissionType

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

טיפוסים בני מנייה (enums)
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'.
שדה איחוד location_type. דרכים שונות לייצג מיקום. הערך של location_type יכול להיות רק אחת מהאפשרויות הבאות:
location

Location

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

string

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