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

Package google.maps.routing.v2

אינדקס

Routes (ממשק)
ComputeRouteMatrixRequest (הודעה)
ComputeRouteMatrixRequest.ExtraComputation (enum)
ComputeRoutesRequest (הודעה)
ComputeRoutesRequest.ExtraComputation (enum)
ComputeRoutesRequest.ReferenceRoute (enum)
ComputeRoutesResponse (הודעה)
FallbackInfo (הודעה)
FallbackReason (enum)
FallbackRoutingMode (enum)
GeocodedWaypoint (הודעה)
GeocodingResults (הודעה)
LocalizedTime (הודעה)
Location (הודעה)
Maneuver (enum)
NavigationInstruction (הודעה)
Polyline (הודעה)
PolylineDetails (הודעה)
PolylineDetails.FlyoverInfo (הודעה)
PolylineDetails.NarrowRoadInfo (הודעה)
PolylineDetails.PolylinePointIndex (הודעה)
PolylineDetails.RoadFeatureState (enum)
PolylineEncoding (enum)
PolylineQuality (enum)
Route (הודעה)
Route.RouteLocalizedValues (הודעה)
RouteLabel (enum)
RouteLeg (הודעה)
RouteLeg.RouteLegLocalizedValues (הודעה)
RouteLeg.StepsOverview (הודעה)
RouteLeg.StepsOverview.MultiModalSegment (הודעה)
RouteLegStep (הודעה)
RouteLegStep.RouteLegStepLocalizedValues (הודעה)
RouteLegStepTransitDetails (הודעה)
RouteLegStepTransitDetails.TransitDetailsLocalizedValues (הודעה)
RouteLegStepTransitDetails.TransitStopDetails (הודעה)
RouteLegStepTravelAdvisory (הודעה)
RouteLegTravelAdvisory (הודעה)
RouteMatrixDestination (הודעה)
RouteMatrixElement (הודעה)
RouteMatrixElement.LocalizedValues (הודעה)
RouteMatrixElementCondition (enum)
RouteMatrixOrigin (הודעה)
RouteModifiers (הודעה)
RouteTravelAdvisory (הודעה)
RouteTravelMode (enum)
RoutingPreference (enum)
SpeedReadingInterval (הודעה)
SpeedReadingInterval.Speed (enum)
TollInfo (הודעה)
TollPass (enum)
TrafficModel (enum)
TransitAgency (הודעה)
TransitLine (הודעה)
TransitPreferences (הודעה)
TransitPreferences.TransitRoutingPreference (enum)
TransitPreferences.TransitTravelMode (enum)
TransitStop (הודעה)
TransitVehicle (הודעה)
TransitVehicle.TransitVehicleType (enum)
Units (enum)
VehicleEmissionType (enum)
VehicleInfo (הודעה)
Waypoint (הודעה)

מסלולים

Routes API.

ComputeRouteMatrix

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

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 ממליצה לא להשתמש במסכת השדה של התגובה עם התו הכללי לחיפוש (*), כי:

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

ComputeRoutes

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

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), כי:

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

ComputeRouteMatrixRequest

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

שדות
`origins[]`	`RouteMatrixOrigin` חובה. מערך מקורות, שמגדיר את השורות במטריצה של התשובה. יש כמה הגבלות על הגודל של מקורות ויעדים: הסכום של מספר מקורות הנתונים + מספר היעדים שצוינו כ-`place_id` או כ-`address` לא יכול להיות גדול מ-50. המכפלה של מספר מקורות x מספר יעדים לא יכולה להיות גדולה מ-625 בכל מקרה. אם הערך של routing_preference מוגדר כ-`TRAFFIC_AWARE_OPTIMAL`, המכפלה של מספר מקורות × מספר יעדים לא יכולה להיות גדולה מ-100. אם הערך של travel_mode מוגדר כ-`TRANSIT`, המכפלה של מספר המקוריים × מספר היעדים לא יכולה להיות גדולה מ-100.
`destinations[]`	`RouteMatrixDestination` חובה. מערך של יעדים, שקובע את העמודות של מטריצה התגובה.
`travel_mode`	`RouteTravelMode` זה שינוי אופציונלי. מציין את אמצעי התחבורה.
`routing_preference`	`RoutingPreference` זה שינוי אופציונלי. מציין איך לחשב את המסלול. השרת מנסה להשתמש בעדיפות הניתוב שנבחרה כדי לחשב את המסלול. אם העדפת הניתוב גורמת לשגיאה או לזמן אחזור ארוך במיוחד, תוחזר שגיאה. אפשר לציין את האפשרות הזו רק כאשר הערך של `travel_mode` הוא `DRIVE` או `TWO_WHEELER`, אחרת הבקשה תיכשל.
`departure_time`	`Timestamp` זה שינוי אופציונלי. שעת היציאה. אם לא תגדירו את הערך הזה, ערך ברירת המחדל שלו יהיה השעה שבה שלחתם את הבקשה. הערה: אפשר לציין `departure_time` בעבר רק כשהערך של `RouteTravelMode` מוגדר כ-`TRANSIT`.
`arrival_time`	`Timestamp` זה שינוי אופציונלי. שעת ההגעה. הערה: אפשר להגדיר את השדה הזה רק אם הערך של `RouteTravelMode` הוא `TRANSIT`. אפשר לציין `departure_time` או `arrival_time`, אבל לא את שניהם.
`language_code`	`string` זה שינוי אופציונלי. קוד השפה לפי BCP-47, למשל 'en-US' או 'sr-Latn'. מידע נוסף זמין במאמר מזהה המקום (locale) של Unicode. ברשימת תמיכת השפות מפורטות השפות הנתמכות. אם לא מציינים את הערך הזה, שפת התצוגה נובעת מהמיקום של המקור הראשון.
`region_code`	`string` זה שינוי אופציונלי. קוד האזור, שמצוין כערך בן שני תווים של דומיין ברמה עליונה עם קוד מדינה (ccTLD). מידע נוסף זמין במאמר דומיינים ברמה העליונה עם קוד מדינה.
`units`	`Units` זה שינוי אופציונלי. מציין את יחידות המידה של שדות התצוגה.
`extra_computations[]`	`ExtraComputation` זה שינוי אופציונלי. רשימה של חישובים נוספים שעשויים לשמש להשלמתה של הבקשה. הערה: החישובים הנוספים האלה עשויים להחזיר שדות נוספים בתגובה. צריך לציין את השדות הנוספים האלה גם במסכת השדות כדי שהם יוחזרו בתגובה.
`traffic_model`	`TrafficModel` זה שינוי אופציונלי. ההנחות שישמשו לחישוב הזמן בפקקים. ההגדרה הזו משפיעה על הערך שמוחזר בשדה duration ב-`RouteMatrixElement`, שמכיל את משך הזמן המשוער בתנועה על סמך ממוצעים היסטוריים. `RoutingPreference` עד `TRAFFIC_AWARE_OPTIMAL` ו-`RouteTravelMode` עד `DRIVE`. ערך ברירת המחדל הוא `BEST_GUESS` אם מבקשים נתוני תנועה ולא מציינים את הערך `TrafficModel`.
`transit_preferences`	`TransitPreferences` זה שינוי אופציונלי. העדפות שמשפיעות על המסלול שמוחזר למסלולים מסוג `TRANSIT`. הערה: אפשר לציין `transit_preferences` רק כשהערך של `RouteTravelMode` הוא `TRANSIT`.

