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.BridgeInfo (הודעה)
• ‫PolylineDetails.FlyoverInfo (הודעה)
• ‫PolylineDetails.NarrowRoadInfo (הודעה)
• ‫PolylineDetails.PolylinePointIndex (הודעה)
• ‫PolylineDetails.RestrictionInfo (הודעה)
• PolylineDetails.RoadFeatureState (enum)
• ‫PolylineDetails.SkywayInfo (הודעה)
• ‫PolylineDetails.TunnelInfo (הודעה)
• 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 (הודעה)
• VehicleInfo.HazardousGoodsType (enum)
• ‫VehicleInfo.TrailerInfo (הודעה)
• ‫Waypoint (הודעה)

מסלולים

‫Routes API.

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

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

ComputeRouteMatrixRequest

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

שדות
origins[]	RouteMatrixOrigin חובה. מערך של מקורות, שקובע את השורות של מטריצת התגובה. יש כמה הגבלות על הגודל של העוצמה (cardinality) של מקורות ויעדים: הסכום של מספר מקורות + מספר היעדים שצוינו כ-place_id או כ-address לא יכול להיות גדול מ-50. בכל מקרה, המכפלה של מספר נקודות המוצא ומספר היעדים לא יכולה להיות גדולה מ-625. אם הערך של routing_preference הוא TRAFFIC_AWARE_OPTIMAL, המכפלה של מספר נקודות המוצא × מספר נקודות היעד לא יכולה להיות גדולה מ-100. המכפלה של מספר נקודות המוצא × מספר היעדים לא יכולה להיות גדולה מ-100 אם הערך של travel_mode הוא TRANSIT.
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'. מידע נוסף זמין במאמר בנושא מזהה אזור Unicode. כאן אפשר לעיין ברשימת השפות הנתמכות. אם לא תציינו את הערך הזה, שפת התצוגה תוסק מהמיקום של המקור הראשון.
region_code	string אופציונלי. קוד האזור, שמוגדר כערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. מידע נוסף זמין במאמר בנושא דומיינים ברמה העליונה עם קוד מדינה.
units	Units אופציונלי. מציין את יחידות המידה של השדות שמוצגים.
extra_computations[]	ExtraComputation אופציונלי. רשימה של חישובים נוספים שאפשר להשתמש בהם כדי להשלים את הבקשה. הערה: יכול להיות שהחישובים הנוספים האלה יחזירו שדות נוספים בתגובה. צריך לציין את השדות הנוספים האלה גם באנונימיזציה של השדה כדי שהם יוחזרו בתגובה.
traffic_model	TrafficModel אופציונלי. מציינת את ההנחות שבהן צריך להשתמש כשמחשבים את הזמן בפקק. ההגדרה הזו משפיעה על הערך שמוחזר בשדה duration ב-RouteMatrixElement, שמכיל את הזמן המשוער בתנועת הגולשים על סמך ממוצעים היסטוריים. הפרמטר TrafficModel זמין רק לבקשות שבהן הערך של RoutingPreference הוא TRAFFIC_AWARE_OPTIMAL והערך של RouteTravelMode הוא DRIVE. אם מתבצעת בקשה לתנועה והפרמטר TrafficModel לא מצוין, ערך ברירת המחדל הוא BEST_GUESS.
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'. מידע נוסף זמין במאמר בנושא מזהה אזור Unicode. כאן אפשר לעיין ברשימת השפות הנתמכות. אם לא מספקים את הערך הזה, שפת התצוגה נקבעת לפי המיקום של בקשת המסלול.
region_code	string אופציונלי. קוד האזור, שמוגדר כערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. מידע נוסף זמין במאמר בנושא דומיינים ברמה העליונה עם קוד מדינה.
units	Units אופציונלי. מציין את יחידות המידה של השדות שמוצגים. השדות האלה כוללים את השדה instruction ב-NavigationInstruction. הערך הזה לא משפיע על יחידות המידה שמשמשות לחישוב המרחק והמשך של המסלול, של קטע הדרך ושל הצעד. אם לא תציינו את הערך הזה, יחידות התצוגה יוסקו ממיקום המקור הראשון.
optimize_waypoint_order	bool אופציונלי. אם המדיניות מוגדרת כ-True, השירות מנסה למזער את העלות הכוללת של המסלול על ידי שינוי הסדר של נקודות הביניים שצוינו. הבקשה נכשלת אם אחת מנקודות הביניים היא נקודת ציון מסוג via. משתמשים בפקודה ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index כדי למצוא את הסדר החדש. אם לא מציינים את ComputeRoutesResponse.routes.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 אופציונלי. מציינת את ההנחות שבהן צריך להשתמש כשמחשבים את הזמן בפקק. ההגדרה הזו משפיעה על הערך שמוחזר בשדה משך הזמן ב-Route וב-RouteLeg, שמכיל את הזמן הצפוי בפקקים על סמך ממוצעים היסטוריים. הפרמטר TrafficModel זמין רק לבקשות שבהן הערך של RoutingPreference הוא TRAFFIC_AWARE_OPTIMAL והערך של RouteTravelMode הוא DRIVE. אם מתבצעת בקשה לתנועה והפרמטר TrafficModel לא מצוין, ערך ברירת המחדל הוא BEST_GUESS.
transit_preferences	TransitPreferences אופציונלי. ההגדרה הזו מציינת העדפות שמשפיעות על המסלול שמוחזר עבור TRANSIT מסלולים. הערה: אפשר לציין transit_preferences רק אם הערך של RouteTravelMode הוא TRANSIT.

