ضبط مستوى بيانات حركة المرور

توازن إعدادات حركة المرور التي تختارها بين دقة تفاصيل المسار وأداء الطلب بإحدى الطريقتَين التاليتَين:

• مراعاة حركة المرور: لعرض النتائج الأكثر دقة (وقت استجابة أطول)

• غير مدرِك لحركة المرور: لعرض النتائج بأسرع ما يمكن (أقل وقت استجابة)

عند تقديم طلب، عليك تحديد ما إذا كان من الأفضل عرض النتائج الأكثر دقة أو عرض النتائج بأسرع ما يمكن. توفّر واجهة Routes API خيارات تتيح لك التحكّم في جودة بيانات الردّ مقارنةً بوقت استجابة الردّ.

كيفية ضبط مستوى حركة المرور

توفّر واجهة Routes API السمتَين RoutingPreference (REST) و RoutingPreference (gRPC) اللتين تتيحان لك تحديد الإعدادات المفضّلة للتوجيه من أجل احتساب المسارات.

الإعداد التلقائي هو عرض نتائج لا تأخذ حركة المرور في الاعتبار. يمكنك اختيار خيارات حركة المرور باستخدام إعدادات التوجيه المفضّلة TRAFFIC_UNAWARE وTRAFFIC_AWARE وTRAFFIC_AWARE_OPTIMAL. تؤدي كل إعدادات مفضّلة للتوجيه إلى نتائج مختلفة من حيث جودة المسار والوقت المقدّر للوصول ووقت استجابة الطلب.

أحوال حركة المرور

تصف أحوال حركة المرور معدّل تدفّق حركة المرور على النحو التالي:

• حركة مرور عادية: لا يوجد ازدحام وتتحرك المركبات بالسرعة العادية.

• حركة مرور خفيفة إلى معتدلة: ازدياد الازدحام، مع تدفّق حركة المرور بسرعة منخفضة

• حركة مرور مزدحمة: ازدحام شديد مع انخفاض كبير في سرعة حركة المرور

غير مدرِك لحركة المرور

TRAFFIC_UNAWARE هو الإعداد التلقائي. استخدِم خيار التوجيه هذا عندما تريد الحصول على الردود بأسرع ما يمكن، وتكون تفاصيل التوجيه التقريبية كافية.

يتم احتساب مسارات TRAFFIC_UNAWARE بدون أخذ حالة حركة المرور الحالية في الاعتبار. يؤدي خيار التوجيه المفضّل هذا إلى الحصول على أسرع استجابة للطلبات (أقل وقت استجابة).

في حال اختيار TRAFFIC_UNAWARE، يستند المسار والمدة المحدّدة إلى شبكة الطرق ومتوسط حالة حركة المرور غير المرتبطة بالوقت، وليس إلى حالة الطرق الحالية. نتيجةً لذلك، قد تتضمّن المسارات طرقًا مغلقة مؤقتًا. قد تختلف نتائج طلب معيّن بمرور الوقت بسبب التغييرات في شبكة الطرق، وتعديل متوسط أحوال حركة المرور، وطبيعة الخدمة الموزّعة. قد تختلف النتائج أيضًا بين المسارات المتشابهة في أي وقت أو معدّل تكرار.

في ما يلي الردود التي ستظهر لك:

• ‫duration: يحتوي على الوقت المقدَّر للوصول إلى الوجهة.

• ‫staticDuration: الوقت المقدّر للوصول إلى الوجهة على طول المسار مع الأخذ في الاعتبار معلومات حركة المرور السابقة فقط بالنسبة إلى TRAFFIC_UNAWARE، يحتوي هذا الحقل على القيمة نفسها التي يحتوي عليها duration.

ميزة "معرفة أحوال الطرق"

استخدِم خيار التوجيه هذا عندما تريد الحصول على تفاصيل توجيه أكثر دقة من TRAFFIC_UNAWARE، ولكن لا يهمّك إذا تم عرض الردود مع زيادة معتدلة في وقت الاستجابة.

عند ضبط خيار التوجيه TRAFFIC_AWARE، تحتسب الخدمة المسار مع الأخذ في الاعتبار أحوال حركة المرور الحالية. نتيجةً لذلك، يعكس المسار وتفاصيله الظروف الفعلية بشكل أكثر دقة. وبما أنّ هذه الزيادة في جودة البيانات تؤدي إلى زيادة وقت الاستجابة، يتم تطبيق تحسينات على الأداء لتقليل وقت الاستجابة إلى حد كبير.