ExtraComputation

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

טיפוסים בני מנייה (enum)
`EXTRA_COMPUTATION_UNSPECIFIED`	לא בשימוש. בקשות שמכילות את הערך הזה ייכשל.
`TOLLS`	פרטי התשלום על כבישי אגרה של רכיבי המטריצה.

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` זה שינוי אופציונלי. שעת היציאה. אם לא תגדירו את הערך הזה, ערך ברירת המחדל שלו יהיה השעה שבה שלחתם את הבקשה. הערה: אפשר לציין `departure_time` בעבר רק כשהערך של `RouteTravelMode` מוגדר כ-`TRANSIT`. נסיעות בתחבורה ציבורית זמינות עד 7 ימים בעבר או 100 ימים בעתיד.
`arrival_time`	`Timestamp` זה שינוי אופציונלי. שעת ההגעה. הערה: אפשר להגדיר את השדה הזה רק אם הערך של `RouteTravelMode` הוא `TRANSIT`. אפשר לציין `departure_time` או `arrival_time`, אבל לא את שניהם. נסיעות בתחבורה ציבורית זמינות עד 7 ימים בעבר או 100 ימים בעתיד.
`compute_alternative_routes`	`bool` זה שינוי אופציונלי. השדה מציין אם לחשב מסלולים חלופיים בנוסף למסלול. לא יוחזרו מסלולים חלופיים לבקשות שיש בהן נקודות ציון ביניים.
`route_modifiers`	`RouteModifiers` זה שינוי אופציונלי. קבוצת תנאים שצריך לעמוד בהם, שמשפיעה על האופן שבו המערכת מחשבת מסלולים.
`language_code`	`string` זה שינוי אופציונלי. קוד השפה לפי BCP-47, למשל 'en-US' או 'sr-Latn'. מידע נוסף זמין במאמר מזהה המקום (locale) של Unicode. ברשימת תמיכת השפות מפורטות השפות הנתמכות. אם לא מציינים את הערך הזה, שפת התצוגה נובעת מהמיקום של בקשת המסלול.
`region_code`	`string` זה שינוי אופציונלי. קוד האזור, שמצוין כערך בן שני תווים של דומיין ברמה עליונה עם קוד מדינה (ccTLD). מידע נוסף זמין במאמר דומיינים ברמה העליונה עם קוד מדינה.
`units`	`Units` זה שינוי אופציונלי. מציין את יחידות המידה של שדות התצוגה. השדות האלה כוללים את השדה `instruction` ב-`NavigationInstruction`. יחידות המידה שמשמשות למסלול, לשלב, למרחק של שלב ולמשך הזמן לא מושפעות מהערך הזה. אם לא מציינים את הערך הזה, יחידות התצוגה נגזרות מהמיקום של המקור הראשון.
`optimize_waypoint_order`	`bool` זה שינוי אופציונלי. אם הערך מוגדר כ-true, השירות ינסה למזער את העלות הכוללת של המסלול על ידי שינוי הסדר של נקודות העצירה הביניים שצוינו. הבקשה נכשלת אם אחד מנקודות הציון הביניים הוא נקודת ציון מסוג `via`. משתמשים ב-`ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index` כדי למצוא את הסדר החדש. אם לא מבקשים את `ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index` בכותרת `X-Goog-FieldMask`, הבקשה נכשלת. אם `optimize_waypoint_order` מוגדר כ-false, השדה `ComputeRoutesResponse.optimized_intermediate_waypoint_index` יהיה ריק.
`requested_reference_routes[]`	`ReferenceRoute` זה שינוי אופציונלי. מציין אילו מסלולי עזר צריך לחשב כחלק מהבקשה, בנוסף למסלול ברירת המחדל. מסלול עזר הוא מסלול עם מטרת חישוב מסלול שונה מזו של מסלול ברירת המחדל. לדוגמה, חישוב מסלול העזרה `FUEL_EFFICIENT` מתייחס לפרמטרים שונים שיוצרים מסלול יעיל במיוחד מבחינת צריכת הדלק. כשמשתמשים בתכונה הזו, מחפשים את `route_labels` במסלולים שמתקבלים.
`extra_computations[]`	`ExtraComputation` זה שינוי אופציונלי. רשימה של חישובים נוספים שעשויים לשמש להשלמתה של הבקשה. הערה: החישובים הנוספים האלה עשויים להחזיר שדות נוספים בתגובה. צריך לציין את השדות הנוספים האלה גם במסכת השדות כדי שהם יוחזרו בתגובה.
`traffic_model`	`TrafficModel` זה שינוי אופציונלי. ההנחות שישמשו לחישוב הזמן בפקקים. ההגדרה הזו משפיעה על הערך שמוחזר בשדה duration ב-`Route` וב-`RouteLeg`, שמכיל את משך הזמן המשוער בתנועה על סמך ממוצעים היסטוריים. `TrafficModel` זמין רק לבקשות שבהן `RoutingPreference` מוגדר כ-`TRAFFIC_AWARE_OPTIMAL` ו-`RouteTravelMode` מוגדר כ-`DRIVE`. ערך ברירת המחדל הוא `BEST_GUESS` אם מבקשים נתוני תנועה ולא מציינים את הערך `TrafficModel`.
`transit_preferences`	`TransitPreferences` זה שינוי אופציונלי. העדפות שמשפיעות על המסלול שמוחזר למסלולים מסוג `TRANSIT`. הערה: אפשר לציין `transit_preferences` רק כשהערך של `RouteTravelMode` הוא `TRANSIT`.

ExtraComputation

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

טיפוסים בני מנייה (enum)
`EXTRA_COMPUTATION_UNSPECIFIED`	לא בשימוש. בקשות שמכילות את הערך הזה ייכשל.
`TOLLS`	פרטי האגרה במסלולים.
`FUEL_CONSUMPTION`	צריכת הדלק המשוערת במסלולים.
`TRAFFIC_ON_POLYLINE`	קווים פוליגונים עם מידע על מצב התנועה במסלולים.
`HTML_FORMATTED_NAVIGATION_INSTRUCTIONS`	`NavigationInstructions` מוצג כמחרוזת טקסט בפורמט HTML. התוכן הזה נועד לקריאה כפי שהוא. התוכן הזה מיועד לתצוגה בלבד. אין לנתח אותו באופן פרוגרמטי.
`FLYOVER_INFO_ON_POLYLINE`	מידע על מעבר בכביש מהיר במסלולים. כדי להחזיר את המידע הזה, צריך לציין את מסכת השדות `routes.polyline_details.flyover_info`. נכון לעכשיו, הנתונים האלה יאוכלסו רק בערים מסוימות בהודו. התכונה הזו ניסיונית, והמק"ט או החיוב עשויים להשתנות.
`NARROW_ROAD_INFO_ON_POLYLINE`	מידע על כבישים צרים במסלולים. כדי להחזיר את המידע הזה, צריך לציין את מסכת השדות `routes.polyline_details.narrow_road_info`. נכון לעכשיו, הנתונים האלה יאוכלסו רק בערים מסוימות בהודו. התכונה הזו ניסיונית, והמק"ט או החיוב עשויים להשתנות.

ReferenceRoute

מסלול עזר נתמך ב-ComputeRoutesRequest.

טיפוסים בני מנייה (enum)

REFERENCE_ROUTE_UNSPECIFIED לא בשימוש. בקשות שמכילות את הערך הזה נכשלות.

FUEL_EFFICIENT מסלול חסכוני בדלק.

טיפוסים בני מנייה (enum)
`REFERENCE_ROUTE_UNSPECIFIED`	לא בשימוש. בקשות שמכילות את הערך הזה נכשלות.
`FUEL_EFFICIENT`	מסלול חסכוני בדלק.
`SHORTER_DISTANCE`	מסלול עם מרחק נסיעה קצר יותר. זוהי תכונה ניסיונית. בבקשות מסוג `DRIVE`, התכונה הזו נותנת עדיפות למרחק קצר יותר על פני נוחות הנסיעה. לדוגמה, יכול להיות שהיא תעדיף דרכים מקומיות במקום כבישים מהירים, דרכים עפר, נסיעה דרך חניונים וכו'. התכונה הזו לא מחזירה תמרון שמערכת מפות Google יודעת שהוא לא חוקי. בבקשות `BICYCLE` ו-`TWO_WHEELER`, התכונה הזו מחזירה מסלולים דומים לאלה שמוחזרים כשלא מציינים את `requested_reference_routes`. התכונה הזו לא תואמת לאף אמצעי נסיעה אחר, לנתיב עם נקודות עצירה ביניים או ל-`optimize_waypoint_order`. בקשות כאלה ייכשל. עם זאת, אפשר להשתמש בו עם כל `routing_preference`.

SHORTER_DISTANCE

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

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

בבקשות BICYCLE ו-TWO_WHEELER, התכונה הזו מחזירה מסלולים דומים לאלה שמוחזרים כשלא מציינים את requested_reference_routes.

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

ComputeRoutesResponse

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

שדות

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

routes[]

Route

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

fallback_info

FallbackInfo

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

geocoding_results

GeocodingResults

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

FallbackInfo

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

שדות

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

routing_mode

FallbackRoutingMode

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

reason

FallbackReason

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

FallbackReason

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

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

FallbackRoutingMode

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

טיפוסים בני מנייה (enum)
`FALLBACK_ROUTING_MODE_UNSPECIFIED`	לא בשימוש.
`FALLBACK_TRAFFIC_UNAWARE`	מציין שנעשה שימוש ב-`TRAFFIC_UNAWARE` `RoutingPreference` כדי לחשב את התשובה.
`FALLBACK_TRAFFIC_AWARE`	מציין שנעשה שימוש ב-`TRAFFIC_AWARE` `RoutingPreference` כדי לחשב את התשובה.

GeocodedWaypoint

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

שדות
`geocoder_status`	`Status` קוד הסטטוס שמתקבל מהפעלת הגיאוקודינג.
`type[]`	`string` הסוגים של התוצאה, בצורת אפס תגי סוג או יותר. סוגי הכתובות הנתמכים: סוגי כתובות וסוגי רכיבי כתובות.
`partial_match`	`bool` המשמעות היא שהמקודד הגיאוגרפי לא החזיר התאמה מדויקת לבקשה המקורית, אבל הוא הצליח להתאים חלק מהכתובת המבוקשת. מומלץ לבדוק את הבקשה המקורית כדי לראות אם יש בה שגיאות כתיב או כתובת חלקית.
`place_id`	`string` מזהה המקום של התוצאה הזו.
`intermediate_waypoint_request_index`	`int32` האינדקס של נקודת הציון הביניים התואמת בבקשה. השדה מאוכלס רק אם ציון הדרך התואם הוא ציון דרך ביניים.

GeocodingResults

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

שדות

שדות
`origin`	`GeocodedWaypoint` נקודת ציון במקור שהומרו לה קואורדינטות.
`destination`	`GeocodedWaypoint` נקודת ציון של יעד שהומרו לקואורדינטות.
`intermediates[]`	`GeocodedWaypoint` רשימה של נקודות ציון ביניים שהוגדרו במיקום גיאוגרפי, שכל אחת מהן מכילה שדה אינדקס שתואם למיקום של נקודת הציון לפי תחילת הספירה לפי 0, לפי הסדר שבו הן צוינו בבקשה.

origin

GeocodedWaypoint

נקודת ציון במקור שהומרו לה קואורדינטות.

destination

GeocodedWaypoint

נקודת ציון של יעד שהומרו לקואורדינטות.

intermediates[]

GeocodedWaypoint

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

LocalizedTime

תיאור מקומי של הזמן.

שדות

שדות
`time`	`LocalizedText` השעה שצוינה כמחרוזת באזור זמן נתון.
`time_zone`	`string` מכיל את אזור הזמן. הערך הוא שם אזור הזמן כפי שהוא מוגדר במסד הנתונים של אזור הזמן IANA, למשל 'America/New_York'.

time

LocalizedText

השעה שצוינה כמחרוזת באזור זמן נתון.

time_zone

string

מכיל את אזור הזמן. הערך הוא שם אזור הזמן כפי שהוא מוגדר במסד הנתונים של אזור הזמן IANA, למשל 'America/New_York'.

מיקום

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

שדות

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

lat_lng

LatLng

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

heading

Int32Value

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

תמרון

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

טיפוסים בני מנייה (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`	משמש לציון שינוי בשם הרחוב.

