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

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

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

في الردّ:

• يتضمّن ملف الردّ duration وقت الوصول المقدَّر الذي يراعي حركة المرور في الوقت الفعلي.

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

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

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

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

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

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