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

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