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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

बिलिंग

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

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

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

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

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

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

ऊपर दिया गया 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: 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)