ציון סוג מודל התנועה שבו יש להשתמש

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

ה-method Compute Routes של Routes API וגם ה-method Compute Route Matrix תומכות בסוגי המודלים של התנועה.

כברירת מחדל, שתי השיטות משתמשות בסוג מודל התנועה BEST_GUESS.

כדי לציין סוג תנועה

1. מגדירים את נקודת המוצא והיעד.

2. אם שעת היציאה היא בעתיד, צריך לכלול את השעה באמצעות הפרמטר departure_time. אם לא תציינו שעת יציאה, ברירת המחדל תהיה עכשיו.

3. בוחרים את מודל התנועה שבו רוצים להשתמש עם הפרמטר trafficModel ואחד מהסוגים הבאים:

   • BEST_GUESS (ברירת המחדל) כדי לבקש שה-duration_in_traffic שמוחזר הוא האומדן הטוב ביותר של זמן הנסיעה, בהינתן מה שידוע גם לגבי תנאי תנועה היסטוריים וגם לגבי מצב התנועה בזמן אמת. התנועה בזמן אמת הופכת לחשובה יותר ככל שdeparture_time קרוב יותר להיום. אם משתמשים בסוג ברירת המחדל של BEST_GUESS, מקבלים את החיזויים השימושיים ביותר לרוב הגדול של תרחישי השימוש.

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

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

   לדוגמה:

   "trafficModel": "OPTIMISTIC"

4. מציינים את השדה 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"