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

توفّر واجهة برمجة التطبيقات 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"
}