הגדרת הפשרה של איכות לעומת זמן אחזור

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

מידע על מצב התנועה

מצב התנועה מאפיין את קצב זרימת התנועה. לדוגמה:

• כשאין עומס, מצב התנועה נחשב רגיל והתנועה זורמת במהירות הרגילה ללא הפרעה.

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

• בפקק תנועה, קצב הזרימה נעצר ונוצר עומס תנועה כבד.

לא מודעים לתנועה

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

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

מודעות לתנועה

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

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

אופטימלי בהתאם לתנועה

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

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

דוגמה

קוד ה-JSON הבא מדגים איך להגדיר את העדפת הניתוב בגוף הישות של הודעת הבקשה.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":37.417670,
        "longitude":-122.079595
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}