في ما يلي الردود التي ستظهر لك:

• ‫duration: الوقت المقدَّر للوصول مع الأخذ في الاعتبار معلومات حركة المرور في الوقت الفعلي

• staticDuration الوقت المقدّر للوصول إلى الوجهة على طول المسار مع الأخذ في الاعتبار معلومات حركة المرور السابقة فقط

الأمثل مع مراعاة حركة المرور

استخدِم خيار التوجيه هذا عندما تريد الحصول على نتائج بأعلى جودة بغض النظر عن المدة التي تستغرقها الردود. يؤدي خيار التوجيه هذا إلى أطول تأخير في عرض الردود (أعلى وقت استجابة).

عند ضبط TRAFFIC_AWARE_OPTIMAL خيار التوجيه المفضّل، تحسب الخدمة المسار مع الأخذ في الاعتبار أحوال حركة المرور الحالية، ولكنّها لا تطبّق تحسينات الأداء. في هذا الوضع، يجري الخادم بحثًا أكثر شمولاً في شبكة الطرق للعثور على المسار الأمثل.

إنّ TRAFFIC_AWARE_OPTIMAL خيار التوجيه يعادل الوضع المستخدَم في maps.google.com وفي تطبيق "خرائط Google" للأجهزة الجوّالة.

عند استخدام هذا الخيار مع Compute Route Matrix، يجب ألا يتجاوز عدد العناصر في الطلب (عدد نقاط البداية × عدد نقاط الوجهة)

1. لمزيد من المعلومات حول حدود Compute Route Matrix، يُرجى الاطّلاع على حساب مصفوفة طرق.

في ما يلي الردود التي ستظهر لك:

• ‫duration: الوقت المقدَّر للوصول إلى الوجهة على طول المسار مع الأخذ في الاعتبار معلومات حركة المرور في الوقت الفعلي

• ‫staticDuration: الوقت المقدّر للوصول إلى الوجهة على طول المسار مع الأخذ في الاعتبار معلومات حركة المرور السابقة فقط

تحديد وقت المغادرة (اختياري)

استخدِم هذه السمة فقط للطلبات التي تراعي حركة المرور والتي يجب أن يكون وقت المغادرة فيها في المستقبل. إذا لم تضبط السمة departureTime، سيتم ضبط القيمة التلقائية على الوقت الذي تقدّم فيه الطلب.

استخدِم السمة departureTime مع الخيارَين TRAFFIC_AWARE وTRAFFIC_AWARE_OPTIMAL عندما تريد تعديل طريقة توقّع الخدمة لحركة المرور عند اختيار مسار.

• TRAFFIC_UNAWARE: لا يُنصح به لأنّ اختيار المسار والمدة يستند إلى شبكة الطرق ومتوسط حالة حركة المرور غير المرتبطة بالوقت.

• TRAFFIC_AWARE وTRAFFIC_AWARE_OPTIMAL: يُنصح باستخدام هذين الخيارَين للمغادرات التي ستحدث في المستقبل القريب لأنّهما يأخذان في الاعتبار حالة حركة المرور الحالية. تزداد أهمية بيانات الزيارات المباشرة ومدى صلتها بالواقع كلما اقترب وقت departureTime من الوقت الحالي. كلما حدّدت وقت المغادرة في وقت لاحق في المستقبل، زادت أهمية أحوال حركة المرور السابقة في اختيار الطرق.

مثال: كيفية اختيار التوجيه المراعي لحركة المرور

يوضّح رمز JSON التالي كيفية ضبط TRAFFIC_AWARE_OPTIMAL إعدادات التوجيه المفضّلة في نص كيان رسالة الطلب.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude";:37.417670,
        "longitude":-122.079595
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}

ضبط حركة المرور على الخطوط المتعددة

تتيح لك واجهة Routes API طلب معلومات حول أحوال حركة المرور على طول خط متعدد الأضلاع يتضمّن معلومات عن حركة المرور. راجِع طلب خطوط متعدّدة الأضلاع للحصول على مزيد من المعلومات.