Package google.maps.routing.v2

אינדקס

מסלולים

ה-API של הניתוב.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

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

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

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

הערה: השיטה הזו מחייבת לציין אנונימיזציה של שדות תגובה בקלט. אפשר לספק את המסכה של שדות התגובה באמצעות פרמטר של כתובת אתר $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 בכל מקרה.
  • המכפלה של מספר המקורות × מספר היעדים לא יכולה להיות גדולה מ-100 אם path_preference מוגדר כ-TRAFFIC_AWARE_OPTIMAL.
  • המכפלה של מספר המקורות כפול מספר היעדים לא יכולה להיות גדולה מ-100 אם הערך של drive_mode הוא TRANSIT.
destinations[]

RouteMatrixDestination

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

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

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

departure_time

Timestamp

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

arrival_time

Timestamp

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

language_code

string

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

region_code

string

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

units

Units

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

extra_computations[]

ExtraComputation

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

traffic_model

TrafficModel

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

extra_computations[]

ExtraComputation

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

traffic_model

TrafficModel

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

ComputeRoutesResponse

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

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

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

travel_advisory

RouteTravelAdvisory

מידע נוסף על המסלול.

optimized_intermediate_waypoint_index[]

int32

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

localized_values

RouteLocalizedValues

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

route_token

string

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

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). השדה הזה מאוכלס רק במסלולי TRANSIT.

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

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

שדות
stop_details

TransitStopDetails

מידע על שעת ההגעה והיציאה של השלב הזה.

localized_values

TransitDetailsLocalizedValues

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

headsign

string

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

headway

Duration

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

transit_line

TransitLine

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

stop_count

int32

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

trip_short_text

string

הטקסט שמופיע בלוחות זמנים ובלוחות של חתימה כדי לזהות נסיעה בתחבורה ציבורית לנוסעים. הטקסט צריך לזהות את הנסיעה באופן ייחודי בתוך יום שירות. לדוגמה, "538" הוא הtrip_short_text של הרכבת אמטרק שיוצאת מסן חוזה, קליפורניה בשעה 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 של הרכיב לא תקין.
ROUTE_EXISTS נמצא מסלול, והפרטים התואמים מולאו לגבי הרכיב.
ROUTE_NOT_FOUND לא נמצא מסלול. שדות שמכילים פרטי מסלול, כמו distance_meters או duration, לא ימולאו ברכיב.

RouteMatrixOrigin

מקור יחיד ל-ComputeRouteMatrixRequest

שדות
waypoint

Waypoint

חובה. נקודת ציון מוצא

route_modifiers

RouteModifiers

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

RouteModifiers

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

שדות
avoid_tolls

bool

אם המדיניות מוגדרת כ-True, היא נמנעת מכבישי אגרה במקומות סבירים, ומעניקה עדיפות למסלולים שאינם מכילים כבישי אגרה. רלוונטי רק לRouteTravelMode DRIVE ולTWO_WHEELER.

avoid_highways

bool

אם המדיניות מוגדרת כ-True, היא נמנעת מכבישים מהירים במידת הסבירות, ומעניקה עדיפות למסלולים שאינם מכילים כבישים מהירים. רלוונטי רק לRouteTravelMode DRIVE ולTWO_WHEELER.

avoid_ferries

bool

אם המדיניות מוגדרת כ-True, היא נמנעת ממעבורות במקומות שבהם היא סבירה, ומעניקה עדיפות למסלולים שאינם מכילים מעבורות. רלוונטי רק לRouteTravelMode DRIVE ולTWO_WHEELER.

avoid_indoor

bool

אם המדיניות מוגדרת כ-True, המערכת נמנעת מניווט בתוך מבנים במקרים סבירים, כך שיש עדיפות למסלולים שלא כוללים ניווט בתוך מבנים. חל רק על WALK RouteTravelMode.

vehicle_info

VehicleInfo

מציין את פרטי הרכב.

toll_passes[]

TollPass

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

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 הודו, פטור מרישיון של מדינת HP.
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 אלבמה, ארה"ב.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, ארה"ב
US_CA_FASTRAK קנדה, ארה"ב.
US_CA_FASTRAK_CAV_STICKER מעיד על כך שלנהג יש אישור FasTrak כלשהו בנוסף למדבקה של כלי הרכב האוויר הנקי (CAV) שהונפק על ידי משרד הרישוי. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL קולורדו, ארה"ב.
US_CO_GO_PASS קולורדו, ארה"ב.
US_DE_EZPASSDE גרמניה, ארה"ב.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS פלורידה, ארה"ב.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD פלורידה, ארה"ב.
US_FL_EPASS פלורידה, ארה"ב.
US_FL_GIBA_TOLL_PASS פלורידה, ארה"ב.
US_FL_LEEWAY פלורידה, ארה"ב.
US_FL_SUNPASS פלורידה, ארה"ב.
US_FL_SUNPASS_PRO פלורידה, ארה"ב.
US_IL_EZPASSIL אילינוי, ארה"ב.
US_IL_IPASS אילינוי, ארה"ב.
US_IN_EZPASSIN הודו, ארה"ב.
US_KS_BESTPASS_HORIZON קנזס, ארה"ב.
US_KS_KTAG קנזס, ארה"ב.
US_KS_NATIONALPASS קנזס, ארה"ב.
US_KS_PREPASS_ELITEPASS קנזס, ארה"ב.
US_LA_GEAUXPASS לואיזיאנה, ארה"ב.
US_LA_TOLL_TAG לואיזיאנה, ארה"ב.
US_MA_EZPASSMA מסצ'וסטס
US_MD_EZPASSMD מרי, ארה"ב.
US_ME_EZPASSME ME, ארה"ב.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD מישיגן, ארה"ב.
US_MI_BCPASS מישיגן, ארה"ב.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG מישיגן, ארה"ב.
US_MI_IQ_PROX_CARD

מישיגן, ארה"ב. הוצא משימוש כי סוג הכרטיס הזה לא קיים יותר.

US_MI_IQ_TAG מישיגן, ארה"ב.
US_MI_MACKINAC_BRIDGE_MAC_PASS מישיגן, ארה"ב.
US_MI_NEXPRESS_TOLL מישיגן, ארה"ב.
US_MN_EZPASSMN מינסוטה, ארה"ב.
US_NC_EZPASSNC קרוליינה הצפונית, ארה"ב.
US_NC_PEACH_PASS קרוליינה הצפונית, ארה"ב.
US_NC_QUICK_PASS קרוליינה הצפונית, ארה"ב.
US_NH_EZPASSNH NH, ארה"ב.
US_NJ_DOWNBEACH_EXPRESS_PASS ניו ג'רזי, ארה"ב.
US_NJ_EZPASSNJ ניו ג'רזי, ארה"ב.
US_NY_EXPRESSPASS ניו יורק, ארה"ב.
US_NY_EZPASSNY ניו יורק, ארה"ב.
US_OH_EZPASSOH אוהיו, ארה"ב.
US_PA_EZPASSPA פנסילבניה, ארה"ב.
US_RI_EZPASSRI RI, ארה"ב.
US_SC_PALPASS SC, ארה"ב.
US_TX_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 יוטה, ארה"ב.
US_VA_EZPASSVA וירג'יניה, ארה"ב.
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 Code. פרטים נוספים זמינים בכתובת https://plus.codes.