Package google.maps.routing.v2

אינדקס

מסלולים

הממשק של Routes API.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

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

הערה: השיטה הזו מחייבת לציין אנונימיזציה של שדה תגובה בקלט. אפשר לספק את האנונימיזציה של שדות התגובה באמצעות הפרמטר של כתובת האתר $fields או fields, או באמצעות הכותרת HTTP/gRPC X-Goog-FieldMask (מידע נוסף זמין בקטע הכותרות והפרמטרים הזמינים של כתובות אתרים). הערך הוא רשימה של נתיבי שדות שמופרדים בפסיקים. במסמך המפורט הזה מוסבר איך ליצור את נתיבי השדות.

לדוגמה, בשיטה הזו:

  • אנונימיזציה של שדות בכל השדות הזמינים (לבדיקה ידנית): X-Goog-FieldMask: *
  • אנונימיזציה של שדות לפי משך המסלול, מרחקים, סטטוס הרכיב, מצב ואינדקסים של הרכיבים (דוגמה להגדרה של ייצור): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

חשוב מאוד לכלול את status במסכת השדות, אחרת כל ההודעות ייראו בסדר. Google לא ממליצה להשתמש במסכה של שדה התשובה עם התו הכללי לחיפוש (*), כי:

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

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

הערה: השיטה הזו מחייבת לציין אנונימיזציה של שדה תגובה בקלט. אפשר לספק את האנונימיזציה של שדות התגובה באמצעות הפרמטר $fields או fields של כתובת ה-URL, או באמצעות כותרת HTTP/gRPC X-Goog-FieldMask (מידע נוסף זמין בקטע הכותרות והפרמטרים הזמינים של כתובות אתרים). הערך הוא רשימה של נתיבי שדות שמופרדים בפסיקים. אפשר לקרוא הסבר מפורט על התהליך של בניית נתיבי השדות.

לדוגמה, בשיטה הזו:

  • אנונימיזציה של שדות בכל השדות הזמינים (לבדיקה ידנית): X-Goog-FieldMask: *
  • אנונימיזציה של השדות לפי משך הזמן, המרחק והקו פוליגוני (דוגמה להגדרה בסביבת ייצור): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google לא ממליצה להשתמש במסכה של שדה התשובה עם התו הכללי לחיפוש (*), או לציין את מסכת השדות ברמה העליונה (routes), מהסיבות הבאות:

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

ComputeRouteMatrixRequest

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

שדות
origins[]

RouteMatrixOrigin

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

  • הסכום של מספר המקורות ומספר היעדים שצוינו כ-place_id או כ-address לא יכול להיות גדול מ-50.
  • המכפלה של מספר המקורות כפול מספר היעדים לא יכול להיות גדול מ-625 בכל מקרה.
  • המכפלה של מספר המקורות כפול מספר היעדים לא יכול להיות גדול מ-100 אם הערך router_preference מוגדר ל-TRAFFIC_AWARE_OPTIMAL.
  • המכפלה של מספר המקורות × מספר היעדים לא יכול להיות גדול מ-100 אם Travel_mode מוגדר ל-TRANSIT.
destinations[]

RouteMatrixDestination

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

RouteTravelMode

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

RoutingPreference

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

Timestamp

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

Timestamp

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

string

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

string

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

Units

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

ExtraComputation

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

TrafficModel

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

TransitPreferences

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

ExtraComputation

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

טיפוסים בני מנייה (enums)
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

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

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

ReferenceRoute

נתיב הפניה נתמך ב-ComputeRoutesRequest.

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

ComputeRoutesResponse

ComputeRouting את הודעת התגובה.

שדות
routes[]

Route

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

FallbackInfo

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

GeocodingResults

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

FallbackInfo

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

שדות
routing_mode

FallbackRoutingMode

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

FallbackReason

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

FallbackReason

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

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

FallbackRoutingMode

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

טיפוסים בני מנייה (enums)
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.

תמרון

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

טיפוסים בני מנייה (enums)
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. כולל את סוג הקו הפוליגוני. ברירת המחדל היא coding_polyline. polyline_type יכול להיות רק אחד מהבאים:
encoded_polyline

string

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

Struct

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

PolylineEncoding

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

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

PolylineQuality

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

טיפוסים בני מנייה (enums)
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, נקודות ביניים ביניים: דאלאס, בנגור, פיניקס; יעד: ניו יורק; וסדר נקודות הביניים שעבר אופטימיזציה הוא עוף החול, דאלאס, בנגור, השדה הזה מכיל את הערכים [2, 0, 1]. האינדקס מתחיל ב-0 לנקודת הביניים הראשונה שצוינה בקלט.
localized_values

RouteLocalizedValues

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

string

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

טיפוסים בני מנייה (enums)
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 הוא 600, הייתם מצפים להמתנה של עשר דקות אם אתם מפספסים את האוטובוס.
transit_line

TransitLine

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

int32

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

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

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

טיפוסים בני מנייה (enums)
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 של TWO_WHEELER ולDRIVE.
avoid_highways

bool

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

bool

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

bool

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

VehicleInfo

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

TollPass

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

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

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

RoutingPreference

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

טיפוסים בני מנייה (enums)
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

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

מהירות

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

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

TollInfo

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

שדות
estimated_price[]

Money

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

TollPass

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

טיפוסים בני מנייה (enums)
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 בנוסף לסטיקר CLV (רכב אוויר נקי (CAV)) שהונפק על ידי ה-DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, ארה"ב.
US_CO_GO_PASS CO, ארה"ב.
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 PA, ארה"ב.
US_RI_EZPASSRI RI, ארה"ב.
US_SC_PALPASS קרוליינה הדרומית, ארה"ב.
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 בתשובה, שמכיל את משך הזמן החזוי בתנועה על סמך ממוצעים היסטוריים.

טיפוסים בני מנייה (enums)
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

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

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

TransitTravelMode

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

טיפוסים בני מנייה (enums)
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

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

טיפוסים בני מנייה (enums)
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 אוטובוס חשמלי.

יחידות

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

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

VehicleEmissionType

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

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

VehicleInfo

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

שדות
emission_type

VehicleEmissionType

מתאר את סוג הפליטה של הרכב. רלוונטי רק לRouteTravelMode של DRIVE.

נקודת ציון

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

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