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

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