NavigationInstruction

השירות מכיל את הוראות הניווט ל-RouteLegStep.

שדות

maneuver

Maneuver

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

instructions

string

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

מצולע פתוח

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

שדות

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

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

encoded_polyline

string

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

geo_json_linestring

Struct

מציין קו פתוח באמצעות פורמט GeoJSON LineString.

PolylineDetails

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

שדות

שדות
`flyover_info[]`	`FlyoverInfo` פרטי מעבר בגובה נמוך לאורך הקו הפוליגוני.
`narrow_road_info[]`	`NarrowRoadInfo` פרטי כבישים צרים לאורך הקו הפוליגוני.

flyover_info[]

FlyoverInfo

פרטי מעבר בגובה נמוך לאורך הקו הפוליגוני.

narrow_road_info[]

NarrowRoadInfo

פרטי כבישים צרים לאורך הקו הפוליגוני.

FlyoverInfo

הנתונים האלה מכילים מידע על גשרים תלויים לאורך קו הפוליגון.

שדות

שדות
`flyover_presence`	`RoadFeatureState` פלט בלבד. מציין אם יש גשר מעל כביש במקטע מסוים של קו הפוליגון.
`polyline_point_index`	`PolylinePointIndex` המיקום של מידע שקשור ל'מבט ממעוף הציפור' לאורך הקו הפוליגוני.

