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

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

  • الوعي بالزيارات: عرض أدق النتائج الممكنة (وقت انتظار أطول)

  • عدم مراعاة عدد الزيارات: عرض النتائج في أسرع وقت ممكن (أدنى وقت معالجة)

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

كيفية ضبط مستوى عدد الزيارات

توفّر 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. لمزيد من المعلومات حول حدود مصفوفة مسار "الحوسبة"، يمكنك الاطّلاع على حساب مصفوفة مسار.

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

  • 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 طلب معلومات عن ظروف حركة المرور على طول خط متعدّد الأضلاع يراعي حركة المرور. اطّلِع على طلب خطوط متعددة للحصول على مزيد من المعلومات.