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.
  • המכפלה של מספר מקורות x מספר יעדים לא יכולה להיות גדולה מ-625 בכל מקרה.
  • אם הערך של routing_preference מוגדר כ-TRAFFIC_AWARE_OPTIMAL, המכפלה של מספר מקורות × מספר יעדים לא יכולה להיות גדולה מ-100.
  • אם הערך של travel_mode מוגדר כ-TRANSIT, המכפלה של מספר המקוריים × מספר היעדים לא יכולה להיות גדולה מ-100.
destinations[]

RouteMatrixDestination

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

RouteTravelMode

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

RoutingPreference

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

Timestamp

זה שינוי אופציונלי. שעת היציאה. אם לא תגדירו את הערך הזה, ערך ברירת המחדל שלו יהיה השעה שבה שלחתם את הבקשה. הערה: אפשר לציין departure_time בעבר רק כשהערך של RouteTravelMode מוגדר כ-TRANSIT.
arrival_time

Timestamp

זה שינוי אופציונלי. שעת ההגעה. הערה: אפשר להגדיר את השדה הזה רק אם הערך של RouteTravelMode הוא TRANSIT. אפשר לציין departure_time או arrival_time, אבל לא את שניהם.
language_code

string

זה שינוי אופציונלי. קוד השפה לפי BCP-47, למשל 'en-US' או 'sr-Latn'. מידע נוסף זמין במאמר מזהה המקום (locale) של Unicode. ברשימת תמיכת השפות מפורטות השפות הנתמכות. אם לא מציינים את הערך הזה, שפת התצוגה נובעת מהמיקום של המקור הראשון.
region_code

string

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

Units

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

ExtraComputation

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

TrafficModel

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

TransitPreferences

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

ExtraComputation

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

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

ComputeRoutesRequest

הודעת הבקשה של ComputeRoutes.

שדות
origin

Waypoint

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

Waypoint

חובה. נקודת ציון ליעד.
intermediates[]

Waypoint

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

RouteTravelMode

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

RoutingPreference

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

PolylineQuality

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

PolylineEncoding

זה שינוי אופציונלי. מציין את קידוד הפוליגון המועדף.
departure_time

Timestamp

זה שינוי אופציונלי. שעת היציאה. אם לא תגדירו את הערך הזה, ערך ברירת המחדל שלו יהיה השעה שבה שלחתם את הבקשה. הערה: אפשר לציין departure_time בעבר רק כשהערך של RouteTravelMode מוגדר כ-TRANSIT. נסיעות בתחבורה ציבורית זמינות עד 7 ימים בעבר או 100 ימים בעתיד.
arrival_time

Timestamp

זה שינוי אופציונלי. שעת ההגעה. הערה: אפשר להגדיר את השדה הזה רק אם הערך של RouteTravelMode הוא TRANSIT. אפשר לציין departure_time או arrival_time, אבל לא את שניהם. נסיעות בתחבורה ציבורית זמינות עד 7 ימים בעבר או 100 ימים בעתיד.
compute_alternative_routes

bool

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

RouteModifiers

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

string

זה שינוי אופציונלי. קוד השפה לפי BCP-47, למשל 'en-US' או 'sr-Latn'. מידע נוסף זמין במאמר מזהה המקום (locale) של Unicode. ברשימת תמיכת השפות מפורטות השפות הנתמכות. אם לא מציינים את הערך הזה, שפת התצוגה נובעת מהמיקום של בקשת המסלול.
region_code

string

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

Units

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

bool

זה שינוי אופציונלי. אם הערך מוגדר כ-true, השירות ינסה למזער את העלות הכוללת של המסלול על ידי שינוי הסדר של נקודות העצירה הביניים שצוינו. הבקשה נכשלת אם אחד מנקודות הציון הביניים הוא נקודת ציון מסוג via. משתמשים ב-ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index כדי למצוא את הסדר החדש. אם לא מבקשים את ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index בכותרת X-Goog-FieldMask, הבקשה נכשלת. אם optimize_waypoint_order מוגדר כ-false, השדה ComputeRoutesResponse.optimized_intermediate_waypoint_index יהיה ריק.
requested_reference_routes[]

ReferenceRoute

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

ExtraComputation

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

TrafficModel

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