flyover_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

המיקום של מידע שקשור ל'מבט ממעוף הציפור' לאורך הקו הפוליגוני.

NarrowRoadInfo

מכיל מידע על כבישים צרים לאורך קו הפוליגון.

שדות

שדות
`narrow_road_presence`	`RoadFeatureState` פלט בלבד. מציין אם יש כביש צר בקטע מסוים של הקו הפוליגוני.
`polyline_point_index`	`PolylinePointIndex` המיקום של מידע שקשור לכביש צר לאורך הקו הפוליגוני.

narrow_road_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

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

PolylinePointIndex

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

שדות

שדות
`start_index`	`int32` אינדקס ההתחלה של הפריט הזה בקו הפוליגון.
`end_index`	`int32` אינדקס הסיום של הפרט הזה בקו הפוליגון.

start_index

int32

אינדקס ההתחלה של הפריט הזה בקו הפוליגון.

end_index

int32

אינדקס הסיום של הפרט הזה בקו הפוליגון.

RoadFeatureState

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

טיפוסים בני מנייה (enum)
`ROAD_FEATURE_STATE_UNSPECIFIED`	המצב של מאפיין הכביש לא חושב (ערך ברירת המחדל).
`EXISTS`	מאפיין הכביש קיים.
`DOES_NOT_EXIST`	תכונה של דרך לא קיימת.

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

