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

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

रूट मैट्रिक्स के टोल जानने के लिए, रूट मैट्रिक्स के लिए टोल शुल्क की गणना देखें.

जिन टोल जगहों का इस्तेमाल किया जा सकता है उनकी सूची देखने के लिए, TollPass से जुड़ी जानकारी देखें.

टोल का हिसाब कैसे लगाया जाता है

रूट एपीआई अनुमानित टोल शुल्क का हिसाब लगाता है. इसमें ड्राइवर या वाहन के लिए उपलब्ध टोल कीमत पर मिलने वाली छूट या पास और सबसे सुविधाजनक पेमेंट के तरीकों को ध्यान में रखा जाता है. अगर किसी दिए गए रूट के लिए टोल कीमत उपलब्ध नहीं है, तो रूट एपीआई अज्ञात शुल्क के साथ टोल की मौजूदगी बताता है.

टोल का सटीक अनुमान पाने के लिए, पक्का करें कि आपने अनुरोध में यह जानकारी शामिल की हो:

  • रास्ते (VehicleEmissionType) के लिए इस्तेमाल किए गए वाहन का कार्बन उत्सर्जन का टाइप. अगर उत्सर्जन का टाइप नहीं दिया गया है, तो पेट्रोल पंप से चलने वाले वाहन के लिए टोल दिखाया जाएगा.
  • वाहन और ड्राइवर के सभी टोल पास (TollPass) का इस्तेमाल कर रहे हैं. टोल का सटीक शुल्क तय करने के लिए एपीआई, टोल पास का इस्तेमाल करता है. अगर अनुरोध में बताए गए टोल पास रूट के लिए स्थानीय नहीं होते हैं, तो ये कैश कीमतें दिखाते हैं.
  • अगर ज़रूरी हो, तो टोल से बचें. अगर जहां संभव हो, वहां टोल सड़कों से बचना है, तो avoidTolls को RouteModifier के तौर पर जोड़ें.

टोल पास का इस्तेमाल करके टोल का हिसाब लगाएं

टोल पास का इस्तेमाल करके टोल का हिसाब लगाने के लिए, आपको अनुरोध के साथ किसी भी टोल पास की जानकारी देनी होती है. इसके बाद, एपीआई पास की कीमतें दिखाता है.

  • अमान्य टोल पास की जानकारी देने पर, पास को नज़रअंदाज़ कर दिया जाता है.

  • अगर कई टोल पास की जानकारी एक कैटगरी में दी जाती है, तो एपीआई हर पास के लिए, रूट के लिए कीमत का हिसाब लगाने की कोशिश करता है.

टोल पास के काम करने का तरीका इलाके के मुताबिक अलग-अलग हो सकता है.

  • टोल पास होने पर, किराये कम हो सकते हैं: कुछ इलाकों में, टोल पास वाले ड्राइवर या वाहन के लिए, पास न होने वालों से अलग टोल देना पड़ता है. उदाहरण के लिए, अगर आपके पास सिऐटल, वॉशिंगटन, अमेरिका में अच्छा! है, तो आपके पास कोई पास न होने की तुलना में कम टोल पास होगा.

  • कुछ सड़कों के लिए टोल पास की ज़रूरत हो सकती है: इंडोनेशिया जैसे कुछ इलाकों में ऐसी सड़कों के लिए टोल पास की ज़रूरत होती है. अगर आपने किसी ऐसे रूट के लिए टोल पास नहीं बताया है जहां टोल पास की ज़रूरत होती है, तो एपीआई टोल की कीमत नहीं दिखाता.

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

इस उदाहरण में, टोल पास का इस्तेमाल किए जाने पर, अनुमानित कीमत के साथ टोल की जानकारी दिखाने के लिए, 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
            }
          ]
        }
      }
    }
  ]
}