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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

बिलिंग

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

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

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

पर्यावरण के अनुकूल रास्ते का हिसाब लगाने का अनुरोध करने के लिए, अनुरोध में ये प्रॉपर्टी सेट करें:

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

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

• जवाब के लिए फ़ील्ड मास्क सेट करें. इससे, पर्यावरण के अनुकूल रूट से जुड़ी रिस्पॉन्स प्रॉपर्टी को वापस लाने के बारे में पता चलता है:

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

  • routes.routeToken: यह एक रूट टोकन होता है. इसे Navigation SDK को पास किया जा सकता है, ताकि कस्टम रूट वापस पाया जा सके.

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

यहां दिए गए कोड में, ईको-फ़्रेंडली रास्ते के लिए अनुरोध दिखाया गया है. इस उदाहरण में, रिस्पॉन्स फ़ील्ड मास्क का इस्तेमाल करके, 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 शामिल है.

• अगर आपने true के अनुरोध में computeAlternativeRoutes को सेट किया है, ताकि दूसरे रास्ते का हिसाब लगाया जा सके, तो 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 पर सेट करें.

• VehicleEmissionType में दी गई वैल्यू का इस्तेमाल करके, वाहन के लिए emissionType एट्रिब्यूट की वैल्यू तय करें: 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)
• ऑस्ट्रेलिया (AU)
• ऑस्ट्रिया (AT)
• बेल्जियम (BE)
• बोस्निया और हर्ज़ेगोविना (BA)
• बुल्गारिया (BG)
• कनाडा (CA)
• क्रोएशिया (HR)
• साइप्रस (CY)
• चेकिया (CZ)
• डेनमार्क (DK)
• मिस्र (EG)
• एस्टोनिया (EE)
• फ़िनलैंड (FI)
• फ़्रांस (FR)
• जर्मनी (DE)
• ग्रीस (GR)
• हंगरी (HU)
• आइसलैंड (IS)
• भारत (IN)
• इंडोनेशिया (ID)
• आयरलैंड (IE)
• इटली (IT)
• कोसोवो (XK)
• लातविया (LV)
• लिकटेंस्टाइन (LI)
• लिथुआनिया (LT)
• लक्ज़मबर्ग (LU)
• माल्टा (MT)
• मेक्सिको (MX)
• मॉन्टेनेग्रो (ME)
• नीदरलैंड्स (NL)
• उत्तरी मैसेडोनिया (MK)
• नॉर्वे (NO)
• पोलैंड (PL)
• पुर्तगाल (PT)
• रोमानिया (RO)
• सऊदी अरब (SA)
• सर्बिया (RS)
• स्लोवाकिया (SK)
• स्लोवेनिया (SI)
• स्पेन (ES)
• स्वीडन (SE)
• स्विट्ज़रलैंड (CH)
• तुर्किये (TR)
• संयुक्त अरब अमीरात (AE)
• यूनाइटेड किंगडम (GB)
• संयुक्त राज्य अमेरिका (US)

दोपहिया वाहन की सुविधा वाले देश/इलाके

यहां दी गई सूची में, दोपहिया वाहनों के लिए पर्यावरण के अनुकूल रास्तों की सुविधा की उपलब्धता के बारे में देश के हिसाब से ताज़ा जानकारी दी गई है:

• भारत (IN)
• इंडोनेशिया (ID)