נתיב

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

שדות
`route_labels[]`	`RouteLabel` תוויות של `Route` שיעזרו לכם לזהות מאפיינים ספציפיים של המסלול כדי להשוות אותם למאפיינים של מסלולים אחרים.
`legs[]`	`RouteLeg` אוסף של שלבים (קטעי נתיב בין נקודות ציון) שמרכיבים את המסלול. כל מקטע תואם לנסיעה בין שני `Waypoints` שאינם `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` התיבה התוחמת (bounding box) של אזור התצוגה של הקו הפוליגוני.
`travel_advisory`	`RouteTravelAdvisory` מידע נוסף על המסלול.
`optimized_intermediate_waypoint_index[]`	`int32` אם מגדירים את `optimize_waypoint_order` כ-true, השדה הזה מכיל את הסדר המותאם של נקודות ציון ביניים. אחרת, השדה הזה יהיה ריק. לדוגמה, אם מזינים את הפרטים הבאים: מקור: תל אביב; נקודות דרך ביניים: ירושלים, חיפה, תל אביב; יעד: ניו יורק, והסדר האופטימלי של נקודות הדרך הביניים הוא תל אביב, ירושלים, חיפה, השדה הזה יכיל את הערכים [2, 0, 1]. האינדקס מתחיל ב-0 לנקודת הציון הראשונה שצוינה בקלט.
`localized_values`	`RouteLocalizedValues` ייצוגים של מאפיינים של `Route` בטקסט.
`route_token`	`string` אסימון אטום שאפשר להעביר ל-Navigation SDK כדי לשחזר את המסלול במהלך הניווט, ובמקרה של שינוי מסלול, לשמור על הכוונה המקורית שלכם כשיצרתם את המסלול. מתייחסים לאסימון הזה כאל blob אטום. אין להשוות את הערך שלו בין בקשות שונות, כי הערך עשוי להשתנות גם אם השירות מחזיר את אותו מסלול בדיוק. הערה: השדה `Route.route_token` זמין רק לבקשות שבהן הערך של `ComputeRoutesRequest.routing_preference` מוגדר כ-`TRAFFIC_AWARE` או כ-`TRAFFIC_AWARE_OPTIMAL`. אין תמיכה ב-`Route.route_token` בבקשות עם נקודות דרך מסוג 'דרך'.
`polyline_details`	`PolylineDetails` מכיל מידע על פרטים לאורך קו הפוליגון.

RouteLocalizedValues

ייצוגים של טקסט של נכסים מסוימים.

שדות
`distance`	`LocalizedText` מרחק הנסיעה שמוצג בטקסט.
`duration`	`LocalizedText` משך הזמן, שמוצג בטקסט ומותאם לאזור של השאילתה. מביאים בחשבון את מצב התנועה. הערה: אם לא ביקשת מידע על תנועה, הערך הזה זהה לערך של `static_duration`.
`static_duration`	`LocalizedText` משך הנסיעה ללא התחשבות בתנאי התנועה, שמוצג בטקסט.
`transit_fare`	`LocalizedText` מחיר הנסיעה בתחבורה הציבורית שמוצג בטקסט.

RouteLabel

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

