احتساب رسوم العبور

المطوّرون في المنطقة الاقتصادية الأوروبية

عند احتساب مسار أو مصفوفة مسارات، قد تحتاج إلى أخذ رسوم العبور في المسار في الاعتبار. في مدن محددة، يمكنك احتساب رسوم المرور المقدّرة لمسار معيّن بالعملة المناسبة.

للاطّلاع على قائمة بالمواقع الجغرافية التي تتوفر فيها خدمة دفع رسوم المرور، راجِع مرجع TollPass.

كيفية احتساب رسوم المرور

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

للحصول على تقديرات دقيقة للرسوم، احرص على تضمين المعلومات التالية في طلبك:

  • نوع الانبعاثات للمركبة المستخدَمة في المسار (VehicleEmissionType). في حال عدم توفير نوع الانبعاثات، يتم عرض رسوم المرور للمركبة التي تعمل بالبنزين.
  • جميع بطاقات المرور على الطرق السريعة التي يملكها السائق والمركبة باستخدام tollPasses تستخدم واجهة برمجة التطبيقات بطاقات المرور على الطرق السريعة لتحديد رسوم المرور بدقة، وتعرض الأسعار النقدية عندما لا تكون بطاقات المرور في الطلب محلية بالنسبة إلى المسار.
  • تحديد خيار "تجنُّب رسوم العبور"، إذا لزم الأمر إذا كنت تريد تجنُّب الطرق التي تتضمّن رسوم عبور حيثما أمكن ذلك، أضِف avoidTolls كـ RouteModifier.

احتساب رسوم العبور باستخدام بطاقة عبور

لاحتساب رسوم المرور باستخدام بطاقة دفع رسوم المرور، عليك تحديد أي بطاقات دفع رسوم مرور كجزء من الطلب. بعد ذلك، تعرض واجهة برمجة التطبيقات أسعار التذاكر.

  • في حال تحديد بطاقة مرور غير صالحة، سيتم تجاهل البطاقة.
  • إذا حدّدت بطاقات مرور متعدّدة كصفيف، ستحاول واجهة برمجة التطبيقات حساب سعر المسار لكل بطاقة.

قد يختلف سلوك بطاقات المرور على الطرق السريعة حسب المنطقة.

  • قد تكون الأسعار أقل عند استخدام بطاقة عبور: في بعض المناطق، يدفع السائق أو صاحب المركبة الذين لديهم بطاقة عبور رسوم عبور مختلفة عن الرسوم التي يدفعها الآخرون. على سبيل المثال، إذا كان لديك Good To Go! إذا كان لديك بطاقة مرور على الطرق التي تفرض رسومًا في سياتل، واشنطن، الولايات المتحدة، ستدفع رسومًا أقل من الرسوم التي ستدفعها إذا لم يكن لديك بطاقة.
  • قد تتطلّب بعض الطرق بطاقة دفع رسوم المرور: في بعض المناطق، مثل إندونيسيا، تتوفّر طرق تتطلّب بطاقة دفع رسوم المرور. إذا لم تحدّد بطاقة مرور على الطرق السريعة لمسار يتطلّب ذلك، لن تعرض واجهة برمجة التطبيقات سعر المرور على الطرق السريعة.

حساب رسوم الطريق على مسار

لاحتساب رسوم المرور على طريق معيّن، اتّبِع الخطوات التالية:

  • اضبط السمة extraComputations على TOLLS.
  • حدِّد نوع المركبة ونوع بطاقة المرور عبر الطرق السريعة باستخدام السمة routeModifiers.
  • لاحتساب رسوم المرور على طريق بأكمله، أرسِل طلبًا يتضمّن travelAdvisory في السمة fields الخاصة بالطلب، واطّلِع على معلومات رسوم المرور على الطريق بأكمله من خلال قراءة route.travelAdvisory.tollInfo.
  • لحساب رسوم المرور على كل جزء من المسار، أرسِل طلبًا يتضمّن legs في السمة fields، واطّلِع على معلومات رسوم المرور لكل جزء من خلال قراءة route.legs[i].travelAdvisory.tollInfo.

مثال

يوضّح طلب المثال التالي كيفية طلب رسوم المرور على طريق معيّن:

const requestWithTolls = {
  origin: 'Kirkland, WA',
  destination: 'University of Washington',
  travelMode: 'DRIVING',
  extraComputations: ['TOLLS'],
  routeModifiers: {
    vehicleInfo: {
      emissionType: 'GASOLINE',
    },
    tollPasses: ['US_WA_GOOD_TO_GO'],
  },
  fields: ['path', 'legs', 'distanceMeters', 'durationMillis', 'travelAdvisory'],
};