डिफ़ॉल्ट रूप से, 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: बेहतर विकल्प के हिसाब से शुल्क लिया जाएगा.
रूट एपीआई के लिए बिलिंग के बारे में ज़्यादा जानें.
ईको-फ़्रेंडली रास्ते के लिए अनुरोध करना
ईको-फ़्रेंडली रास्ते का पता लगाने का अनुरोध करने के लिए, अनुरोध में ये प्रॉपर्टी सेट करें:
VehicleEmissionType
DIESEL
,GASOLINE
,ELECTRIC
याHYBRID
का इस्तेमाल करके, वाहन के लिएemissionType
तय करें. डिफ़ॉल्ट वैल्यू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
DIESEL
,GASOLINE
,ELECTRIC
याHYBRID
का इस्तेमाल करके, वाहन के लिएemissionType
तय करें. डिफ़ॉल्ट वैल्यू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)
- नीदरलैंड्स (नीदरलैंड्स)
- उत्तरी मैसेडोनिया (MK)
- नॉर्वे (NO)
- पोलैंड (PL)
- पुर्तगाल (PT)
- रोमानिया (RO)
- सर्बिया (RS)
- स्लोवाकिया (SK)
- स्लोवेनिया (SI)
- स्पेन (ES)
- स्वीडन (SE)
- स्विट्ज़रलैंड (CH)
- तुर्किये (TR)
- यूनाइटेड किंगडम (GB)
- संयुक्त राज्य अमेरिका (US)