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

المطوّرون في المنطقة الاقتصادية الأوروبية

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

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

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

عند تقديم طلب، يجب تحديد ما إذا كان من الأفضل عرض النتائج الأكثر دقة أو عرض النتائج بأسرع ما يمكن. توفّر واجهة برمجة التطبيقات 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 Maps للأجهزة الجوّالة.

عند استخدام هذا الخيار مع Compute Route Matrix، يكون عدد العناصر في الطلب (عدد نقاط البداية × عدد نقاط الوجهة) محدودًا. لمزيد من المعلومات حول حدود 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 طلب معلومات عن أحوال حركة المرور على طول خط متعدد الأضلاع يراعي حركة المرور. راجِع طلب خطوط متعددة الأضلاع للحصول على مزيد من المعلومات.