אינדקס
RoutesPreferred
(ממשק)ComputeCustomRoutesRequest
(מֶסֶר)ComputeCustomRoutesResponse
(מֶסֶר)ComputeCustomRoutesResponse.FallbackInfo
(מֶסֶר)ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective
(טיפוסים בני מנייה)ComputeRouteMatrixRequest
(מֶסֶר)ComputeRoutesRequest
(מֶסֶר)ComputeRoutesResponse
(מֶסֶר)CustomRoute
(מֶסֶר)FallbackInfo
(מֶסֶר)FallbackReason
(טיפוסים בני מנייה)FallbackRoutingMode
(טיפוסים בני מנייה)Location
(מֶסֶר)Maneuver
(טיפוסים בני מנייה)NavigationInstruction
(מֶסֶר)Polyline
(מֶסֶר)PolylineEncoding
(טיפוסים בני מנייה)PolylineQuality
(טיפוסים בני מנייה)Route
(מֶסֶר)RouteLeg
(מֶסֶר)RouteLegStep
(מֶסֶר)RouteLegStepTravelAdvisory
(מֶסֶר)RouteLegTravelAdvisory
(מֶסֶר)RouteMatrixDestination
(מֶסֶר)RouteMatrixElement
(מֶסֶר)RouteMatrixElementCondition
(טיפוסים בני מנייה)RouteMatrixOrigin
(מֶסֶר)RouteModifiers
(מֶסֶר)RouteObjective
(מֶסֶר)RouteObjective.RateCard
(מֶסֶר)RouteObjective.RateCard.MonetaryCost
(מֶסֶר)RouteTravelAdvisory
(מֶסֶר)RouteTravelMode
(טיפוסים בני מנייה)RoutingPreference
(טיפוסים בני מנייה)SpeedReadingInterval
(מֶסֶר)SpeedReadingInterval.Speed
(טיפוסים בני מנייה)TollInfo
(מֶסֶר)TollPass
(טיפוסים בני מנייה)Units
(טיפוסים בני מנייה)VehicleEmissionType
(טיפוסים בני מנייה)VehicleInfo
(מֶסֶר)Waypoint
(מֶסֶר)
RoutesPreferred
ה-Routes Preferred API.
ComputeCustomRoutes |
---|
בהינתן קבוצה של ציוני דרך סופיים ובלתי ביניים, ומטרת מסלול, מחשבת את המסלול הטוב ביותר עבור יעד המסלול. כמו כן, מחזירה את המסלול המהיר ביותר ואת המסלול הקצר ביותר כמסלולי הפניה. הערה: לשיטה הזו צריך לציין אנונימיזציה של שדות תגובה בקלט. אפשר לספק את האנונימיזציה של שדות התגובה באמצעות הפרמטר של כתובת ה-URL לדוגמה, בשיטה הזו:
Google לא ממליצה להשתמש באנונימיזציה של שדה התשובה עם התו הכללי לחיפוש (
|
ComputeRouteMatrix |
---|
לוקחת רשימה של נקודות מוצא ויעד ומחזירה זרם שמכיל מידע על המסלול לכל שילוב של נקודות מוצא ויעד. הערה: לשיטה הזו צריך לציין אנונימיזציה של שדות תגובה בקלט. אפשר לספק את האנונימיזציה של שדות התגובה באמצעות הפרמטר של כתובת ה-URL לדוגמה, בשיטה הזו:
חשוב מאוד לכלול את
|
ComputeRoutes |
---|
מחזירה את הנתיב הראשי יחד עם מסלולים חלופיים אופציונליים, בהינתן קבוצה של ציוני דרך סופיים ונקודות ביניים. הערה: לשיטה הזו צריך לציין אנונימיזציה של שדות תגובה בקלט. אפשר לספק את האנונימיזציה של שדות התגובה באמצעות הפרמטר של כתובת ה-URL לדוגמה, בשיטה הזו:
Google לא ממליצה להשתמש באנונימיזציה של שדה התשובה עם התו הכללי לחיפוש (
|
ComputeCustomRoutesRequest
הודעת הבקשה של ComputeCustomRoutes.
שדות | |
---|---|
origin |
חובה. ציון הדרך של נקודת המוצא. |
destination |
חובה. ציון הדרך של היעד. |
intermediates[] |
אפשרות. קבוצת ציוני דרך לאורך המסלול (לא כולל נקודות קצה), לעצירה או להמתנה. ניתן לכלול עד 25 ציוני דרך. |
travel_mode |
אפשרות. מציין את אמצעי התחבורה. רק drive נתמך עכשיו. |
routing_preference |
אפשרות. מציין את אופן חישוב המסלול. השרת מנסה להשתמש בהעדפת הניתוב שנבחרה כדי לחשב את המסלול. אם העדפת הניתוב מובילה לשגיאה או לזמן אחזור ארוך במיוחד, תוחזר שגיאה. בעתיד, ייתכן שניישם מנגנון חלופה לשימוש באפשרות אחרת, כאשר האפשרות המועדפת אינה מספקת תוצאה חוקית. אפשר לציין את האפשרות הזו רק כאשר הערך של |
polyline_quality |
אפשרות. מציין את ההעדפה שלכם לאיכות של הקו מרובה. |
polyline_encoding |
אפשרות. מציין את הקידוד המועדף לקו מרובה-הקווים. |
departure_time |
אפשרות. שעת היציאה. אם לא תגדירו את הערך הזה, ערך ברירת המחדל יהיה השעה שבה שלחתם את הבקשה. אם מגדירים את הערך הזה למועד שכבר התרחש, הבקשה תיכשל. |
route_modifiers |
אפשרות. קבוצת תנאים שיש לעמוד בהם, שמשפיעים על אופן החישוב של המסלולים. |
route_objective |
חובה. יעד של מסלול שהמערכת יכולה לבצע עבורו אופטימיזציה. |
language_code |
אפשרות. קוד השפה BCP-47, למשל "en-US" או "sr-Latn". מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. כאן אפשר למצוא את רשימת השפות הנתמכות. אם לא תספקו את הערך הזה, המערכת תסיק את שפת התצוגה לפי המיקום של בקשת המסלול. |
units |
אפשרות. מציינת את יחידות המידה בשדות התצוגה. כולל השדה |
ComputeCustomRoutesResponse
הודעת התגובה של ComputeCustomRoutes.
שדות | |
---|---|
routes[] |
המסלולים 'הטובים ביותר' ליעד של מסלול הקלט. |
fastest_route |
מסלול ההפניה המהיר ביותר. |
shortest_route |
מסלול ההפניה הקצר ביותר. |
fallback_info |
מידע חלופי במסלולים מותאמים אישית. |
FallbackInfo
אנקפסולציה של פרטי החלופה עבור ComputeCustomRoutes. ל-ComputeCustomRoutes יש שני סוגים של חלופות:
אם אין אפשרות לחשב את המסלול באמצעות Tracking_preference המבוקש על ידי הלקוח, הוא יחזור למצב ניתוב אחר. במקרה הזה, הערכים fallback_routing_mode ו-route_mode_fallback_reason משמשים להעברת מצב הניתוב החלופי שבו נעשה שימוש, וכן לסיבת החלופה.
אם הוא לא יכול לחשב את המסלול 'הטוב ביותר' עבור יעד המסלול שצוין על ידי הלקוח, הוא עשוי להיכנע למטרה אחרת. הפונקציה fallback_route_objective משמשת להעברת יעד המסלול החלופי.
שדות | |
---|---|
routing_mode |
מצב הניתוב ששימש לתשובה. אם הופעלה חלופה, ייתכן שהמצב יהיה שונה מהעדפות הניתוב שהוגדרו בבקשת הלקוח המקורית. |
routing_mode_reason |
הסיבה לכך שנעשה שימוש בתגובת החזרה במקום בתגובה המקורית. השדה הזה יאוכלס רק כשמצב החזרה מופעל ומוחזרת תגובת הגיבוי. |
route_objective |
יעד המסלול ששימש לתשובה. אם הופעלה חלופה, היעד עשוי להיות שונה מיעד המסלול שצוין בבקשת הלקוח המקורית. |
FallbackRouteObjective
RouteObjective משמש לתשובה.
טיפוסים בני מנייה (enums) | |
---|---|
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED |
לא צוינה מטרת המסלול לגיבוי. |
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA |
אם הלקוח מבקש את RateCard ומגדיר את הפרמטר include_tolls כ-true, ול-Google אין צורך בנתוני מחיר האגרה עבור המסלול, ה-API חוזר לשימוש ב-RateCard בלי להתייחס למחיר האגרה. |
ComputeRouteMatrixRequest
הודעת בקשה של ComputeRouteMatrix
שדות | |
---|---|
origins[] |
חובה. מערך מקורות, שקובע את השורות במטריצת התגובה. יש כמה מגבלות גודל שחלות על העוצמה של מקורות ויעדים:
|
destinations[] |
חובה. מערך של יעדים, שקובע את העמודות במטריצת התגובות. |
travel_mode |
אפשרות. מציין את אמצעי התחבורה. |
routing_preference |
אפשרות. מציין את אופן חישוב המסלול. השרת מנסה להשתמש בהעדפת הניתוב שנבחרה כדי לחשב את המסלול. אם העדפת הניתוב מובילה לשגיאה או לזמן אחזור ארוך במיוחד, תוחזר שגיאה. בעתיד, ייתכן שניישם מנגנון חלופה לשימוש באפשרות אחרת, כאשר האפשרות המועדפת אינה מספקת תוצאה חוקית. אפשר לציין את האפשרות הזו רק כאשר הערך של |
departure_time |
אפשרות. שעת היציאה. אם לא תגדירו את הערך הזה, ברירת המחדל תהיה השעה שבה שלחתם את הבקשה. אם מגדירים את הערך הזה לזמן שכבר התרחש, הבקשה תיכשל. |
ComputeRoutesRequest
הודעת הבקשה של ComputeRoutes.
שדות | |
---|---|
origin |
חובה. ציון הדרך של נקודת המוצא. |
destination |
חובה. ציון הדרך של היעד. |
intermediates[] |
אפשרות. קבוצת ציוני דרך לאורך המסלול (לא כולל נקודות קצה), לעצירה או להמתנה. ניתן לכלול עד 25 ציוני דרך. |
travel_mode |
אפשרות. מציין את אמצעי התחבורה. |
routing_preference |
אפשרות. מציין את אופן חישוב המסלול. השרת מנסה להשתמש בהעדפת הניתוב שנבחרה כדי לחשב את המסלול. אם העדפת הניתוב מובילה לשגיאה או לזמן אחזור ארוך במיוחד, תוחזר שגיאה. בעתיד, ייתכן שניישם מנגנון חלופה לשימוש באפשרות אחרת, כאשר האפשרות המועדפת אינה מספקת תוצאה חוקית. אפשר לציין את האפשרות הזו רק כאשר הערך של |
polyline_quality |
אפשרות. מציין את ההעדפה שלכם לאיכות של הקו מרובה. |
polyline_encoding |
אפשרות. מציין את הקידוד המועדף לקו מרובה-הקווים. |
departure_time |
אפשרות. שעת היציאה. אם לא תגדירו את הערך הזה, ערך ברירת המחדל יהיה השעה שבה שלחתם את הבקשה. אם מגדירים את הערך הזה למועד שכבר התרחש, הבקשה תיכשל. |
compute_alternative_routes |
מציינת אם לחשב מסלולים חלופיים בנוסף למסלול. |
route_modifiers |
אפשרות. קבוצת תנאים שיש לעמוד בהם, שמשפיעים על אופן החישוב של המסלולים. |
language_code |
אפשרות. קוד השפה BCP-47, למשל "en-US" או "sr-Latn". מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. כאן אפשר למצוא את רשימת השפות הנתמכות. אם לא תספקו את הערך הזה, המערכת תסיק את שפת התצוגה לפי המיקום של בקשת המסלול. |
units |
אפשרות. מציינת את יחידות המידה בשדות התצוגה. כולל השדה |
optimize_waypoint_order |
אם OptimizeWaypointOrder מוגדר כ-True, יתבצע ניסיון לשנות את הסדר של נקודות הביניים שצוינו כדי למזער את העלות הכוללת של המסלול. אם אחת מציוני הדרך ברמת הביניים היא דרך ציון דרך, הבקשה תיכשל. כדי למצוא את הסדר החדש, אפשר להשתמש ב-ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index אם לא מוצגת בקשה למסלולים.optimized_intermediate_waypoint_index בכותרת |
ComputeRoutesResponse
ComputeRoutes את הודעת התגובה.
שדות | |
---|---|
routes[] |
מכילה מערך של נתיבים מחושבים (עד שלושה) כשמציינים compute_alternatives_routes, ומכיל רק נתיב אחד כשמציינים אחרת. אם המערך הזה מכיל כמה ערכים, הראשון הוא המסלול המומלץ ביותר. אם המערך ריק, פירוש הדבר שלא נמצא נתיב. |
fallback_info |
במקרים מסוימים שבהם לשרת אין אפשרות לחשב את תוצאות המסלול עם כל העדפות הקלט, הוא עשוי לחזור ולהשתמש בדרך חישוב אחרת. כשמשתמשים במצב חלופה, השדה הזה מכיל מידע מפורט על התגובה החלופית. אחרת השדה הזה לא מוגדר. |
CustomRoute
אנקפסולציה של נתיב מותאם אישית שמחושב על סמך יעד המסלול שצוין על ידי הלקוח. CustomRoute מכיל נתיב ואסימון מסלול, שניתן להעביר ל-NavSDK כדי ליצור מחדש את המסלול המותאם אישית לניווט לפי מסלול מפורט.
שדות | |
---|---|
route |
המסלול שנחשב 'הטוב ביותר' עבור היעד של נתיב הקלט. |
token |
אסימון מסלול עם קידוד base64 שבטוח לשימוש באינטרנט וניתן להעביר אותו אל NavSDK, וכך לאפשר ל-NavSDK לבנות מחדש את הנתיב במהלך הניווט, ובמקרה של ניתוב מחדש, יכבדו את הכוונה המקורית כשהקריאה ל-RoutesPreferred ComputeCustomRoutes מתבצעת. הלקוחות צריכים להתייחס לאסימון הזה כאל blob אטום. |
FallbackInfo
מידע שקשור לאופן ולסיבות לשימוש בתוצאה חלופית. אם השדה הזה מוגדר, השרת השתמש במצב ניתוב שונה מהמצב המועדף עליכם כחלופה.
שדות | |
---|---|
routing_mode |
מצב הניתוב ששימש לתשובה. אם הופעלה חלופה, ייתכן שהמצב יהיה שונה מהעדפות הניתוב שהוגדרו בבקשת הלקוח המקורית. |
reason |
הסיבה לכך שנעשה שימוש בתגובת החזרה במקום בתגובה המקורית. השדה הזה יאוכלס רק כשמצב החזרה מופעל ומוחזרת תגובת הגיבוי. |
FallbackReason
סיבות לשימוש בתגובה חלופית.
טיפוסים בני מנייה (enums) | |
---|---|
FALLBACK_REASON_UNSPECIFIED |
לא צוינה סיבה לחלופה. |
SERVER_ERROR |
אירעה שגיאת שרת במהלך חישוב המסלולים במצב הניתוב המועדף עליך, אבל הצלחנו להחזיר תוצאה שחושבה על ידי מצב חלופי. |
LATENCY_EXCEEDED |
לא הצלחנו לסיים את החישוב עם מצב הניתוב המועדף עליך בזמן, אבל הצלחנו להחזיר תוצאה שמחושבת באמצעות מצב חלופי. |
FallbackRoutingMode
מצב הניתוב בפועל ששימש לתגובת החלופה שהוחזרה.
טיפוסים בני מנייה (enums) | |
---|---|
FALLBACK_ROUTING_MODE_UNSPECIFIED |
לא בשימוש. |
FALLBACK_TRAFFIC_UNAWARE |
מציין שמצב הניתוב "TRAFFIC_UNAWARE" שימש לחישוב התגובה. |
FALLBACK_TRAFFIC_AWARE |
מציין שמצב הניתוב "TRAFFIC_AWARE" שימש לחישוב התגובה. |
מיקום
מכסה מיקום (נקודה גיאוגרפית וכותרת אופציונלית).
שדות | |
---|---|
lat_lng |
הקואורדינטות הגיאוגרפיות של ציון הדרך. |
heading |
כותרת המצפן הקשורה לכיוון זרימת התנועה. הערך הזה משמש לציון צד הדרך לשימוש באיסוף ובהורדה. ערכי הכותרת יכולים להיות בין 0 ל-360, כאשר 0 מציין כותרת לצפון, 90 מציין כותרת למזרח הקרוב וכו'. אפשר להשתמש בשדה הזה רק למצבי נסיעה |
תמרון
קבוצת ערכים שמציינים את פעולת הניווט שצריך לבצע בשלב הנוכחי (למשל: פנייה שמאלה, מיזוג, ישר וכו').
טיפוסים בני מנייה (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 |
בכיכר פנו ימינה. |
מצולע פתוח
יוצרת פוליגון מקודד.
שדות | |
---|---|
שדה איחוד polyline_type . מחזירה את סוג הקו polyline. ברירת המחדל היא code_polyline. הערך של polyline_type יכול להיות רק אחת מהאפשרויות הבאות: |
|
encoded_polyline |
קידוד המחרוזת של הקו מרובה באמצעות אלגוריתם הקידוד של polyline |
geo_json_linestring |
מציינת קו פוליגוני באמצעות פורמט GeoJSON LineString |
PolylineEncoding
מציין את סוג הפוליגון המועדף שיש להחזיר.
טיפוסים בני מנייה (enums) | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
לא צוינה העדפה של סוג קו פוליגון. ברירת המחדל היא ENCODED_POLYLINE . |
ENCODED_POLYLINE |
מציינת קו פוליגוני מקודד באמצעות אלגוריתם הקידוד של polyline. |
GEO_JSON_LINESTRING |
מציינת קו פוליגוני באמצעות פורמט GeoJSON LineString |
PolylineQuality
קבוצת ערכים שמציינים את איכות ה-polyline.
טיפוסים בני מנייה (enums) | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
לא צוינה העדפת איכות לקו מרובה-נקודות. ברירת המחדל היא OVERVIEW . |
HIGH_QUALITY |
מציין קו פוליגוני באיכות גבוהה, שמורכב ממספר נקודות גדול יותר מאשר OVERVIEW , במחיר של תגובה מוגדלת. כדאי להשתמש בערך הזה אם רוצים לשפר את הדיוק. |
OVERVIEW |
מציין קו מרובה נקודות של סקירה כללית - שמורכב ממספר קטן של נקודות. אפשר להשתמש בערך הזה כשמציגים סקירה כללית של המסלול. לשימוש באפשרות הזו יש זמן אחזור נמוך יותר של בקשות בהשוואה לשימוש באפשרות HIGH_QUALITY . |
נתיב
כולל נתיב שמורכב מסדרה של קטעי דרך מחוברים שמחברים בין ציוני דרך להתחלה, לסיום ולביניים.
שדות | |
---|---|
legs[] |
אוסף של רגליים (קטעי נתיב בין ציוני דרך) שמרכיבים את המסלול. כל מקטע תואם למעבר בין שתי ציוני דרך שאינם |
distance_meters |
מרחק הנסיעה במטרים. |
duration |
משך הזמן הדרוש לניווט במסלול. אם מגדירים את |
static_duration |
משך הנסיעה במסלול בלי להתחשב במצב התנועה. |
polyline |
קו מרובה של המסלול הכולל. קו מרובה זה יהיה הקו המשולב של כל |
description |
תיאור של המסלול. |
warnings[] |
מערך של אזהרות שיוצגו בעת הצגת המסלול. |
viewport |
התיבה התוחמת את אזור התצוגה של הקו מרובה. |
travel_advisory |
מידע נוסף על המסלול. |
optimized_intermediate_waypoint_index[] |
אם הערך של ComputeRoutesRequest.optimize_waypoint_order הוא True, השדה הזה מכיל את הסדר האופטימלי של ציוני הדרך של תהליכי הביניים. אחרת, השדה הזה ריק. לדוגמה, נניח שהקלט הוא מקור: LA; ביניים: דאלאס, בנגור, פיניקס; יעד: ניו יורק; וסדר ציון הביניים שעבר אופטימיזציה הוא: פיניקס, דאלאס, בנגור. לאחר מכן השדה הזה מכיל את הערכים [2, 0, 1]. האינדקס מתחיל ב-0 לנקודת הביניים הראשונה. |
RouteLeg
הפונקציה יוצרת קטע בין ציוני דרך שאינם via
.
שדות | |
---|---|
distance_meters |
מרחק הנסיעה של קטע המסלול, במטרים. |
duration |
משך הזמן הנדרש לניווט בקטע הרגל. אם |
static_duration |
משך הנסיעה לאורך הרגל, ללא התחשבות בתנאי התנועה. |
polyline |
הקו הפוליגוני הכולל עבור קטע זה. כולל קו polyline של כל |
start_location |
המיקום ההתחלתי של הקטע הזה. יכול להיות שהערך הזה שונה מהערך שציינתם בשדה |
end_location |
המיקום הסופי של הקטע הזה. יכול להיות שהערך הזה שונה מהערך שציינתם בשדה |
steps[] |
מערך של שלבים לציון קטעים בתוך הקטע הזה. כל שלב מייצג הוראת ניווט אחת. |
travel_advisory |
כולל מידע נוסף שצריך ליידע את המשתמש, כמו הגבלות אפשריות על אזור התנועה וכו' במסלול. |
RouteLegStep
כולל קטע של RouteLeg
. כל שלב מייצג הוראת ניווט אחת. רגלי המסלול מורכבות ממדרגות.
שדות | |
---|---|
distance_meters |
מרחק הנסיעה של שלב זה, במטרים. בנסיבות מסוימות ייתכן שלא יהיה ערך בשדה הזה. |
static_duration |
משך הנסיעה שעוברת בשלב הזה בלי להביא בחשבון את מצב התנועה. בנסיבות מסוימות ייתכן שלא יהיה ערך בשדה הזה. |
polyline |
קו הפוליגונים המשויך לשלב הזה. |
start_location |
המיקום שבו יתחיל השלב הזה. |
end_location |
מיקום הסיום של השלב הזה. |
navigation_instruction |
הוראות ניווט. |
travel_advisory |
כולל מידע נוסף שצריך ליידע את המשתמש, כמו הגבלה אפשרית של אזור התנועה על צעד ברגל. |
RouteLegStepTravelAdvisory
כולל מידע נוסף שצריך ליידע את המשתמש, כמו הגבלה אפשרית של אזור התנועה על צעד ברגל.
שדות | |
---|---|
speed_reading_intervals[] |
מרווחי זמן בקריאת מהירות שמפרטים את צפיפות התנועה. רלוונטי במקרה של העדפות ניתוב מסוג דוגמה:
|
RouteLegTravelAdvisory
כולל מידע נוסף שצריך ליידע את המשתמש, כמו הגבלות אפשריות על אזור התנועה וכו' במסלול.
שדות | |
---|---|
toll_info |
כולל מידע לגבי כבישי אגרה ב-RouteLeg הספציפי. השדה הזה יאוכלס רק אם אנחנו צופים שיהיו כבישי אגרה ב-RouteLeg. אם השדה הזה מוגדר אבל שדה המשנה destination_price לא יאוכלס, אנחנו צופים שהכביש יכלול כבישי אגרה, אבל אנחנו לא יודעים מחיר משוער. אם השדה הזה לא קיים, לא יחול אגרה על RouteLeg. |
speed_reading_intervals[] |
מרווחי זמן בקריאת מהירות שמפרטים את צפיפות התנועה. רלוונטי במקרה של העדפות ניתוב מסוג דוגמה:
|
RouteMatrixDestination
יעד אחד ל-ComputeRouteMatrixRequest
שדות | |
---|---|
waypoint |
חובה. ציון דרך ביעד |
RouteMatrixElement
מבצעת אנקפסולציה של פרטי המסלול שמחושבים עבור צמד נקודות מוצא/יעד ב-ComputeRouteMatrix API. ניתן לשדר את קובץ ה-proto ללקוח.
שדות | |
---|---|
origin_index |
אינדקס מבוסס-אפס של המקור בבקשה. |
destination_index |
אינדקס מבוסס-אפס של היעד בבקשה. |
status |
קוד מצב שגיאה של הרכיב הזה. |
condition |
מציין אם המסלול נמצא או לא. אינו תלוי בסטטוס. |
distance_meters |
מרחק הנסיעה במטרים. |
duration |
משך הזמן הדרוש לניווט במסלול. אם מגדירים את |
static_duration |
משך הנסיעה במסלול בלי להתחשב במצב התנועה. |
travel_advisory |
מידע נוסף על המסלול. לדוגמה: מידע על ההגבלות ומידע על כבישי אגרה |
fallback_info |
במקרים מסוימים שבהם לשרת אין אפשרות לחשב את המסלול עם ההעדפות הנתונות עבור צמד המוצא והיעד הספציפי הזה, הוא עשוי לחזור ולהשתמש במצב חישוב אחר. כשמשתמשים במצב חלופה, השדה הזה מכיל מידע מפורט על תגובת החלופה. אחרת השדה הזה לא מוגדר. |
RouteMatrixElementCondition
התנאי של המסלול שמוחזר.
טיפוסים בני מנייה (enums) | |
---|---|
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED |
בשימוש רק כאשר status של הרכיב אינו תקין. |
ROUTE_EXISTS |
נמצא מסלול, ומילא את המידע המתאים עבור הרכיב. |
ROUTE_NOT_FOUND |
לא נמצא מסלול. שדות המכילים מידע על מסלול, כגון distance_meters או duration , לא ימולאו ברכיב. |
RouteMatrixOrigin
מקור יחיד עבור ComputeRouteMatrixRequest
שדות | |
---|---|
waypoint |
חובה. ציון דרך של נקודת המוצא |
route_modifiers |
אפשרות. מגבילי התאמה לכל מסלול שמזהה אותו כמקור |
RouteModifiers
הפונקציה מחשבת קבוצה של תנאים אופציונליים שצריך לעמוד בהם במהלך חישוב המסלולים.
שדות | |
---|---|
avoid_tolls |
ההגדרה קובעת אם יש להימנע מכבישי אגרה במקומות סבירים. תינתן עדיפות למסלולים שאינם מכילים כבישי אגרה. רלוונטי רק למצבי הנסיעות |
avoid_highways |
ההגדרה מציינת אם להימנע מכבישים מהירים במקומות סבירים. תינתן עדיפות למסלולים שאינם מכילים כבישים מהירים. רלוונטי רק למצבי הנסיעות |
avoid_ferries |
ההגדרה קובעת אם יש להימנע ממעבורות במקומות סבירים. תינתן עדיפות למסלולים שאינם מכילים נסיעות במעבורות. רלוונטי רק למצבי הנסיעות |
avoid_indoor |
ההגדרה קובעת אם יש להימנע מניווט בתוך מבנים במקומות סבירים. תינתן עדיפות למסלולים שלא מכילים ניווט בתוך מבנים. רלוונטי רק לאמצעי ההגעה |
vehicle_info |
מציין את פרטי הרכב. |
toll_passes[] |
כולל מידע על אישורי מעבר לכבישי אגרה. אם תספקו אישורי מעבר לכבישי אגרה, ממשק ה-API ינסה להחזיר את מחיר הכרטיס. אם לא תספקו אישורי מעבר לכבישי אגרה, ממשק ה-API יתייחס למינוי לכבישי אגרה בתור כרטיסים לא ידועים וינסה להחזיר את המחיר במזומן. רלוונטי רק למצבי הנסיעה drive ו-TWO_WHEELER. |
RouteObjective
הפונקציה מבצעת אופטימיזציה של מטרה עסקית לפי ComputeCustomRoutes.
שדות | |
---|---|
rate_card |
יעד RateCard. |
RateCard
מכיל יעד נתיב של RateCard.
שדות | |
---|---|
cost_per_minute |
אפשרות. עלות לדקה. |
cost_per_km |
אפשרות. עלות לקילומטר. |
include_tolls |
אפשרות. האם לכלול את עלות האגרה בעלות הכוללת. |
MonetaryCost
חישוב העלות של מחירון.
שדות | |
---|---|
value |
חובה. ערך העלות במטבע המקומי שהמערכת מסיקה מהבקשה. |
RouteTravelAdvisory
כולל מידע נוסף שצריך ליידע את המשתמש, כמו הגבלות אפשריות על אזורי תנועה וכו'.
שדות | |
---|---|
toll_info |
כולל מידע על כבישי אגרה. השדה הזה יאוכלס רק אם אנחנו צופים שיהיו כבישי אגרה. אם השדה הזה מוגדר אבל שדה המשנה destination_price לא יאוכלס, אנחנו צופים שהכביש יכלול כבישי אגרה, אבל אנחנו לא יודעים מחיר משוער. אם השדה הזה לא מוגדר, אנחנו צופים שלא תהיה כבישי אגרה. |
speed_reading_intervals[] |
מרווחי זמן בקריאת מהירות שמפרטים את צפיפות התנועה. רלוונטי במקרה של העדפות ניתוב מסוג דוגמה:
|
RouteTravelMode
קבוצת ערכים המשמשת לציון אמצעי הנסיעה.
טיפוסים בני מנייה (enums) | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
לא צוין מצב נסיעה. ברירת המחדל היא DRIVE . |
DRIVE |
נוסעים ברכב נוסעים. |
BICYCLE |
נסיעה באופניים. |
WALK |
טייל בהליכה. |
TWO_WHEELER |
כלי רכב דו-גלגלי וממונע. לדוגמה, אופנוע. חשוב לשים לב שהמצב הזה שונה ממצב הנסיעה BICYCLE , שמכסה מצב הפעלה על ידי בני אדם. |
TAXI |
נסיעה במונית מורשית שעלולה לאפשר לרכב לנסוע בנתיבי מוניות ייעודיים באזורים מסוימים. מצב TAXI הוא תכונה ניסיונית. אם לקוח מבקש מסלול TAXI בעיר שבה אין נתונים זמינים לגבי נתיב המוניות, מוחזר מסלול drive. |
RoutingPreference
קבוצת ערכים המציינים גורמים שיש להביא בחשבון במהלך חישוב המסלול.
טיפוסים בני מנייה (enums) | |
---|---|
ROUTING_PREFERENCE_UNSPECIFIED |
לא צוינה העדפת ניתוב. ברירת המחדל היא TRAFFIC_AWARE . |
TRAFFIC_UNAWARE |
מחשב מסלולים בלי להתחשב במצב התנועה. מתאים כשמצב התנועה לא משנה. שימוש בערך הזה יגרום לזמן האחזור הנמוך ביותר. |
TRAFFIC_AWARE |
הפונקציה מחשבת מסלולים תוך התחשבות במצב התנועה. בניגוד ל-TRAFFIC_AWARE_OPTIMAL , חלק מהאופטימיזציות מיושמות כדי לצמצם באופן משמעותי את זמן האחזור. |
TRAFFIC_AWARE_OPTIMAL |
מחשבת את המסלולים תוך התחשבות בתנאי התנועה, בלי ליישם את רוב אופטימיזציות הביצועים. שימוש בערך הזה יגרום לזמן האחזור הגבוה ביותר. |
SpeedReadingInterval
אינדיקטור לצפיפות התנועה בקטע רציף של קו פוליגוני או נתיב. בהינתן נתיב עם נקודות P_0, P_1, ... , P_N (אינדקס מבוסס אפס), ה-SpeedReadingInterval מגדיר מרווח ומתאר את התנועה שלו באמצעות הקטגוריות הבאות.
שדות | |
---|---|
start_polyline_point_index |
האינדקס ההתחלתי של המרווח הזה בקו הפוליגון. ב-JSON, כשהאינדקס הוא 0, נראה שהשדה לא מאוכלס. |
end_polyline_point_index |
אינדקס הסיום של המרווח הזה בקו הפוליגון. ב-JSON, כשהאינדקס הוא 0, נראה שהשדה לא מאוכלס. |
speed |
מהירות התנועה במרווח התנועה הזה. |
מהירות
הסיווג של מהירות הפוליגונים על סמך נתוני התנועה.
טיפוסים בני מנייה (enums) | |
---|---|
SPEED_UNSPECIFIED |
ערך ברירת המחדל. הערך הזה לא בשימוש. |
NORMAL |
מהירות רגילה, לא זוהתה האטה. |
SLOW |
זוהתה האטה, אבל לא נוצר פקק תנועה. |
TRAFFIC_JAM |
זוהה פקק תנועה. |
TollInfo
כולל פרטי אגרה ב-Route
או ב-RouteLeg
.
שדות | |
---|---|
estimated_price[] |
הסכום הכספי של אגרות ה-RouteLeg או ל-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 |
הודו, פטור מרישיון לוחית רישוי של מדינה בארה"ב. |
MX_TAG_IAVE |
מינוי לכבישי אגרה במקסיקו. |
MX_TAG_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) שהונפק על ידי ה-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 |
פלורידה, ארה"ב. |
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD |
פלורידה, ארה"ב. |
US_FL_EPASS |
פלורידה, ארה"ב. |
US_FL_GIBA_TOLL_PASS |
פלורידה, ארה"ב. |
US_FL_LEEWAY |
פלורידה, ארה"ב. |
US_FL_SUNPASS |
פלורידה, ארה"ב. |
US_FL_SUNPASS_PRO |
פלורידה, ארה"ב. |
US_IL_EZPASSIL |
אילינוי, ארה"ב. |
US_IL_IPASS |
אילינוי, ארה"ב. |
US_IN_EZPASSIN |
הודו, ארה"ב. |
US_KS_BESTPASS_HORIZON |
קנזס, ארה"ב. |
US_KS_KTAG |
קנזס, ארה"ב. |
US_KS_NATIONALPASS |
קנזס, ארה"ב. |
US_KS_PREPASS_ELITEPASS |
קנזס, ארה"ב. |
US_KY_RIVERLINK |
KY, ארה"ב. |
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_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG |
מישיגן, ארה"ב. |
US_MI_IQ_PROX_CARD |
מישיגן, ארה"ב. |
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_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_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_NEWELL_TOLL_BRIDGE_TICKET |
WV, ארה"ב. |
יחידות
קבוצת ערכים שמציינת את יחידת המידה שנעשה בה שימוש בתצוגה.
טיפוסים בני מנייה (enums) | |
---|---|
UNITS_UNSPECIFIED |
לא צוינו יחידות מידה. ברירת המחדל היא יחידת המידה הנגזרת מהבקשה. |
METRIC |
יחידות מידה מטריות. |
IMPERIAL |
יחידות מידה אימפריאליות (אנגלית). |
VehicleEmissionType
קבוצת ערכים שמתארת את סוג הפליטה של הרכב. רלוונטי רק למצב הנסיעות ב-Drive.
טיפוסים בני מנייה (enums) | |
---|---|
VEHICLE_EMISSION_TYPE_UNSPECIFIED |
לא צוין סוג פליטה. ברירת המחדל היא GASOLINE. |
GASOLINE |
רכב מונע בבנזין/דלק. |
ELECTRIC |
רכב שמופעל בחשמל. |
HYBRID |
כלי רכב שמבוסס על דלק היברידי (למשל: בנזין + חשמלי). |
VehicleInfo
מקיף את פרטי הרכב, למשל התו האחרון של לוחית הרישוי.
שדות | |
---|---|
emission_type |
מתאר את סוג הפליטה של הרכב. רלוונטי רק למצב הנסיעות ב-Drive. |
נקודת ציון
כולל ציון דרך. נקודות ציון מציינות גם את ההתחלה וגם את סופו של המסלול וכוללות עצירות ביניים לאורך המסלול.
שדות | |
---|---|
via |
סימון ציון הדרך הזה כציון דרך ולא כנקודת עצירה. עבור כל ציון דרך שלא כלול בבקשה, התגובה מצרפת רשומה למערך |
vehicle_stopover |
מציין שציון הדרך מיועד לעצירת כלי רכב, כאשר הכוונה היא לאסוף או להוריד אותו. אם מגדירים את הערך הזה, המסלול המחושב לא יכלול ציוני דרך שאינם |
side_of_road |
מציין שמיקום ציון הדרך הזה נועד באופן שבו כלי הרכב יעצור בצד מסוים של הכביש. כשמגדירים את הערך הזה, המסלול יעבור דרך המיקום כך שהרכב יוכל לעצור בצד הדרך כשהמיקום מוטה לכיוון מרכז הכביש. האפשרות הזו פועלת רק במצבי הנסיעה 'drive' ו-'TWO_WHEELER', וכשהמאפיין 'location_type' מוגדר כ-'location'. |
שדה איחוד location_type . דרכים שונות לייצג מיקום. הערך של location_type יכול להיות רק אחת מהאפשרויות הבאות: |
|
location |
נקודה שמצוינת באמצעות קואורדינטות גיאוגרפיות, כולל כותרת אופציונלית. |
place_id |
מזהה המקום של נקודת העניין שמשויך לציון הדרך. |