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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

बिलिंग

आम तौर पर, Google Maps Platform, झलक के तौर पर उपलब्ध सुविधा का इस्तेमाल करने के लिए कोई शुल्क नहीं लेता. हालांकि, ईको-फ़्रेंडली रास्ते का विकल्प इस्तेमाल करने और ईंधन की खपत का अनुमान लगाने के लिए, आपको रास्ते की प्राथमिकता के तौर पर TRAFFIC_AWARE_OPTIMAL को सेट करना होगा. इसके लिए, आपसे एसकेयू: 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 शामिल होता है.

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

• 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)