ईको-फ़्रेंडली रास्ता देखें

डिफ़ॉल्ट रूप से, Routes API डिफ़ॉल्ट रास्ता दिखाता है. इसका मतलब है कि ईंधन या ऊर्जा की खपत का ध्यान रखे बिना दिखाया गया रास्ता. ईको-फ़्रेंडली रूटिंग की सुविधा चालू करने पर भी, आपको जवाब में डिफ़ॉल्ट रास्ता दिखता है. इसके अलावा, आपको ईको-फ़्रेंडली रास्ता भी दिखेगा. यह रास्ता, आपकी गाड़ी के इंजन टाइप के आधार पर, ईंधन या ऊर्जा की सबसे कम खपत वाला रास्ता होता है.

Routes API से मिलने वाला ईको-फ़्रेंडली रास्ता, पूरे रास्ते पर कम ईंधन खर्च करने के लिए ऑप्टिमाइज़ किया जाता है. यह एपीआई, ईको-फ़्रेंडली रास्ता चुनने के लिए, आपके वाहन के इंजन टाइप के साथ-साथ रीयल-टाइम ट्रैफ़िक और सड़क की स्थिति जैसी अन्य बातों का इस्तेमाल करता है. जिस रास्ते पर ईंधन या ऊर्जा की जितनी कम खपत होगी, आपकी कार को उतना ही कम ईंधन या ऊर्जा की ज़रूरत होगी. इससे CO2 का उत्सर्जन भी कम होगा.

उदाहरण के लिए, डीज़ल वाहनों में, शहर की सड़कों की तुलना में हाइवे पर ईंधन की खपत कम होती है. हाइब्रिड और इलेक्ट्रिक वाहन आम तौर पर, रुक-रुककर चलने वाले ट्रैफ़िक और पहाड़ी रास्तों पर ऊर्जा का इस्तेमाल ज़्यादा बेहतर तरीके से करते हैं. ट्रैफ़िक और पहाड़ी रास्तों पर ब्रेक का इस्तेमाल ज़्यादा होता है, जिससे गाड़ी चार्ज होती रहती है.

आपके पास यह अनुरोध करने का भी विकल्प है कि एपीआई, पूरे रास्ते के लिए ईंधन की अनुमानित खपत दिखाए. ईंधन की खपत के अनुमान का इस्तेमाल, अलग-अलग रास्तों की तुलना करने के लिए करें. इसे अपने वाहन के लिए, ईंधन की खपत के सटीक अनुमान के तौर पर इस्तेमाल न करें.

Google Maps, ईंधन की खपत का अनुमान कैसे लगाता है

Routes API, अमेरिका के ऊर्जा विभाग की नैशनल रिन्यूएबल एनर्जी लैबोरेट्री से मिली जानकारी और यूरोपियन एनवायरमेंट एजेंसी के डेटा का इस्तेमाल करके, ईंधन की खपत का अनुमान लगाता है. इस अनुमान में उन बातों का ध्यान रखा जाता है जिनसे आपके वाहन के ईंधन और ऊर्जा की खपत के साथ ही, CO2 उत्सर्जन पर असर पड़ सकता है, जैसे:

  • इलाके के वाहनों की ईंधन या ऊर्जा की औसत खपत कितनी है
  • रास्ते का ढलान कैसा है
  • ट्रैफ़िक की स्थिति
  • सड़क किस तरह की है, जैसे कि सर्विस रोड या हाइवे

Routes API, ईंधन या ऊर्जा की सबसे कम खपत वाला रास्ता तब दिखाता है, जब डिफ़ॉल्ट रास्ते और उस रास्ते से पहुंचने में लगने वाला समय एक जैसा हो. अगर ईंधन या ऊर्जा की बचत बहुत कम हो रही है या ड्राइविंग का समय बहुत बढ़ रहा है, तो एपीआई अलग-अलग रास्तों पर होने वाली बचत की जानकारी दिखाएगा. इससे आपको रास्ता चुनने में आसानी होगी.

ईको-फ़्रेंडली रास्ते के विकल्प की टेक्नोलॉजी के बारे में ज़्यादा पढ़ें (PDF).

ज़रूरी शर्तें

ईको-फ़्रेंडली रास्ते का विकल्प इस्तेमाल करने या ईंधन की खपत का अनुमान लगाने के लिए:

  • आपको रूटिंग की प्राथमिकता के तौर पर TRAFFIC_AWARE_OPTIMAL की वैल्यू देनी होगी. इस मोड में, सर्वर सड़क के नेटवर्क की ज़्यादा बारीकी से खोज करता है, ताकि सबसे सही रास्ता ढूंढा जा सके. ज़्यादा जानकारी के लिए, क्वालिटी बनाम इंतज़ार का समय कॉन्फ़िगर करना देखें.

  • आपको travelMode को DRIVE पर सेट करना होगा. यात्रा के किसी अन्य मोड के लिए अनुरोध करने पर, गड़बड़ी का मैसेज मिलता है.

  • आपको जहां यह सुविधा उपलब्ध है वहां, ऑरिजिन व्यूपॉइंट के लिए कोई जगह सेट करनी होगी. ऐसा न होने पर, एपीआई गड़बड़ी का मैसेज दिखाता है.

  • रूट में कोई इंटरमीडिएट वेपॉइंट नहीं हो सकता.