TransitPreferences

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

ExtraComputation

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

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

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

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

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

שדות
maneuver

Maneuver

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

string

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

מצולע פתוח

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

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

string

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

Struct

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

PolylineEncoding

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

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

PolylineQuality

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

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

נתיב

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

שדות
route_labels[]

RouteLabel

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

RouteLeg

אוסף של שלבים (קטעי נתיב בין נקודות ציון) שמרכיבים את המסלול. כל מקטע תואם לנסיעה בין שני Waypoints שאינם via. לדוגמה, למסלול ללא נקודות ציון ביניים יש רק שלב אחד. למסלול שכולל נקודת ציון ביניים אחת שאינה via יש שתי רגליים. למסלול שכולל נקודת ציון ביניים אחת מסוג via יש רגל אחת. סדר השלבים תואם לסדר של נקודות הדרך מ-origin ל-intermediates ל-destination.
distance_meters

int32

מרחק הנסיעה במסלול, במטרים.
duration

Duration

משך הזמן הנדרש לנסיעה במסלול. אם מגדירים את routing_preference כ-TRAFFIC_UNAWARE, הערך הזה זהה ל-static_duration. אם מגדירים את routing_preference לערך TRAFFIC_AWARE או TRAFFIC_AWARE_OPTIMAL, הערך הזה מחושב תוך התחשבות בתנאי התנועה.
static_duration

Duration

משך הנסיעה במסלול, בלי להביא בחשבון את מצב התנועה.
polyline

Polyline

הקו הפוליגוני הכולל של המסלול. קו הפוליגון הזה הוא קו הפוליגון המשולב של כל legs.
description

string

תיאור המסלול.
warnings[]

string

מערך של אזהרות שיוצגו כשהמסלול מוצג.
viewport

Viewport

התיבה התוחמת (bounding box) של אזור התצוגה של הקו הפוליגוני.
travel_advisory

RouteTravelAdvisory

מידע נוסף על המסלול.
optimized_intermediate_waypoint_index[]

int32

אם מגדירים את optimize_waypoint_order כ-true, השדה הזה מכיל את הסדר המותאם של נקודות ציון ביניים. אחרת, השדה הזה יהיה ריק. לדוגמה, אם מזינים את הפרטים הבאים: מקור: תל אביב; נקודות דרך ביניים: ירושלים, חיפה, תל אביב; יעד: ניו יורק, והסדר האופטימלי של נקודות הדרך הביניים הוא תל אביב, ירושלים, חיפה, השדה הזה יכיל את הערכים [2, 0, 1]. האינדקס מתחיל ב-0 לנקודת הציון הראשונה שצוינה בקלט.
localized_values

RouteLocalizedValues

ייצוגים של מאפיינים של Route בטקסט.
route_token

string

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

הערה: השדה Route.route_token זמין רק לבקשות שבהן הערך של ComputeRoutesRequest.routing_preference מוגדר כ-TRAFFIC_AWARE או כ-TRAFFIC_AWARE_OPTIMAL. אין תמיכה ב-Route.route_token בבקשות עם נקודות דרך מסוג 'דרך'.

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

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

שדות
stop_details

TransitStopDetails

מידע על תחנות היציאה וההגעה של השלב.
localized_values

TransitDetailsLocalizedValues

ייצוגים של מאפיינים של RouteLegStepTransitDetails בטקסט.
headsign

string

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

Duration

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

TransitLine

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

int32

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

stop_count

הפונקציה מחזירה את הערך 3.
trip_short_text

string

הטקסט שמופיע בלוחות הזמנים ובשלטי הנסיעה כדי לזהות נסיעה בתחבורה ציבורית לנוסעים. הטקסט צריך לזהות באופן ייחודי נסיעה בתוך יום שירות. לדוגמה, '538' הוא trip_short_text של רכבת Amtrak שיוצאת מסן חוזה, קליפורניה בשעה 15:10 בימי חול לכיוון סקרמנטו, קליפורניה.

TransitDetailsLocalizedValues

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

שדות
arrival_time

LocalizedTime

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

LocalizedTime

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

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. אם השדה הזה מוגדר אבל שדה המשנה estimated_price לא מאוכלס, אנחנו מניחים שהכביש מכיל כבישי אגרה אבל אין לנו מידע על המחיר המשוער. אם השדה הזה לא קיים, אין תשלום על RouteLeg.
speed_reading_intervals[]

