ضبط المفاضلة بين الجودة مقابل وقت الاستجابة

توفّر واجهة 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"
}