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

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