קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מפתחים באזור הכלכלי האירופי (EEA)
מודלים של תנועה משתמשים באלגוריתמים ובגורמים ספציפיים כדי לחזות איך תנאי התנועה ישפיעו על זמן הנסיעה הכולל במסלול נתון. ב-Routes API יש סוגים שונים של מודלים לתעבורה, שמאפשרים לתת עדיפות לגורמים שונים שמשמשים לחישוב משך הנסיעה בתנאי תנועה. אתם יכולים לציין את סוג מודל התנועה שבו אתם רוצים להשתמש בחישוב משך הזמן של המסלולים או מטריצת המסלולים. כשמגדירים את סוג מודל התנועה, הערך שמוחזר בשדה duration משתנה בהתאם למודל התנועה שנבחר.
גם ממשק Routes API Compute Routes וגם שיטות Compute Route Matrix תומכים בסוגים של מודלים לתנועה.
כברירת מחדל, שתי השיטות משתמשות בסוג מודל התנועה BEST_GUESS.
כדי לציין סוג תנועה
מגדירים את נקודת המוצא ואת היעד.
אם שעת ההמראה היא בעתיד, צריך לכלול את השעה באמצעות הפרמטר departure_time. אם לא מציינים שעת המראה, ברירת המחדל היא 'עכשיו'.
מגדירים את הפרמטר routingPreference לערך TRAFFIC_AWARE_OPTIMAL. הגדרת הערך של routingPreference ל-TRAFFIC_UNAWARE או ל-TRAFFIC_AWARE לא תואמת לפרמטר trafficModel.
בוחרים את מודל התנועה לשימוש עם הפרמטר trafficModel ואחד מהסוגים הבאים:
BEST_GUESS (ברירת מחדל) כדי לבקש שהערך שיוחזר duration_in_traffic
יהיה ההערכה הטובה ביותר של זמן הנסיעה, בהתחשב בנתונים הידועים על תנאי התנועה ההיסטוריים ועל התנועה בזמן אמת. נתוני התנועה בזמן אמת חשובים יותר ככל שהשעה departure_time קרובה יותר לשעה הנוכחית. שימוש בסוג ברירת המחדל BEST_GUESS מספק את התחזיות הכי שימושיות לרוב המכריע של תרחישי השימוש.
PESSIMISTIC לבקש שהמודל duration_in_traffic יחזיר את הזמן על סמך תנאי התנועה ההיסטוריים בימים עם עומסי תנועה.
הסוג הזה מספק משך זמן משוער שסביר להניח שהוא ארוך יותר מזמן הנסיעה בפועל ברוב הימים. יכול להיות שבימים מסוימים עם תנאים גרועים במיוחד, ההערכה הזו תהיה נמוכה מהמציאות.
OPTIMISTIC לבקש שהמודל יחזיר duration_in_traffic את השעה על סמך תנאי התנועה ההיסטוריים בימים שבהם התנועה טובה.
הסוג הזה מספק משך זמן משוער שסביר להניח שהוא קצר יותר ממשך הנסיעה בפועל ברוב הימים. יכול להיות שבימים מסוימים עם תנאים טובים במיוחד, המהירות תהיה גבוהה יותר מההערכה הזו.
לדוגמה:
"trafficModel":"OPTIMISTIC"
מציינים את השדה routes.duration במסכת השדות.
REST
-HX-Goog-FieldMask:routes.duration
RPC
const(fieldMask="routes.duration")
כשמשתמשים ב-Routes API כדי לאמוד את הזמן שיידרש להגעה ליעד, המערכת משתמשת בסוג מודל התנועה שביקשתם.
דוגמה: בקשה למודל תנועה
לדוגמה, בבקשה הזו מצוין שמשך הנסיעה יוערך באמצעות סוג מודל התנועה OPTIMISTIC בשעת יציאה ספציפית:
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-09-10 (שעון UTC)."],[[["\u003cp\u003eThe Routes API offers different traffic models (\u003ccode\u003eBEST_GUESS\u003c/code\u003e, \u003ccode\u003ePESSIMISTIC\u003c/code\u003e, \u003ccode\u003eOPTIMISTIC\u003c/code\u003e) to predict travel times based on various traffic conditions.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify the desired traffic model when calculating routes, with \u003ccode\u003eBEST_GUESS\u003c/code\u003e being the default, providing the most useful predictions for most use cases.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePESSIMISTIC\u003c/code\u003e models travel time based on bad traffic days, likely resulting in a longer estimated duration, while \u003ccode\u003eOPTIMISTIC\u003c/code\u003e uses good traffic days, potentially resulting in a shorter duration.\u003c/p\u003e\n"],["\u003cp\u003eLive traffic information is integrated into the \u003ccode\u003eBEST_GUESS\u003c/code\u003e model, making it potentially shorter than \u003ccode\u003eOPTIMISTIC\u003c/code\u003e or longer than \u003ccode\u003ePESSIMISTIC\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTo use traffic models, include the \u003ccode\u003etrafficModel\u003c/code\u003e parameter in your request and specify \u003ccode\u003eroutes.duration\u003c/code\u003e in the field mask.\u003c/p\u003e\n"]]],["The Routes API's traffic models predict travel time, offering `BEST_GUESS` (default), `PESSIMISTIC` (longer), and `OPTIMISTIC` (shorter) durations. To use, set the origin, destination, and optional `departure_time`. Choose a `trafficModel` type and specify `routes.duration` in the field mask. The API calculates traffic-affected durations based on the selected model. Using `BEST_GUESS` integrate live information. The default is `BEST_GUESS`, and the duration returned varies depending on the chosen model. The service is pre-GA, it might have limited support and changes.\n"],null,[]]