ExtraComputation

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

טיפוסים בני מנייה (enum)
EXTRA_COMPUTATION_UNSPECIFIED	לא בשימוש. בקשות שמכילות את הערך הזה ייכשלו.
TOLLS	מידע על אגרות עבור המסלולים.
FUEL_CONSUMPTION	צריכת הדלק המשוערת במסלולים.
TRAFFIC_ON_POLYLINE	קווים פוליגוניים מודעים לתנועה עבור המסלולים.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS	‫NavigationInstruction מוצג כמחרוזת טקסט בפורמט HTML. התוכן הזה נועד לקריאה כמו שהוא. התוכן הזה מיועד להצגה בלבד. אל תנתחו אותו באופן פרוגרמטי.
FLYOVER_INFO_ON_POLYLINE	מידע על תצוגת תלת-ממד של המסלול או המסלולים. כדי להחזיר את המידע הזה, צריך לציין את routes.polyline_details.flyover_info fieldmask. בשלב הזה, הנתונים האלה יאוכלסו רק לגבי אזורי מטרופולין מסוימים בהודו. התכונה הזו ניסיונית, והמק"ט או החיוב עשויים להשתנות.
NARROW_ROAD_INFO_ON_POLYLINE	מידע על כבישים צרים במסלולים. כדי להחזיר את המידע הזה, צריך לציין את routes.polyline_details.narrow_road_info fieldmask. בשלב הזה, הנתונים האלה יאוכלסו רק לגבי אזורי מטרופולין מסוימים בהודו. התכונה הזו ניסיונית, והמק"ט או החיוב עשויים להשתנות.
TUNNEL_INFO_ON_POLYLINE	מידע על המנהרות במסלול או במסלולים. כדי להחזיר את המידע הזה, צריך לציין את routes.polyline_details.tunnel_info fieldmask.
BRIDGE_INFO_ON_POLYLINE	מידע על גשרים במסלול. כדי להחזיר את המידע הזה, צריך לציין את routes.polyline_details.bridge_info fieldmask.
SKYWAY_INFO_ON_POLYLINE	מידע על גשרים עיליים במסלול או במסלולים. כדי להחזיר את המידע הזה, צריך לציין את routes.polyline_details.skyway_info fieldmask.

ReferenceRoute

מסלול ייחוס נתמך ב-ComputeRoutesRequest.

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

FallbackInfo

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

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

FallbackReason

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

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

FallbackRoutingMode

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

טיפוסים בני מנייה (enum)
FALLBACK_ROUTING_MODE_UNSPECIFIED	לא בשימוש.
FALLBACK_TRAFFIC_UNAWARE	המציין של TRAFFIC_UNAWARE 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 ציון דרך שהומרה לקואורדינטות גיאוגרפיות (geocoding) של היעד.
intermediates[]	GeocodedWaypoint רשימה של נקודות ציון ביניים שעברו גיאו-קידוד. כל נקודת ציון מכילה שדה אינדקס שתואם למיקום של נקודת הציון בסדר שבו היא צוינה בבקשה (המיקום מתחיל מאפס).

LocalizedTime

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

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

מיקום

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

