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