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

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