שדות
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_type. כולל את סוג הקו הפוליגוני. ברירת המחדל היא encoded_polyline. הערך polyline_type יכול להיות רק אחד מהבאים:
encoded_polyline	string מחרוזת הקידוד של הקו הפוליגוני באמצעות אלגוריתם קידוד הקו הפוליגוני
geo_json_linestring	Struct מגדיר קו פוליגוני באמצעות הפורמט GeoJSON LineString.

PolylineDetails

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

שדות
tunnel_info[]	TunnelInfo פרטי המנהרה לאורך הקו המקוקו. השדה הזה מאוכלס אם בבקשה מצוין משנה המסלול avoid_tunnels והמסלול שמתקבל לא עוקף אותם, או אם TUNNEL_INFO_ON_POLYLINE מצוין ב-extra_computations והמסלול מכיל מנהרות.
restriction_info[]	RestrictionInfo פרטי ההגבלה לאורך הקו. השדה הזה מאוכלס רק אם בבקשה מצוין מגביל המסלול vehicle_info והמסלול שמתקבל מכיל הגבלה רלוונטית. בכל שאר המקרים, השדה הזה לא בשימוש.
flyover_info[]	FlyoverInfo פרטים על המעוף מעל קו הפוליגון.
narrow_road_info[]	NarrowRoadInfo פרטים על כביש צר לאורך הקו הפוליגוני.
bridge_info[]	BridgeInfo פרטי הגשר לאורך הקו הפוליגוני.
skyway_info[]	SkywayInfo פרטי הגשר העילי לאורך הקו הפוליגוני.

BridgeInfo

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

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

FlyoverInfo

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

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

NarrowRoadInfo

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

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

PolylinePointIndex

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

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

RestrictionInfo

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

שדות
restriction_presence	RoadFeatureState פלט בלבד. מציין אם קיימת הגבלה לקטע נתון של הקו הפוליגוני.
polyline_point_index	PolylinePointIndex המיקום של המידע שקשור להגבלה לאורך הקו המקומקע.
שדה איחוד restriction. האובייקט הזה מכיל את סוגי ההגבלות שיכולות לחול על קטע נתון של הקו הפוליגוני. הערך restriction יכול להיות רק אחד מהבאים:
restricted_height_mm	int64 מגבלת הגובה, במילימטרים. השדה הזה יאוכלס אם הגובה המוגבל מונע מעבר או גורם למרווח גחון נמוך לרכב שצוין.
restricted_weight_kg	int64 מגבלת המשקל בקילוגרמים. השדה הזה יאוכלס כשהגבלת המשקל מונעת מעבר או קרובה למשקל של הרכב שצוין.
hazardous_goods	bool השדה הזה מוגדר כ-true אם יש הגבלה על הובלת סחורות מסוכנות.
trucks_prohibited	bool השדה הזה מוגדר כ-true כשהכניסה למשאיות אסורה.

RoadFeatureState

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

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

SkywayInfo

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

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

TunnelInfo

כולל מידע על מנהרות לאורך הקו המקוטע.

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

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

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

מידע נוסף על מסלולי TRANSIT שרלוונטי ל-RouteLegStep.

שדות
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 הזמן בייצוג טקסט מעוצב עם אזור זמן תואם.

TransitStopDetails

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

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

RouteLegStepTravelAdvisory

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

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

RouteLegTravelAdvisory

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

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

RouteMatrixDestination

יעד יחיד ל-ComputeRouteMatrixRequest

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

RouteMatrixElement

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

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

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.
avoid_tunnels	bool אופציונלי. כשהערך מוגדר כ-true, המערכת נמנעת ממנהרות כשאפשר, ומעדיפה מסלולים שלא כוללים מנהרות. ההנחה חלה רק על DRIVE ועל TWO_WHEELER RouteTravelMode. הערך של RoutingPreference חייב להיות TRAFFIC_AWARE_OPTIMAL. השדה הזה לא נתמך ב-ComputeRouteMatrix.

RouteTravelAdvisory

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

