Package google.maps.routing.v2

אינדקס

מסלולים

‫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.
  • אם הערך של 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'. מידע נוסף זמין במאמר בנושא מזהה אזור Unicode. כאן אפשר לעיין ברשימת השפות הנתמכות. אם לא תציינו את הערך הזה, שפת התצוגה תוסק מהמיקום של המקור הראשון.
region_code

string

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

Units

אופציונלי. מגדירה את יחידות המידה של שדות התצוגה.
extra_computations[]

ExtraComputation

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

TrafficModel

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

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

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

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

שדות
geocoder_status

Status

קוד הסטטוס שמתקבל מפעולת הגיאו-קידוד.
type[]

string

סוג התוצאה, בצורה של תגי סוג אחד או יותר. סוגים נתמכים: סוגי כתובות וסוגי רכיבי כתובות.
partial_match

bool

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

string

מזהה המקום של התוצאה הזו.
intermediate_waypoint_request_index

int32

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

GeocodingResults

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

שדות
origin

GeocodedWaypoint

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

GeocodedWaypoint

נקודת ציון גיאוגרפית של היעד.
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 משמש לציון שינוי בשם רחוב.
DESTINATION משמש לציון הגעה ליעד.

תג שמכיל הוראות ניווט ל-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

פרטי Skyway לאורך הקו הפוליגוני.

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

הוראות ניווט לפלח מולטימודאלי.
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 AK, USA.
US_CA_FASTRAK קנדה, ארה"ב.
US_CA_FASTRAK_CAV_STICKER המאפיין מציין שלנהג יש כרטיס FasTrak בנוסף למדבקת רכב שמירה על אוויר נקי (CAV) שהונפקה על ידי משרד הרישוי. 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 IL, USA.
US_IL_IPASS IL, USA.
US_IN_EZPASSIN הודו, ארה"ב.
US_KS_BESTPASS_HORIZON KS, USA.
US_KS_KTAG KS, USA.
US_KS_NATIONALPASS KS, USA.
US_KS_PREPASS_ELITEPASS KS, USA.
US_LA_GEAUXPASS לוס אנג'לס, ארה"ב.
US_LA_TOLL_TAG לוס אנג'לס, ארה"ב.
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD מרילנד, ארה"ב.
US_ME_EZPASSME מיין, ארה"ב.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
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

MI, USA. הוצא משימוש כי סוג הכרטיס הזה כבר לא קיים.
US_MI_IQ_TAG MI, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA.
US_MI_NEXPRESS_TOLL MI, USA.
US_MN_EZPASSMN MN, USA.
US_NC_EZPASSNC קרוליינה הצפונית, ארה"ב.
US_NC_PEACH_PASS קרוליינה הצפונית, ארה"ב.
US_NC_QUICK_PASS קרוליינה הצפונית, ארה"ב.
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 וושינגטון, ארה"ב.
US_WA_GOOD_TO_GO וושינגטון, ארה"ב.
US_WV_EZPASSWV וירג'יניה המערבית, ארה"ב.
US_WV_MEMORIAL_BRIDGE_TICKETS וירג'יניה המערבית, ארה"ב.
US_WV_MOV_PASS WV, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET וירג'יניה המערבית, ארה"ב.

TrafficModel

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

סימון נקודת הדרך הזו כאבן דרך ולא כנקודת עצירה. לכל נקודת ציון שאינה נקודת ציון מסוג via בבקשה, התשובה מוסיפה רשומה למערך 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, שמתקבל מה-method ‏SearchDestinations של Geocoding API.