ईको-फ़्रेंडली रास्ते कॉन्फ़िगर करना

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

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

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

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

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

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

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

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

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

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

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

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

  • आपको travelMode को DRIVE पर सेट करना होगा. किसी दूसरे यात्रा मोड के अनुरोधों में गड़बड़ी दिखती है.

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

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

बिलिंग

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

रूटिंग एपीआई के लिए बिलिंग के बारे में ज़्यादा जानें.

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

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

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

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

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

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

    • routes.routeToken: रूट का एक टोकन, जिसे कस्टम नेविगेशन फिर से पाने के लिए, नेविगेशन 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: API_KEY' \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

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

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

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

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

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

{
    "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: 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)