डिफ़ॉल्ट रूप से, 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 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: 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)
- ऑस्ट्रिया (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)