טיפוסים בני מנייה (enum)
`ROUTE_LABEL_UNSPECIFIED`	ברירת מחדל – לא בשימוש.
`DEFAULT_ROUTE`	מסלול ברירת המחדל 'הטוב ביותר' שהוחזר לחישוב המסלול.
`DEFAULT_ROUTE_ALTERNATE`	חלופה למסלול ברירת המחדל 'הטוב ביותר'. מסלולים כאלה יחזרו כאשר `compute_alternative_routes` יצוין.
`FUEL_EFFICIENT`	מסלול חסכוני בדלק. מסלולים שמסומנים בערך הזה עוברים אופטימיזציה לפי פרמטרים של נסיעה חסכונית, כמו צריכת דלק.
`SHORTER_DISTANCE`	מסלול עם מרחק נסיעה קצר יותר. זוהי תכונה ניסיונית.

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` מכיל את המידע הנוסף שצריך להודיע עליו למשתמש, כמו הגבלות אפשריות באזורי תנועה, על מקטע דרך.
`localized_values`	`RouteLegLocalizedValues` ייצוגים של מאפיינים של `RouteLeg` בטקסט.
`steps_overview`	`StepsOverview` מידע כללי על השלבים ב-`RouteLeg` הזה. השדה הזה מתמלא רק עבור מסלולי תחבורה ציבורית.

RouteLegLocalizedValues

ייצוגים של טקסט של נכסים מסוימים.

שדות

distance

LocalizedText

מרחק הנסיעה שמוצג בטקסט.

duration

LocalizedText

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

static_duration

LocalizedText

משך הנסיעה ללא התחשבות בתנאי התנועה, שמוצג בטקסט.

StepsOverview

הצגת סקירה כללית של רשימה של RouteLegStep.

שדות

שדות
`multi_modal_segments[]`	`MultiModalSegment` סיכום של מידע על פלחים שונים של `RouteLeg.steps` עם מגוון מודלים. השדה הזה לא מאוכלס אם ה-`RouteLeg` לא מכיל פלחים מרובת-מודלים בשלבים.

multi_modal_segments[]

MultiModalSegment

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

MultiModalSegment

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

שדות
`navigation_instruction`	`NavigationInstruction` NavigationInstruction לפלח מרובה המצבים.
`travel_mode`	`RouteTravelMode` אמצעי התחבורה של הפלח הרב-מודלי.
`step_start_index`	`int32` האינדקס התואם של `RouteLegStep`, שהוא ההתחלה של פלח רב-מודלי.
`step_end_index`	`int32` האינדקס התואם של `RouteLegStep` שהוא הסוף של מקטע רב-מודלי.

RouteLegStep

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

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

RouteLegStepLocalizedValues

ייצוגים של טקסט של נכסים מסוימים.

שדות

distance

LocalizedText

מרחק הנסיעה שמוצג בטקסט.

static_duration

LocalizedText

משך הנסיעה ללא התחשבות בתנאי התנועה, שמוצג בטקסט.

RouteLegStepTransitDetails

מידע נוסף על RouteLegStep שקשור למסלולים של TRANSIT.

שדות
`stop_details`	`TransitStopDetails` מידע על תחנות היציאה וההגעה של השלב.
`localized_values`	`TransitDetailsLocalizedValues` ייצוגים של מאפיינים של `RouteLegStepTransitDetails` בטקסט.
`headsign`	`string` מציין את הכיוון שבו צריך לנסוע בקו הזה, כפי שמצוין ברכב או בתחנת המוצא. לרוב, הכיוון הוא התחנה הסופית.
`headway`	`Duration` מציין את הזמן הצפוי כמשך הזמן בין היציאות מאותה עצירה בשעה הזו. לדוגמה, אם הערך של 'מרווח זמן בין נסיעות' הוא 600 שניות, צפויה המתנה של עשר דקות אם תחמיצו את האוטובוס.
`transit_line`	`TransitLine` מידע על קו התחבורה הציבורית שבו השתמשתם בשלב הזה.
`stop_count`	`int32` מספר עצירות הביניים מהתחנה המוצאת ועד לתחנת היעד. הספירה הזו כוללת את תחנת הגעתו, אבל לא כוללת את תחנת היציאה. לדוגמה, אם המסלול יוצא מתחנה א', עובר דרך תחנות ב' ו-ג' ומגיע לתחנה ד', `stop_count` הפונקציה מחזירה את הערך 3.
`trip_short_text`	`string` הטקסט שמופיע בלוחות הזמנים ובשלטי הנסיעה כדי לזהות נסיעה בתחבורה ציבורית לנוסעים. הטקסט צריך לזהות באופן ייחודי נסיעה בתוך יום שירות. לדוגמה, '538' הוא `trip_short_text` של רכבת Amtrak שיוצאת מסן חוזה, קליפורניה בשעה 15:10 בימי חול לכיוון סקרמנטו, קליפורניה.

TransitDetailsLocalizedValues

תיאורים מותאמים לשוק המקומי של ערכים של RouteTransitDetails.

שדות

שדות
`arrival_time`	`LocalizedTime` הזמן בפורמט טקסט עם אזור זמן תואם.
`departure_time`	`LocalizedTime` הזמן בפורמט טקסט עם אזור זמן תואם.

arrival_time

LocalizedTime

הזמן בפורמט טקסט עם אזור זמן תואם.

departure_time

LocalizedTime

הזמן בפורמט טקסט עם אזור זמן תואם.

TransitStopDetails

פרטים על תחנות התחבורה הציבורית של קו RouteLegStep.

שדות
`arrival_stop`	`TransitStop` מידע על תחנת העצירה של השלב.
`arrival_time`	`Timestamp` זמן ההגעה המשוער של השלב.
`departure_stop`	`TransitStop` מידע על תחנת היציאה של השלב.
`departure_time`	`Timestamp` מועד המראה המשוער של השלב.

RouteLegStepTravelAdvisory

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

שדות

שדות
`speed_reading_intervals[]`	`SpeedReadingInterval` הערה: השדה הזה לא מאוכלס כרגע.

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

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` חובה. ציון דרך ליעד

waypoint

Waypoint

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

RouteMatrixElement

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

שדות
`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` במקרים מסוימים, אם השרת לא מצליח לחשב את המסלול עם ההעדפות הנתונות לזוג המקור/היעד הספציפי הזה, הוא עשוי לעבור לשימוש במצב חישוב אחר. כשמשתמשים במצב חלופי, השדה הזה מכיל מידע מפורט על התשובה החלופית. אחרת, השדה לא מוגדר.
`localized_values`	`LocalizedValues` ייצוגים של מאפיינים של `RouteMatrixElement` בטקסט.
`origin_index`	`int32` אינדקס שמתחיל באפס של המקור בבקשה.
`destination_index`	`int32` אינדקס מבוסס-אפס של היעד בבקשה.

LocalizedValues

ייצוגים של טקסט של נכסים מסוימים.

שדות
`distance`	`LocalizedText` מרחק הנסיעה שמוצג בטקסט.
`duration`	`LocalizedText` משך הזמן שמוצג בטקסט, תוך התחשבות בתנאי התנועה. הערך הזה זהה לערך של static_duration אם לא התבקשו נתוני תנועה.
`static_duration`	`LocalizedText` משך הזמן שמוצג בטקסט, בלי להביא בחשבון את תנאי התנועה.
`transit_fare`	`LocalizedText` מחיר הנסיעה בתחבורה הציבורית שמוצג בטקסט.

RouteMatrixElementCondition

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

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

RouteMatrixOrigin

מקור יחיד ל-ComputeRouteMatrixRequest

שדות

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

waypoint

Waypoint

חובה. ציון הדרך של המקור

route_modifiers

RouteModifiers

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

RouteModifiers

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

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

RouteTravelAdvisory

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

