تحديد كيفية تضمين بيانات حركة المرور وما إذا كان ذلك ممكنًا

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

تعيين مستوى بيانات الزيارات

توفّر Routes API RoutingPreference (REST) و RoutingPreference (gRPC) التي تتيح لك تحديد الإعدادات المفضّلة للتوجيه لحساب المسارات. هذه في مدى تأثيرها لظروف حركة الزيارات على حساب المسار. ينتج عن كل تفضيل توجيه نتائج تختلف عن في ما يتعلق بجودة المسار والوقت المقدّر للوصول وزمن الاستجابة.

تحدد ظروف حركة المرور معدل تدفق حركة المرور. على سبيل المثال:

• عندما لا يكون هناك ازدحام، يتم اعتبار أحوال حركة المرور عادية، حركة المرور بالسرعة المنتظمة وبدون عوائق.
• مع اقتراب ساعة الذروة، تزداد كثافة حركة المرور، مما يؤدي إلى جعل حركة المرور بطيئة، مما ينتج عنه ظروف حركة مرور خفيفة إلى متوسطة.
• في حركة المرور من ملصقات صغيرة، يتوقف معدل التدفق، ما ينتج عنه وأحوال حركة المرور.

عدم معرفة الزيارات

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

TRAFFIC_UNAWARE هو الإعداد التلقائي.

في الردّ:

• ويكون الوقت المقدَّر للوصول مضمَّنًا في سمة الاستجابة duration.

• تحتوي سمتا الاستجابة duration وstaticDuration على ما يلي:

استخدِم هذا الخيار في التوجيه إذا أردت إرجاع الردود بشكل أسرع تفاصيل التوجيه التقريبية جيدة بما يكفي.

تنبيه بشأن حركة المرور

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

في الردّ:

• يتم تضمين الوقت المقدر للوصول مع أخذ حركة المرور في الوقت الفعلي في الاعتبار في سمة استجابة واحدة (duration)

• تحتوي خاصية الاستجابة staticDuration على مدة السفر. عبر الطريق دون مراعاة ظروف حركة المرور.

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

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

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

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

عند استخدام هذا الخيار مع مصفوفة مسار الحوسبة، يصبح عدد لا يمكن أن تتجاوز العناصر في الطلب (عدد المصادر × عدد الوجهات) 100. لمزيد من المعلومات حول حدود مصفوفة مسار Compute Routes، يُرجى الاطّلاع على حساب مصفوفة مسارات.

في الردّ:

• يتم تضمين الوقت المقدر للوصول مع أخذ حركة المرور في الوقت الفعلي في الاعتبار في سمة استجابة واحدة (duration)

• تحتوي خاصية الاستجابة staticDuration على مدة السفر. عبر الطريق دون مراعاة ظروف حركة المرور.

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

تأثير ضبط وقت المغادرة

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

• بالنسبة إلى TRAFFIC_UNAWARE، لا يمكنك ضبط departureTime نظرًا لأن اختيار يستند المسار والمدة إلى شبكة الطرق ومتوسط السعر المستقل وأحوال حركة المرور.

• لـ TRAFFIC_AWARE وTRAFFIC_AWARE_OPTIMAL، اللذين يأخذان حركة مرور مباشرة الوضع في الاعتبار، تصبح الزيارات المباشرة أكثر أهمية أقرب إلى departureTime من الآن. كلما ضبطت وقت المغادرة في المستقبل، يتم إيلاء اهتمام أكبر للزيارات السابقة الظروف.

مثال على الإعدادات المفضّلة للتوجيه

يوضح رمز 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"
}

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

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