שדות
toll_info	TollInfo מכיל מידע על אגרות בכביש במסלול. השדה הזה מאוכלס רק אם צפויים כבישי אגרה במסלול, והפרמטר TOLLS נכלל בפרמטר ComputeRoutesRequest.extra_computations של הבקשה. אם השדה הזה מוגדר, אבל שדה המשנה estimatedPrice לא מאוכלס, סימן שהמסלול כולל אגרה, אבל המחיר המשוער לא ידוע. אם לא מוגדר toll_info, לא צפויים אגרות בכביש במסלול.
speed_reading_intervals[]	SpeedReadingInterval אינטרוולים של מהירות קריאה שמציינים את צפיפות התנועה. השדה הזה מאוכלס רק בבקשות שבהן הערך של TRAFFIC_AWARE או TRAFFIC_AWARE_OPTIMAL הוא ComputeRoutesRequest.routing_preference, והפרמטר TRAFFIC_ON_POLYLINE נכלל בפרמטר ComputeRoutesRequest.extra_computations. המרווחים מכסים את כל הקו הפוליגוני של המסלול ללא חפיפה. נקודת ההתחלה של פרק זמן מסוים זהה לנקודת יעד של פרק הזמן הקודם. דוגמה: polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).
fuel_consumption_microliters	int64 צריכת הדלק הצפויה במיקרוליטרים. השדה הזה יאוכלס רק אם הפרמטר FUEL_CONSUMPTION ייכלל בפרמטר ComputeRoutesRequest.extra_computations של הבקשה.
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 אמצעי התחבורה שכולל אמצעי תחבורה שמבוססים על כוח אדם.
TRUCK	משאית, שעשויה להיות כפופה להגבלות רגולטוריות או פיזיות. צריך לאכלס את מאפייני הרכב בהודעה VehicleInfo.
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	הודו, פטור מלוחית רישוי במדינה של HP.
JP_ETC	‫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	אלבמה, ארה"ב.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS	אלסקה, ארה"ב.
US_CA_FASTRAK	קנדה, ארה"ב.
US_CA_FASTRAK_CAV_STICKER	המאפיין מציין אם לנהג יש כרטיס FasTrak בנוסף לסטיקר Clean Air Vehicle (CAV) שהונפק על ידי משרד הרישוי (DMV). https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL	CO, USA.
US_CO_GO_PASS	CO, USA.
US_DE_EZPASSDE	גרמניה, ארה"ב.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS	פלורידה, ארה"ב.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD	פלורידה, ארה"ב.
US_FL_EPASS	פלורידה, ארה"ב.
US_FL_GIBA_TOLL_PASS	פלורידה, ארה"ב.
US_FL_LEEWAY	פלורידה, ארה"ב.
US_FL_SUNPASS	פלורידה, ארה"ב.
US_FL_SUNPASS_PRO	פלורידה, ארה"ב.
US_IL_EZPASSIL	אילינוי, ארה"ב.
US_IL_IPASS	אילינוי, ארה"ב.
US_IN_EZPASSIN	הודו, ארה"ב.
US_KS_BESTPASS_HORIZON	קנזס, ארה"ב.
US_KS_KTAG	קנזס, ארה"ב.
US_KS_NATIONALPASS	קנזס, ארה"ב.
US_KS_PREPASS_ELITEPASS	קנזס, ארה"ב.
US_KY_RIVERLINK	KY, USA.
US_LA_GEAUXPASS	לוס אנג'לס, ארה"ב.
US_LA_TOLL_TAG	לוס אנג'לס, ארה"ב.
US_MA_EZPASSMA	MA, USA.
US_MD_EZPASSMD	מרילנד, ארה"ב.
US_ME_EZPASSME	ME, USA.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD	מישיגן, ארה"ב.
US_MI_BCPASS	MI, USA.
US_MI_BREAKAWAY	MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG	MI, USA.
US_MI_IQ_PROX_CARD	מישיגן, ארה"ב. הוצא משימוש כי סוג הכרטיס הזה כבר לא קיים. הפריט הזה יצא משימוש.
US_MI_IQ_TAG	מישיגן, ארה"ב.
US_MI_MACKINAC_BRIDGE_MAC_PASS	MI, USA.
US_MI_NEXPRESS_TOLL	מישיגן, ארה"ב.
US_MN_EZPASSMN	MN, USA.
US_NC_EZPASSNC	NC, USA.
US_NC_PEACH_PASS	NC, USA.
US_NC_QUICK_PASS	NC, USA.
US_NH_EZPASSNH	NH, USA.
US_NJ_DOWNBEACH_EXPRESS_PASS	ניו ג'רזי, ארה"ב.
US_NJ_EZPASSNJ	ניו ג'רזי, ארה"ב.
US_NY_EXPRESSPASS	ניו יורק, ארה"ב.
US_NY_EZPASSNY	ניו יורק, ארה"ב.
US_OH_EZPASSOH	OH, USA.
US_PA_EZPASSPA	PA, USA.
US_RI_EZPASSRI	RI, USA.
US_SC_PALPASS	SC, USA.
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, USA.
US_VA_EZPASSVA	VA, USA.
US_WA_BREEZEBY	WA, USA.
US_WA_GOOD_TO_GO	WA, USA.
US_WV_EZPASSWV	WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS	WV, USA.
US_WV_MOV_PASS	וירג'יניה המערבית, ארה"ב
US_WV_NEWELL_TOLL_BRIDGE_TICKET	WV, USA.

