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

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

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

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

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

لحساب معلومات رسوم العبور بدقة، تمنحك واجهة برمجة تطبيقات "المسارات" خيار تحديد:

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

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

في بعض المناطق، تختلف قيمة الرسوم التي يتم تحصيلها من قِبل السائق أو المركبة التي تحتوي على بطاقة عبور عن التكلفة التي تدفعها في تلك المناطق. على سبيل المثال، إذا كانت لديك رسوم مرور Good 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
            }
          ]
        }
      }
    }
  ]
}

حساب رسوم العبور لمصفوفة مسار

يستخدم المثال التالي طريقة computeRouteMatrix لإرجاع معلومات الرسوم على مسار مع سعر مقدّر عند استخدام بطاقة عبور:

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

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

  • استخدِم قناع حقل الاستجابة لضبط طريقة عرض معلومات رسوم العبور في الاستجابة. حدِّد routes.travelAdvisory.tollInfo لعرض معلومات المسار بالكامل.

طلب الحصول على معلومات حول رسوم مصفوفة المسار

curl -X POST -d '{
"origins": [
  {
    "waypoint": {
      "location": {
        "latLng": {
          "latitude":42.340173523716736,
          "longitude":-71.05997968330408
        }
      }
    },
    "routeModifiers": {
      "vehicleInfo":{
        "emissionType": "GASOLINE"
      },
      "tollPasses": [
        "US_MA_EZPASSMA",
        "US_WA_GOOD_TO_GO"
      ]
    }
  }
],
"destinations": [
  {
    "waypoint": {
      "location": {
        "latLng": {
          "latitude":42.075698891472804,
          "longitude": -72.59806562080408
        }
      }
    }
  }
],
"travelMode": "DRIVE",
"extraComputations": ["TOLLS"]
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,travel_advisory.tollInfo,duration,distanceMeters,status' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

الاستجابة لمعلومات رسوم مصفوفة المسار

يحتوي الرد على معلومات عن رسوم في كائن TollInfo (REST) أو TollInfo (gRPC).

لضبط طريقة عرض معلومات الرسوم، يمكنك استخدام قناع حقل الاستجابة لضبط الحقل travelAdvisory.tollInfo في القناع.

[
  {
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {},
    "distanceMeters": 150338,
    "duration": "5382s",
    "travelAdvisory": {
      "tollInfo": {
        "estimatedPrice": [
          {
            "currencyCode": "USD",
            "units": "4",
            "nanos": 400000000
           }
        ]
      }
    }
  }
]

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

تتوفر معلومات الرسوم حاليًا للمواقع التالية:

رمز المنطقةالبلد/المنطقةالولاية/المدينة/الطريق برسوم مرور
الأرجنتين الأرجنتين بوینس آیرس
أستراليا أستراليا بريزبين
أستراليا أستراليا سيدني
البرازيل البرازيل على مستوى البلد
ID إندونيسيا على مستوى البلد
الهند الهند على مستوى البلد
المكسيك المكسيك مدينة مكسيكو
الولايات المتحدة الولايات المتحدة ألاباما
الولايات المتحدة الولايات المتحدة ألاسكا
الولايات المتحدة الولايات المتحدة كاليفورنيا
الولايات المتحدة الولايات المتحدة كولورادو
الولايات المتحدة الولايات المتحدة ديلاوير
الولايات المتحدة الولايات المتحدة فلوريدا
الولايات المتحدة الولايات المتحدة إلينوي
الولايات المتحدة الولايات المتحدة أيوا
الولايات المتحدة الولايات المتحدة إنديانا
الولايات المتحدة الولايات المتحدة كنساس
الولايات المتحدة الولايات المتحدة لويزيانا
الولايات المتحدة الولايات المتحدة ماين
الولايات المتحدة الولايات المتحدة ماريلاند
الولايات المتحدة الولايات المتحدة ماساتشوستس
الولايات المتحدة الولايات المتحدة ميشيغان
الولايات المتحدة الولايات المتحدة مينيسوتا
الولايات المتحدة الولايات المتحدة ميزوري
الولايات المتحدة الولايات المتحدة نيو هامبشاير
الولايات المتحدة الولايات المتحدة نيو جيرسي
الولايات المتحدة الولايات المتحدة نيويورك
الولايات المتحدة الولايات المتحدة كارولاينا الشمالية
الولايات المتحدة الولايات المتحدة أوهايو
الولايات المتحدة الولايات المتحدة بنسلفانيا
الولايات المتحدة الولايات المتحدة رود آيلاند
الولايات المتحدة الولايات المتحدة كارولاينا الجنوبية
الولايات المتحدة الولايات المتحدة تكساس
الولايات المتحدة الولايات المتحدة يوتا
الولايات المتحدة الولايات المتحدة فيرجينيا
الولايات المتحدة الولايات المتحدة واشنطن
الولايات المتحدة الولايات المتحدة فيرجينيا الغربية

سيتم تحديث هذه المعلومات كلما توفرت المزيد من بيانات الرسوم.