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

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

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

توفّر واجهة برمجة التطبيقات Routes API كلاً من RoutingPreference (REST) و RoutingPreference (gRPC) (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 عنصر. لمزيد من المعلومات حول حدود مصفوفة المسارات، يُرجى الاطّلاع على حساب مصفوفة مسارات.

في الردّ:

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