שדות
`toll_info`	`TollInfo` מכיל מידע על כבישי אגרה במסלול. השדה הזה יאוכלס רק אם צפויים חיובים על כבישי אגרה במסלול. אם השדה הזה מוגדר, אבל שדה המשנה `estimatedPrice` לא מאוכלס, המשמעות היא שהמסלול מכיל כבישי אגרה אבל המחיר המשוער לא ידוע. אם השדה הזה לא מוגדר, סימן שאין צפויים חיובים על כבישי אגרה במסלול.
`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).`
`fuel_consumption_microliters`	`int64` צריכת הדלק הצפויה במיקרוליטר.
`route_restrictions_partially_ignored`	`bool` יכול להיות שבמסלול שהוחזר יש הגבלות שלא מתאימות לאופן התחבורה המבוקש או למאפייני המסלול.
`transit_fare`	`Money` אם הוא קיים, מכיל את עלות הכרטיס או את עלות הנסיעה הכוללת במסלול הזה. הנכס הזה מוחזר רק לבקשות `TRANSIT` ורק למסלולים שבהם מידע על עלות הנסיעה זמין לכל שלבי התחבורה הציבורית.

RouteTravelMode

קבוצת ערכים שמשמשת לציון אופן הנסיעה. הערה: המסלולים WALK,‏ BICYCLE ו-TWO_WHEELER נמצאים בגרסת בטא, ולפעמים חסרים בהם מדרכות ברורות, נתיבים להולכי רגל או שבילי אופניים. חובה להציג את האזהרה הזו למשתמש בכל המסלולים להולכי רגל, לאופניים ולכלי רכב דו-גלגליים שמוצגים באפליקציה.

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

RoutingPreference

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

