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

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

في الردّ:

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

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

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

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

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