SpeedReadingInterval

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

דוגמה:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

יעד יחיד ל-ComputeRouteMatrixRequest

שדות
waypoint

Waypoint

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

RouteMatrixElement

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

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

RouteTravelAdvisory

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

שדות
toll_info

TollInfo

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

SpeedReadingInterval

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

דוגמה:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).
fuel_consumption_microliters

int64

צריכת הדלק הצפויה במיקרוליטר.
route_restrictions_partially_ignored

bool

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

Money

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

RouteTravelMode

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

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

RoutingPreference

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

טיפוסים בני מנייה (enum)
ROUTING_PREFERENCE_UNSPECIFIED לא צוינה העדפת ניתוב. ברירת המחדל היא TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE חישוב המסלולים בלי להביא בחשבון את תנאי התנועה בזמן אמת. מתאים למקרים שבהם מצב התנועה לא רלוונטי או לא חשוב. השימוש בערך הזה מניב את זמן האחזור הנמוך ביותר. הערה: עבור RouteTravelMode, DRIVE ו-TWO_WHEELER, המסלול והמשך הזמן שנבחרים מבוססים על רשת הכבישים ועל תנאי התנועה הממוצעים שאינם תלויים בזמן, ולא על תנאי הכביש הנוכחיים. כתוצאה מכך, הנתיבים עשויים לכלול כבישים שסגורים באופן זמני. התוצאות של בקשה מסוימת עשויות להשתנות לאורך זמן בגלל שינויים ברשת הכבישים, עדכונים של תנאי התנועה הממוצעים והאופי המבוזר של השירות. התוצאות עשויות גם להשתנות בין מסלולים כמעט זהים בכל שלב או תדירות.
TRAFFIC_AWARE חישוב מסלולים תוך התחשבות במצב התנועה בזמן אמת. בניגוד ל-TRAFFIC_AWARE_OPTIMAL, חלק מהאופטימיזציות חלות כדי לצמצם משמעותית את זמן האחזור.
TRAFFIC_AWARE_OPTIMAL חישוב המסלולים תוך התחשבות בתנאי התנועה בזמן אמת, בלי להחיל את רוב האופטימיזציות לשיפור הביצועים. השימוש בערך הזה יגרום לזמן האחזור הגבוה ביותר.

SpeedReadingInterval

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

שדות
start_polyline_point_index

int32

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

int32

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

שדה האיחוד speed_type.

הערך של speed_type יכול להיות רק אחת מהאפשרויות הבאות:
speed

Speed

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

מהירות

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

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

TollInfo

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

שדות
estimated_price[]

Money

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

TollPass

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

