किसी रास्ते के लिए टोल शुल्क का हिसाब लगाना

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

रास्ता या रास्ते की मैट्रिक्स का हिसाब लगाते समय, आपको रास्ते पर लगने वाले टोल टैक्स पर ध्यान देना पड़ सकता है. चुनिंदा शहरों के लिए, सही मुद्रा में किसी रास्ते के लिए अनुमानित टोल की जानकारी देखी जा सकती है.

रास्ते की मैट्रिक्स के लिए टोल की जानकारी पाने के लिए, रास्ते की मैट्रिक्स के लिए टोल की फ़ीस का हिसाब लगाना लेख पढ़ें.

जिन जगहों पर टोल लिया जाता है वहां इस सुविधा का इस्तेमाल किया जा सकता है. इनकी सूची देखने के लिए, 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
            }
          ]
        }
      }
    }
  ]
}