טיפוסים בני מנייה (enum)
`ROUTING_PREFERENCE_UNSPECIFIED`	לא צוינה העדפת ניתוב. ברירת המחדל היא `TRAFFIC_UNAWARE`.
`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` האינדקס ההתחלתי של מרווח הזמן הזה בקו הפוליגון.
`end_polyline_point_index`	`int32` האינדקס הסופי של המרווח הזה בקו הפוליגון.
שדה האיחוד `speed_type`. הערך של `speed_type` יכול להיות רק אחת מהאפשרויות הבאות:
`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`	הודו, פטור של לוחית רישוי במדינת האלמהברה.
`JP_ETC`	Japan ETC. מערכת אלקטרונית אלחוטית לחיוב על כבישי אגרה. https://www.go-etc.jp/
`JP_ETC2`	יפן 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`	גרמניה, ארה"ב.
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	FL, USA.
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	FL, USA.
`US_FL_EPASS`	FL, USA.
`US_FL_GIBA_TOLL_PASS`	FL, USA.
`US_FL_LEEWAY`	FL, USA.
`US_FL_SUNPASS`	FL, USA.
`US_FL_SUNPASS_PRO`	FL, USA.
`US_IL_EZPASSIL`	IL, ארה"ב.
`US_IL_IPASS`	IL, ארה"ב.
`US_IN_EZPASSIN`	אינדיאנה, ארה"ב.
`US_KS_BESTPASS_HORIZON`	KS, ארה"ב.
`US_KS_KTAG`	KS, ארה"ב.
`US_KS_NATIONALPASS`	KS, ארה"ב.
`US_KS_PREPASS_ELITEPASS`	KS, ארה"ב.
`US_KY_RIVERLINK`	KY, ארה"ב.
`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`	MI, ארה"ב.
`US_MI_BCPASS`	MI, ארה"ב.
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	MI, ארה"ב.
`US_MI_IQ_PROX_CARD`	MI, ארה"ב. סוג הכרטיס הזה הוצא משימוש כי הוא כבר לא קיים. הפריט הזה הוצא משימוש!
`US_MI_IQ_TAG`	MI, ארה"ב.
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	MI, ארה"ב.
`US_MI_NEXPRESS_TOLL`	MI, ארה"ב.
`US_MN_EZPASSMN`	MN, ארה"ב.
`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`	UT, ארה"ב.
`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`	WV, ארה"ב
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	WV, ארה"ב.

TrafficModel

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

טיפוסים בני מנייה (enum)
`TRAFFIC_MODEL_UNSPECIFIED`	לא בשימוש. אם יצוין, ערך ברירת המחדל יהיה `BEST_GUESS`.
`BEST_GUESS`	המשמעות היא שהערך המוחזר של `duration` אמור להיות האומדן הטוב ביותר של זמן הנסיעה, על סמך מה שידוע על תנאי התנועה ההיסטוריים ועל התנועה בזמן אמת. ככל שהתאריך `departure_time` קרוב יותר לתאריך הנוכחי, כך תנועת הגולשים בזמן אמת הולכת ונעשית חשובה יותר.
`PESSIMISTIC`	המשמעות היא שהמשך הזמן שיוחזר אמור להיות ארוך יותר מזמני הנסיעה בפועל ברוב הימים, אבל בימים מסוימים עם תנאי תנועה גרועים במיוחד, ייתכן שהמשך הזמן יחרוג מהערך הזה.
`OPTIMISTIC`	המשמעות היא שהמשך הזמן שהמערכת מחזירה אמור להיות קצר יותר מזמני הנסיעה בפועל ברוב הימים, אבל בימים מסוימים שבהם תנאי התנועה טובים במיוחד, זמן הנסיעה עשוי להיות קצר יותר מהערך הזה.

TransitAgency

חברת תחבורה ציבורית שמפעילה קו תחבורה ציבורית.

שדות

name

string

השם של חברת התחבורה הציבורית.

phone_number

string

מספר הטלפון של חברת התחבורה הציבורית בפורמט שמותאם לאזור.

uri

string

ה-URI של חברת התחבורה הציבורית.

TransitLine

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

שדות
`agencies[]`	`TransitAgency` חברת התחבורה הציבורית (או החברות) שמפעילה את קו התחבורה הציבורית הזה.
`name`	`string` השם המלא של קו התחבורה הציבורית. לדוגמה, '8 Avenue Local'.
`uri`	`string` כתובת ה-URI של קו התחבורה הציבורית הזה, כפי שסופקה על ידי חברת התחבורה הציבורית.
`color`	`string` הצבע הנפוץ בסמלי הדרך של הקו הזה. מוצגים בפורמט הקסדצימלי.
`icon_uri`	`string` ה-URI של הסמל שמשויך לשורה הזו.
`name_short`	`string` השם המקוצר של קו התחבורה הציבורית הזה. בדרך כלל השם הזה יהיה מספר שורה, כמו 'M7' או '355'.
`text_color`	`string` הצבע הנפוץ בטקסט של השילוט של הקו הזה. מוצגים בפורמט הקסדצימלי.
`vehicle`	`TransitVehicle` סוג הרכב שפועל בקווי התחבורה הציבורית האלה.

TransitPreferences

העדפות למסלולים שמבוססים על TRANSIT, שמשפיעות על המסלול שמוחזר.

שדות

allowed_travel_modes[]

TransitTravelMode

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

routing_preference

TransitRoutingPreference

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

TransitRoutingPreference

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

טיפוסים בני מנייה (enum)
`TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED`	לא צוינה העדפה.
`LESS_WALKING`	המערכת תעדיף מסלול עם כמות הליכה מוגבלת.
`FEWER_TRANSFERS`	האפשרות הזו מציינת שהמסלול המחושב צריך להעדיף מספר מוגבל של החלפות.

TransitTravelMode

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

טיפוסים בני מנייה (enum)
`TRANSIT_TRAVEL_MODE_UNSPECIFIED`	לא צוין אמצעי תחבורה ציבורית.
`BUS`	נסיעה באוטובוס.
`SUBWAY`	נסיעה ברכבת תחתית.
`TRAIN`	נסיעה ברכבת.
`LIGHT_RAIL`	נסיעה ברכבת קלה או בחשמלית.
`RAIL`	נסיעה ברכבת. זה שווה ערך לשילוב של `SUBWAY`, `TRAIN` ו-`LIGHT_RAIL`.

TransitStop

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

שדות

name

string

השם של תחנת התחבורה הציבורית.

location

Location

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

TransitVehicle

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

שדות
`name`	`LocalizedText` השם של הרכב, באותיות רישיות.
`type`	`TransitVehicleType` סוג הרכב שבו נעשה שימוש.
`icon_uri`	`string` ה-URI של סמל שמשויך לסוג הרכב הזה.
`local_icon_uri`	`string` ה-URI של הסמל המשויך לסוג הרכב הזה, על סמך סמלי התחבורה המקומית.

TransitVehicleType

סוג כלי התחבורה במסלולי התחבורה הציבורית.

טיפוסים בני מנייה (enum)
`TRANSIT_VEHICLE_TYPE_UNSPECIFIED`	לא בשימוש.
`BUS`	אוטובוס.
`CABLE_CAR`	כלי רכב שפועל באמצעות כבל, בדרך כלל על הקרקע. רכבלים יכולים להיות מסוג `GONDOLA_LIFT`.
`COMMUTER_TRAIN`	רכבת פרברים.
`FERRY`	מעבורת.
`FUNICULAR`	רכב שנמשך במעלה מדרון תלול באמצעות כבל. בדרך כלל, רכבל מורכב משני קרונות, כאשר כל קרון משמש כמשקל נגד לקרון השני.
`GONDOLA_LIFT`	רכבל.
`HEAVY_RAIL`	רכבת כבדה.
`HIGH_SPEED_TRAIN`	רכבת מהירה.
`INTERCITY_BUS`	אוטובוס בין-עירוני.
`LONG_DISTANCE_TRAIN`	רכבת למרחקים ארוכים.
`METRO_RAIL`	תחבורה ציבורית ברכבת קלה.
`MONORAIL`	רכבת מונורייל.
`OTHER`	כל שאר כלי הרכב.
`RAIL`	רכבת.
`SHARE_TAXI`	מונית שיתופית היא סוג של אוטובוס עם אפשרות להוריד ולקחת נוסעים בכל מקום במסלול.
`SUBWAY`	רכבת קלה תת-קרקעית.
`TRAM`	רכבת קלה מעל פני השטח.
`TROLLEYBUS`	טרוליבוס.

יחידות

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

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

VehicleEmissionType

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

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

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` מציין שהמיקום של נקודת הציון הזו מיועד להעדפה של כלי הרכב לעצור בצד מסוים של הכביש. כשמגדירים את הערך הזה, המסלול עובר דרך המיקום כדי שהרכב יוכל לעצור בצד הכביש שאליו המיקום מוטה ממרכז הכביש. האפשרות הזו פועלת רק ב-`DRIVE` וב-`TWO_WHEELER` `RouteTravelMode`.
שדה האיחוד `location_type`. דרכים שונות לייצוג מיקום. הערך של `location_type` יכול להיות רק אחת מהאפשרויות הבאות:
`location`	`Location` נקודה שצוינה באמצעות קואורדינטות גיאוגרפיות, כולל כיוון אופציונלי.
`place_id`	`string` מזהה המקום של נקודת העניין שמשויך לנקודת הציון.
`address`	`string` כתובת שאנשים יכולים לקרוא או קוד Plus. פרטים נוספים זמינים בכתובת https://plus.codes.