احتساب رسوم العبور لمسار معيّن

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

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

للحصول على رسوم المرور لمصفوفة مسارات، يُرجى الاطّلاع على حساب رسوم المرور لمصفوفة مسارات.

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

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

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

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

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

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

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

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

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

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

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

  • قد تتطلّب بعض الطرق بطاقة مرور مدفوعة: في بعض المناطق، مثل إندونيسيا، توجد طرق تتطلّب بطاقة مرور مدفوعة. إذا لم تحدّد بطاقة مرور على الطرق السريعة لطريق يتطلّب ذلك، لن تعرض واجهة برمجة التطبيقات سعر المرور على الطرق السريعة.

حساب رسوم الطريق لإحدى الرحلات

يستخدم المثال التالي طريقة computeRoutes لعرض معلومات حول رسوم المرور مع سعر تقديري عند استخدام بطاقة دفع رسوم المرور. في هذا المثال، عليك اتّباع الخطوات التالية:

  • اضبط حقل مصفوفة extraComputations على TOLLS لتفعيل احتساب معلومات رسوم المرور.

  • حدِّد نوع المركبة ونوع بطاقة المرور الخاصة برسوم المرور باستخدام الحقل routeModifiers في الطلب. يستند سعر رسوم العبور الذي يتم عرضه إلى الأسعار التي يستخدمها نوع المركبة وبطاقة العبور المحدّدين. في حال تحديد أكثر من تذكرة واحدة، سيتم عرض السعر الأقل.

  • استخدِم قناع حقل الردّ لضبط طريقة عرض معلومات الرسوم في الردّ. في هذا المثال، تضمّن الطلب السمات التالية في قناع حقول الردّ:

    • حقل routes.travelAdvisory.tollInfo لعرض معلومات المسار بأكمله

    • routes.legs.travelAdvisory.tollInfo لعرض معلومات عن كل جزء من الرحلة.

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

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "extraComputations": ["TOLLS"],
  "routeModifiers":{
    "vehicleInfo":{
      "emissionType": "GASOLINE"
    },
    "tollPasses": [
      "US_MA_EZPASSMA",
      "US_WA_GOOD_TO_GO"
    ]
  }
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.travelAdvisory.tollInfo,routes.legs.travelAdvisory.tollInfo' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

ردّ يتضمّن معلومات عن رسوم المرور

يحتوي الردّ على معلومات حول رسوم المرور في عنصر TollInfo (REST) أو TollInfo (gRPC). في هذا المثال، يتم عرض معلومات الرسوم على الطريق للمسار بأكمله ولكل جزء من المسار.

{
  "routes": [
    {
      "legs": [
        {
          "travelAdvisory": {
            "tollInfo": {
              "estimatedPrice": [
                {
                  "currencyCode": "USD",
                  "units": "4",
                  "nanos": 400000000
                }
              ]
            }
          }
        }
      ],
      "distanceMeters": 150338,
      "duration": "6650s",
      "travelAdvisory": {
        "tollInfo": {
          "estimatedPrice": [
            {
              "currencyCode": "USD",
              "units": "4",
              "nanos": 400000000
            }
          ]
        }
      }
    }
  ]
}