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

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

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

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

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