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

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