TrafficModel

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

טיפוסים בני מנייה (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.
total_height_mm	int64 גובה הרכב, כולל הגובה של כל נגרר שמחובר אליו. כדי שהטריגר יופעל, צריך להגדיר את ההגדרה הזו למצב נהיגה במשאית או בגרירה. השדה הזה לא נתמך ב-ComputeRouteMatrix כש-RouteTravelMode הוא DRIVE.
total_length_mm	int64 אורך כלי הרכב, כולל אורך של כל נגרר שמחובר אליו. כדי שהטריגר יופעל, צריך להגדיר את ההגדרה הזו למצב נהיגה במשאית או בגרירה. השדה הזה לא נתמך ב-ComputeRouteMatrix כש-RouteTravelMode הוא DRIVE.
total_width_mm	int64 רוחב הרכב, כולל רוחב של כל נגרר שמחובר אליו. כדי שהטריגר יופעל, צריך להגדיר את ההגדרה הזו למצב נהיגה במשאית או בגרירה. השדה הזה לא נתמך ב-ComputeRouteMatrix כש-RouteTravelMode הוא DRIVE.
total_weight_kg	int64 משקל הרכב, כולל משקלם של נגררים שמחוברים אליו. המשקל בהקשר הזה הוא המשקל בפועל, ולא דירוג המשקל. כדי שהטריגר יופעל, צריך להגדיר את ההגדרה הזו למצב נהיגה במשאית או בגרירה. השדה הזה לא נתמך ב-ComputeRouteMatrix כש-RouteTravelMode הוא DRIVE.
trailer_info[]	TrailerInfo מכיל רשומה אחת לכל טריילר. אם מספקים פרטים על טריילר, צריך להגדיר את הערך RoutingPreference ל-TRAFFIC_AWARE_OPTIMAL. השדה הזה לא נתמך ב-ComputeRouteMatrix כש-RouteTravelMode הוא DRIVE.
hazardous_goods_types[]	HazardousGoodsType רשימה של חומרים מסוכנים שמועברים ברכב, אם יש כאלה.

HazardousGoodsType

סוגים שונים של חומרים מסוכנים.

טיפוסים בני מנייה (enum)
HAZARDOUS_GOODS_TYPE_UNSPECIFIED	לא צוין סוג של חומרים מסוכנים.
EXPLOSIVES	מוצרים נפיצים.
GASES	גזים.
FLAMMABLE	מוצרים דליקים.
COMBUSTIBLE	מוצרים דליקים.
ORGANIC	מוצרים אורגניים.
POISON	מוצרים רעילים.
RADIOACTIVE	מוצרים רדיואקטיביים.
CORROSIVE	מוצרים קורוזיביים.
ASPIRATION_HAZARD	סחורות מסוכנות שעלולות לגרום לשאיפה.
ENVIRONMENTAL_HAZARD	סחורות מסוכנות לסביבה.
OTHER	סוגים אחרים של מוצרים.

TrailerInfo

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

שדות
height_mm	int64 גובה הנגרר.
length_mm	int64 אורך הטריילר.
width_mm	int64 רוחב הטריילר.
weight_kg	int64 משקל הנגרר. המשקל בהקשר הזה הוא המשקל בפועל, ולא דירוג המשקל.

נקודת ציון

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

שדות
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 כתובת קריאה או קוד פלוס. פרטים נוספים זמינים בכתובת https://plus.codes.
navigation_point_token	string אסימון שמזהה NavigationPoint, שמתקבל מהשיטה SearchDestinations של Geocoding API.