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

‫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"
}