טיפוסים בני מנייה (enum)
TOLL_PASS_UNSPECIFIED לא בשימוש. אם נעשה שימוש בערך הזה, הבקשה תיכשל.
AU_ETOLL_TAG מינוי לכביש אגרה בסידני. פרטים נוספים זמינים בכתובת https://www.myetoll.com.au.
AU_EWAY_TAG מינוי לכביש אגרה בסידני. פרטים נוספים זמינים בכתובת https://www.tollpay.com.au.
AU_LINKT מינוי לכביש אגרה בכל אוסטרליה. פרטים נוספים זמינים בכתובת https://www.linkt.com.au/.
AR_TELEPASE מינוי לכביש אגרה בארגנטינה. פרטים נוספים זמינים בכתובת https://telepase.com.ar
BR_AUTO_EXPRESO מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://www.autoexpreso.com
BR_CONECTCAR מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://conectcar.com.
BR_MOVE_MAIS מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://movemais.com.
BR_PASSA_RAPIDO מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://pasorapido.gob.do/
BR_SEM_PARAR מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://www.semparar.com.br.
BR_TAGGY מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://taggy.com.br.
BR_VELOE מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD מעבר גבול מקנדה לארצות הברית.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD מעבר גבול מקנדה לארצות הברית.
CA_US_BLUE_WATER_EDGE_PASS מעבר גבול מאונטריו, קנדה למישיגן, ארצות הברית.
CA_US_CONNEXION מעבר גבול מאונטריו, קנדה למישיגן, ארצות הברית.
CA_US_NEXUS_CARD מעבר גבול מקנדה לארצות הברית.
ID_E_TOLL אינדונזיה. כרטיס אלקטרוני שמנפיקים כמה בנקים, ומשמשים לתשלום על כבישי אגרה. כל הכרטיסים האלקטרוניים דרך בנקים מחויבים באותו אופן, ולכן נדרש רק ערך enum אחד. לדוגמה: - Bank Mandiri‏ https://www.bankmandiri.co.id/e-money - BCA‏ https://www.bca.co.id/flazz - BNI‏ https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG India.‎
IN_LOCAL_HP_PLATE_EXEMPT הודו, פטור של לוחית רישוי במדינת האלמהברה.
JP_ETC Japan ETC. מערכת אלקטרונית אלחוטית לחיוב על כבישי אגרה. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. גרסה חדשה של ETC עם הנחה נוספת ותקשורת דו-כיוונית בין מכשירים ברכב לבין אנטנות בכביש. https://www.go-etc.jp/etc2/index.html
MX_IAVE כרטיס לתשלום על כבישי אגרה במקסיקו. https://iave.capufe.gob.mx/#/
MX_PASE מקסיקו https://www.pase.com.mx
MX_QUICKPASS מקסיקו https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE מקסיקו
MX_TAG_TELEVIA חברה למינויים לכביש אגרה במקסיקו. אחת מתוך רבות שפועלות במקסיקו סיטי. פרטים נוספים זמינים בכתובת https://www.televia.com.mx.
MX_TELEVIA חברה למינויים לכביש אגרה במקסיקו. אחת מהחברות הרבות שפועלות במקסיקו סיטי. https://www.televia.com.mx
MX_VIAPASS מינוי לכביש אגרה במקסיקו. פרטים נוספים זמינים בכתובת https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, ארה"ב.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, ארה"ב.
US_CA_FASTRAK קנדה, ארה"ב.
US_CA_FASTRAK_CAV_STICKER המשמעות היא לנהג יש כרטיס FasTrak כלשהו בנוסף לסטיקר 'כלי רכב לאוויר נקי' (CAV) שהונפק על ידי DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL קולורדו, ארה"ב.
US_CO_GO_PASS קולורדו, ארה"ב.
US_DE_EZPASSDE גרמניה, ארה"ב.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, USA.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, USA.
US_FL_EPASS FL, USA.
US_FL_GIBA_TOLL_PASS FL, USA.
US_FL_LEEWAY FL, USA.
US_FL_SUNPASS FL, USA.
US_FL_SUNPASS_PRO FL, USA.
US_IL_EZPASSIL IL, ארה"ב.
US_IL_IPASS IL, ארה"ב.
US_IN_EZPASSIN אינדיאנה, ארה"ב.
US_KS_BESTPASS_HORIZON KS, ארה"ב.
US_KS_KTAG KS, ארה"ב.
US_KS_NATIONALPASS KS, ארה"ב.
US_KS_PREPASS_ELITEPASS KS, ארה"ב.
US_LA_GEAUXPASS לוס אנג'לס, ארה"ב.
US_LA_TOLL_TAG לוס אנג'לס, ארה"ב.
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD מרילנד, ארה"ב.
US_ME_EZPASSME ME, ארה"ב.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, ארה"ב.
US_MI_BCPASS MI, ארה"ב.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, ארה"ב.
US_MI_IQ_PROX_CARD

