מודלים של תנועה מתבססים על אלגוריתמים וגורמים ספציפיים כדי לחזות את האופן שבו התנועה
התנאים משפיעים על זמן הנסיעה הכולל במסלול נתון. ממשק ה-API של Routes
מציע סוגים שונים של מודלים של תנועה כדי לתת עדיפות לגורמים שונים שמשמשים
חישוב משך הזמן בתנועה. אתם יכולים לציין את סוג מודל התנועה שתרצו להשתמש בו במסלולים שלכם לצורך חישוב משך הזמן של המסלולים או של מטריצת המסלולים. כשמגדירים את סוג מודל התנועה, הערך המוחזר בפונקציה
השדה duration
משתנה בהתאם למודל התנועה שבוחרים.
גם ה-API של המסלול Compute Routes
וגם
השיטות של Compute Route Matrix
תומכות בסוגים של מודלים של תנועה.
כברירת מחדל, שתי השיטות משתמשות בסוג מודל התנועה BEST_GUESS
.
כדי לציין סוג תנועה
מגדירים את המוצא ואת היעד.
אם שעת היציאה היא בעתיד, יש לציין את השעה באמצעות הפרמטר
departure_time
. אם לא תציינו שעת יציאה, מוגדר כברירת מחדל עכשיו.בוחרים את מודל התנועה לשימוש עם הפרמטר
trafficModel
ו אחד מהסוגים הבאים:BEST_GUESS
(ברירת המחדל) כדי לבקש שהשדהduration_in_traffic
הוחזר הוא האומדן הטוב ביותר של זמן הנסיעה בהינתן מה שידוע לגבי שני הסוגים נתונים היסטוריים של מצב התנועה ושל תנועה בזמן אמת. ככל ש-departure_time
קרוב יותר לזמן הנוכחי, התנועה בזמן אמת נעשית חשובה יותר. שימוש בסוג ברירת המחדל שלBEST_GUESS
מניב את התחזיות השימושיות ביותר ברוב המכריע של תרחישי השימוש.PESSIMISTIC
כדי לבקש שהמודלduration_in_traffic
שהוחזר ימחיש את מבוסס על מצב התנועה ההיסטורי בימים שבהם התנועה הייתה בעייתית. הסוג הזה מספק משך זמן משוער שככל הנראה ארוך יותר מ- זמן הנסיעה בפועל ברוב הימים. ימים מדי פעם עם בעיות קשות במיוחד והתנאים עדיין עשויים לחרוג מהאומדן הזה.OPTIMISTIC
כדי לבקש שהמודלduration_in_traffic
שהוחזר ימחיש את מבוסס על מצב התנועה בעבר בימים שבהם התנועה הייתה טובה. בסוג זה, משך הזמן המשוער שסביר להניח שהוא קצר יותר מ- זמן הנסיעה בפועל ברוב הימים. בימים מסוימים עם תנאים מיוחדים, ייתכן שהזמן עד להשלמת ההעברה יהיה קצר יותר מהזמן המשוער.
לדוגמה:
"trafficModel": "OPTIMISTIC"
מציינים את השדה
routes.duration
במסכת השדות.REST
-H X-Goog-FieldMask: routes.duration
RPC
const (fieldMask = "routes.duration")
כשה-API של המסלול מעריך את זמן התנועה, הוא משתמש בתנועה סוג המודל שביקשתם.
דוגמה: בקשה למודל תנועה
לדוגמה, הבקשה הזו מציינת את משך הזמן המשוער באמצעות
סוג מודל תנועה אחד (OPTIMISTIC
) בזמן יציאה ספציפי:
curl -X POST -H 'content-type: application/json' -d ' { "origin": { "address": "Kyoto, Japan" }, "destination": { "placeId": "ChIJrYtcv-urAWAR3XzWvXv8n_s" }, "travelMode": "DRIVE", "routingPreference": "TRAFFIC_AWARE_OPTIMAL", "trafficModel": "OPTIMISTIC" }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
בקשה זו מחזירה את משך הזמן המשוער באמצעות מודל התנועה OPTIMISTIC
סוג הנסיעה:
"duration": "1238s"
אם משנים את סוג מודל התנועה ל-PESSIMISTIC
, משך הזמן המוחזר ארוך יותר:
"duration": "2436s"