बिलिंग

आम तौर पर, Google Maps Platform, झलक देखने की सुविधा के इस्तेमाल के लिए शुल्क नहीं लेता. हालांकि, ईको-फ़्रेंडली रास्ते का विकल्प और ईंधन की खपत का अनुमान लगाने के लिए, आपको रास्ते के विकल्प के तौर पर TRAFFIC_AWARE_OPTIMAL की जानकारी देनी होगी. इसलिए, आपसे SKU: Routes Advanced के हिसाब से शुल्क लिया जाएगा.

Routes API के लिए, बिलिंग के बारे में ज़्यादा जानें.

ईको-फ़्रेंडली रास्ते का अनुरोध करना

ईको-फ़्रेंडली रास्ते का हिसाब लगाने का अनुरोध करने के लिए, अनुरोध में ये प्रॉपर्टी सेट करें:

  • वाहन के लिए emissionType की वैल्यू डालें. इसके लिए, VehicleEmissionType में दी गई वैल्यू का इस्तेमाल करें: DIESEL, GASOLINE, ELECTRIC या HYBRID. डिफ़ॉल्ट वैल्यू GASOLINE है.

  • requestedReferenceRoutes को FUEL_EFFICIENT पर सेट करें.

  • रिस्पॉन्स फ़ील्ड मास्क सेट करें, जो पर्यावरण के लिहाज़ से सही रूट से जुड़ी रिस्पॉन्स प्रॉपर्टी दिखाता हो:

    • routes.routeLabels: हर रूट की पहचान DEFAULT_ROUTE, FUEL_EFFICIENT या DEFAULT_ROUTE_ALTERNATE के तौर पर करता है.

    • routes.routeToken: एक रास्ता टोकन, जिसे पसंद के मुताबिक रास्ता पाने के लिए, नेविगेशन एसडीके टूल को पास किया जा सकता है.

ईको-फ़्रेंडली अनुरोध का उदाहरण

यहां दिया गया कोड, ईको-फ़्रेंडली रास्ते का अनुरोध दिखाता है. इस उदाहरण में, रिस्पॉन्स फ़ील्ड मास्क का इस्तेमाल करके, routes.distanceMeters और routes.duration प्रॉपर्टी के साथ-साथ, पर्यावरण के लिहाज़ से सही रास्ते से जुड़ी रिस्पॉन्स प्रॉपर्टी दिखाने के लिए किया गया है:

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "routeModifiers": {
    "vehicleInfo": {
      "emissionType": "GASOLINE"
    }
  },
  "travelMode":"DRIVE",
  "routingPreference": "TRAFFIC_AWARE_OPTIMAL",
  "requestedReferenceRoutes": ["FUEL_EFFICIENT"]
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

ईको-फ़्रेंडली जवाब का उदाहरण

ऊपर दिया गया computeRoutes कॉल, एक JSON रिस्पॉन्स जनरेट करता है. इसमें दो रास्ते होते हैं: डिफ़ॉल्ट रास्ता और ईंधन की कम खपत वाला रास्ता. जवाब में:

  • डिफ़ॉल्ट रूट के लिए, routeLabels कलेक्शन प्रॉपर्टी में DEFAULT_ROUTE शामिल होता है.

  • ईको-फ़्रेंडली रास्ते के लिए, routeLabels कलेक्शन प्रॉपर्टी में FUEL_EFFICIENT शामिल होता है.

  • अगर वैकल्पिक रास्तों का हिसाब लगाने के लिए, अनुरोध में computeAlternativeRoutes को true पर सेट किया जाता है, तो routeLabels कलेक्शन प्रॉपर्टी में DEFAULT_ROUTE_ALTERNATE शामिल होता है.

{
    "routes": [
        {
            "distanceMeters": 138939,
            "duration": "5412s",
            "routeToken": "CoYJCpoIC…0n9S1cu",
            "routeLabels": [
                "DEFAULT_ROUTE"
            ]
        },
        {
            "distanceMeters": 116887,
            "duration": "5631s",
            "routeToken": "CuEHCu0G…xqm",
            "routeLabels": [
                "FUEL_EFFICIENT"
            ]
        }
    ]
}

ड्राइविंग की मौजूदा स्थितियों और अन्य वजहों से, डिफ़ॉल्ट रास्ता और ईको-फ़्रेंडली रास्ता एक ही हो सकता है. इस मामले में, routeLabels में दोनों लेबल शामिल हैं: DEFAULT_ROUTE और FUEL_EFFICIENT:

{
  "routes": [
    {
      "distanceMeters": 45875,
      "duration": "2655s",
      "routeToken": "CvcDCos…6I40",
      "routeLabels": [
        "DEFAULT_ROUTE",
        "FUEL_EFFICIENT"
      ]
    }
  ]
}

रास्ते के लिए ईंधन की खपत का अनुमान लगाना

पूरे रास्ते के लिए, माइक्रोलीटर में ईंधन के अनुमानित खर्च को दिखाने का अनुरोध किया जा सकता है. किसी रास्ते के लिए ईंधन के अनुमानित खर्च को रिस्पॉन्स में जोड़ने के लिए:

  • ईंधन के इस्तेमाल का हिसाब लगाने की सुविधा चालू करने के लिए, extraComputations कलेक्शन फ़ील्ड को FUEL_CONSUMPTION पर सेट करें.

  • वाहन के लिए emissionType की वैल्यू डालें. इसके लिए, VehicleEmissionType में दी गई वैल्यू का इस्तेमाल करें: DIESEL, GASOLINE, ELECTRIC या HYBRID. डिफ़ॉल्ट वैल्यू GASOLINE है.

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

    अगर emissionType ELECTRIC है, तो एपीआई बिजली की खपत को माइक्रोलीटर में बदल देता है.

  • रिस्पॉन्स फ़ील्ड मास्क सेट करें, जो ईंधन के इस्तेमाल से जुड़ी रिस्पॉन्स प्रॉपर्टी दिखाता है: routes.travelAdvisory.fuelConsumptionMicroliters.

नीचे दिए गए उदाहरण में, ईको-फ़्रेंडली रास्ते के साथ-साथ अनुरोध के हिस्से के तौर पर, ईंधन के अनुमानित खर्च का अनुरोध किया गया है:

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "routeModifiers": {
    "vehicleInfo": {
      "emissionType": "GASOLINE"
    }
  },
  "travelMode":"DRIVE",
  "routingPreference": "TRAFFIC_AWARE_OPTIMAL",
  "extraComputations": ["FUEL_CONSUMPTION"],
  "requestedReferenceRoutes": ["FUEL_EFFICIENT"]
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken,routes.travelAdvisory.fuelConsumptionMicroliters' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

जवाब में, डिफ़ॉल्ट रास्ते और ईको-फ़्रेंडली रास्ते, दोनों के लिए ईंधन की अनुमानित खपत शामिल होती है:

{
    "routes": [
        {
            "distanceMeters": 138939,
            "duration": "5412s",
            "travelAdvisory": {
                "fuelConsumptionMicroliters": "11019554"
            },
            "routeToken": "CoYJCpoIC…0n9S1cu",
            "routeLabels": [
                "DEFAULT_ROUTE"
            ]
        },
        {
            "distanceMeters": 116887,
            "duration": "5631s",
            "travelAdvisory": {
                "fuelConsumptionMicroliters": "9572436"
            },
            "routeToken": "CuEHCu0G…xqm",
            "routeLabels": [
                "FUEL_EFFICIENT"
            ]
        }
    ]
}

इन देशों और इलाकों में मान्य है

Google Maps Platform की टीम, अपनी एपीआई सेवाओं के लिए अंतरराष्ट्रीय कवरेज को बेहतर बनाने के लिए लगातार काम कर रही है. यहां दी गई सूची में, ईको-फ़्रेंडली रास्ते के लिए, हर देश के हिसाब से कवरेज की नई जानकारी दी गई है:

  • अल्बानिया (AL)
  • ऑस्ट्रिया (AT)
  • बेल्जियम (BE)
  • बोस्निया और हर्ज़ेगोविना (BA)
  • बुल्गारिया (BG)
  • कनाडा (CA)
  • क्रोएशिया (HR)
  • साइप्रस (CY)
  • चेकिया (CZ)
  • डेनमार्क (DK)
  • एस्टोनिया (EE)
  • फ़िनलैंड (FI)
  • फ़्रांस (FR)
  • जर्मनी (DE)
  • ग्रीस (GR)
  • हंगरी (HU)
  • आइसलैंड (IS)
  • आयरलैंड (IE)
  • इटली (IT)
  • कोसोवो (XK)
  • लातविया (LV)
  • लिख्तेंस्ताइन (LI)
  • लिथुआनिया (LT)
  • लक्ज़मबर्ग (LU)
  • माल्टा (MT)
  • मॉन्टेनेग्रो (ME)
  • नीदरलैंड्स (NL)
  • उत्तरी मैसेडोनिया (MK)
  • नॉर्वे (NO)
  • पोलैंड (PL)
  • पुर्तगाल (PT)
  • रोमानिया (RO)
  • सर्बिया (RS)
  • स्लोवाकिया (SK)
  • स्लोवेनिया (SI)
  • स्पेन (ES)
  • स्वीडन (SE)
  • स्विट्ज़रलैंड (CH)
  • तुर्किये (TR)
  • यूनाइटेड किंगडम (GB)
  • संयुक्त राज्य अमेरिका (US)