MI, ארה"ב. סוג הכרטיס הזה הוצא משימוש כי הוא כבר לא קיים.
US_MI_IQ_TAG MI, ארה"ב.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, ארה"ב.
US_MI_NEXPRESS_TOLL MI, ארה"ב.
US_MN_EZPASSMN MN, ארה"ב.
US_NC_EZPASSNC צפון קרולינה, ארה"ב.
US_NC_PEACH_PASS צפון קרולינה, ארה"ב.
US_NC_QUICK_PASS צפון קרולינה, ארה"ב.
US_NH_EZPASSNH ניו המפשייר, ארה"ב.
US_NJ_DOWNBEACH_EXPRESS_PASS ניו ג'רזי, ארה"ב.
US_NJ_EZPASSNJ ניו ג'רזי, ארה"ב.
US_NY_EXPRESSPASS ניו יורק, ארה"ב.
US_NY_EZPASSNY ניו יורק, ארה"ב.
US_OH_EZPASSOH אוהיו, ארה"ב.
US_PA_EZPASSPA PA, ארה"ב.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, ארה"ב.
US_TX_AVI_TAG טקסס, ארה"ב.
US_TX_BANCPASS טקסס, ארה"ב.
US_TX_DEL_RIO_PASS טקסס, ארה"ב.
US_TX_EFAST_PASS טקסס, ארה"ב.
US_TX_EAGLE_PASS_EXPRESS_CARD טקסס, ארה"ב.
US_TX_EPTOLL טקסס, ארה"ב.
US_TX_EZ_CROSS טקסס, ארה"ב.
US_TX_EZTAG טקסס, ארה"ב.
US_TX_FUEGO_TAG טקסס, ארה"ב.
US_TX_LAREDO_TRADE_TAG טקסס, ארה"ב.
US_TX_PLUSPASS טקסס, ארה"ב.
US_TX_TOLLTAG טקסס, ארה"ב.
US_TX_TXTAG טקסס, ארה"ב.
US_TX_XPRESS_CARD טקסס, ארה"ב.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, ארה"ב.
US_VA_EZPASSVA VA, ארה"ב.
US_WA_BREEZEBY וושינגטון, ארה"ב.
US_WA_GOOD_TO_GO וושינגטון, ארה"ב.
US_WV_EZPASSWV WV, ארה"ב.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, ארה"ב.
US_WV_MOV_PASS WV, ארה"ב
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, ארה"ב.

TrafficModel

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

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

TransitAgency

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

שדות
name

string

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

string

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

string

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

TransitLine

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

שדות
agencies[]

TransitAgency

חברת התחבורה הציבורית (או החברות) שמפעילה את קו התחבורה הציבורית הזה.
name

string

השם המלא של קו התחבורה הציבורית. לדוגמה, '8 Avenue Local'.
uri

string

כתובת ה-URI של קו התחבורה הציבורית הזה, כפי שסופקה על ידי חברת התחבורה הציבורית.
color

string

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

string

ה-URI של הסמל שמשויך לשורה הזו.
name_short

string

השם המקוצר של קו התחבורה הציבורית הזה. בדרך כלל השם הזה יהיה מספר שורה, כמו 'M7' או '355'.
text_color

string

הצבע הנפוץ בטקסט של השילוט של הקו הזה. מיוצגים בפורמט הקסדצימלי.
vehicle

TransitVehicle

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

TransitPreferences

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

שדות
allowed_travel_modes[]

TransitTravelMode

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

TransitRoutingPreference

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

TransitRoutingPreference

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

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

TransitTravelMode

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

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

TransitStop

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

שדות
name

string

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

Location

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

TransitVehicle

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

שדות
name

LocalizedText

השם של הרכב, באותיות רישיות.
type

TransitVehicleType

סוג הרכב שבו נעשה שימוש.
icon_uri

string

ה-URI של סמל שמשויך לסוג הרכב הזה.
local_icon_uri

string

ה-URI של הסמל המשויך לסוג הרכב הזה, על סמך סמלי התחבורה המקומית.

TransitVehicleType

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

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

יחידות

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

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

VehicleEmissionType

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

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

VehicleInfo

מכיל את פרטי הרכב, כמו סוג הפליטה של הרכב.

שדות
emission_type

VehicleEmissionType

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

נקודת ציון

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

שדות
via

bool

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

bool

מציין שציון הדרך מיועד לכלי רכב לעצירה, כאשר הכוונה היא לאיסוף או להורדה. כשמגדירים את הערך הזה, המסלול המחושב לא יכלול נקודות דרך שאינן מסוג via בכבישים שלא מתאימים לאיסוף או להורדה. האפשרות הזו פועלת רק לסוגי התחבורה DRIVE ו-TWO_WHEELER, וכאשר הערך של location_type הוא Location.
side_of_road

bool

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

Location

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

string

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

string

כתובת שאנשים יכולים לקרוא או קוד Plus. פרטים נוספים זמינים בכתובת https://plus.codes.