โดยค่าเริ่มต้น Routes API จะแสดงเส้นทางเริ่มต้น ซึ่งหมายถึงเส้นทางที่ไม่มีปัจจัยในการประหยัดเชื้อเพลิงหรือพลังงาน เมื่อเปิดใช้การกำหนดเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม คุณจะยังคงได้รับเส้นทางเริ่มต้นในการตอบกลับ นอกจากนี้ คุณยังจะได้รับเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมซึ่งแสดงเส้นทางที่ประหยัดเชื้อเพลิงหรือพลังงานมากที่สุดโดยอิงตามประเภทเครื่องยนต์ของรถ
เส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมที่ Routes API ส่งคืนจะได้รับการเพิ่มประสิทธิภาพเพื่อการบริโภคเชื้อเพลิงลดลงตลอดทั้งเส้นทาง API นี้ใช้ประเภทเครื่องยนต์รถของคุณร่วมกับปัจจัยอื่นๆ เช่น การจราจรแบบเรียลไทม์และสภาพท้องถนนเพื่อเลือกเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม ยิ่งเส้นทางประหยัดเชื้อเพลิงหรือพลังงานมากเท่าใด ก็จะยิ่งลดการใช้เชื้อเพลิง/พลังงานและการปล่อยก๊าซ CO2 จากรถได้มากขึ้นเท่านั้น
เช่น ข้อได้เปรียบในการประหยัดเชื้อเพลิงแบบสัมพัทธ์ของยานพาหนะดีเซลมักจะดีกว่าในการขับขี่บนทางหลวง ยานพาหนะไฮบริดและรถยนต์ไฟฟ้ามีแนวโน้มที่จะให้ประสิทธิภาพมากขึ้นในการขับรถในเมืองแบบไม่มีที่สิ้นสุดและสภาพแวดล้อมการขับขี่บนเนินเขา ซึ่งสามารถใช้ประโยชน์จากระบบเบรกแบบสร้างใหม่ (Regenerative braking) ได้อย่างเต็มที่
คุณสามารถขอให้ API แสดงผลการบริโภคน้ำมันเชื้อเพลิงโดยประมาณสำหรับทั้งเส้นทางได้ด้วย ใช้ค่าประมาณการบริโภคเชื้อเพลิงเป็นวิธีการเปรียบเทียบเส้นทางต่างๆ ไม่ใช่เป็นการคาดประมาณการใช้เชื้อเพลิงโดยประมาณของยานพาหนะจริง
วิธีที่ Google Maps ประมาณการประหยัดพลังงาน
Routes API ประมาณค่าการประหยัดพลังงานโดยใช้ข้อมูลเชิงลึกจากห้องปฏิบัติการพลังงานทดแทนแห่งชาติของกระทรวงพลังงานสหรัฐอเมริกาและข้อมูลจากสำนักงานสิ่งแวดล้อมยุโรป การคํานวณนี้ประกอบด้วยปัจจัยที่มีผลต่อการใช้เชื้อเพลิงและพลังงาน และการปล่อย CO2 เช่น
- การบริโภคเชื้อเพลิงหรือพลังงานโดยเฉลี่ยของยานพาหนะในภูมิภาคของคุณ
- ความสูงชันของเนินเขาในเส้นทางของคุณ
- รูปแบบการจราจรที่เคลื่อนที่สลับหยุดนิ่ง
- ประเภทถนน (เช่น ถนนในท้องถิ่นหรือทางหลวง)
Routes API จะแสดงเส้นทางที่ประหยัดเชื้อเพลิงหรือพลังงานมากที่สุดเมื่อมีเวลาถึงใกล้เคียงกับเส้นทางเริ่มต้น ในกรณีที่ประหยัดเชื้อเพลิงได้น้อยมากหรือต้องเพิ่มเวลาในการขับรถขึ้นอย่างมาก API จะแสดงการประหยัดเชื้อเพลิงแบบสัมพัทธ์หรือพลังงานระหว่างเส้นทางเพื่อช่วยคุณในการเปรียบเทียบ
อ่านเพิ่มเติมเกี่ยวกับเทคโนโลยีการกําหนดเส้นทางที่เป็นมิตรกับสิ่งแวดล้อม (PDF)
ข้อกำหนดเบื้องต้น
หากต้องการใช้เส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมหรือประเมินปริมาณการใช้เชื้อเพลิง ให้ทำดังนี้
คุณต้องระบุ
TRAFFIC_AWARE_OPTIMAL
เป็นค่ากำหนดการกำหนดเส้นทาง ในโหมดนี้ เซิร์ฟเวอร์จะทำการค้นหาเครือข่ายถนนอย่างละเอียดมากขึ้นเพื่อค้นหาเส้นทางที่เหมาะสม ดูข้อมูลเพิ่มเติมได้ที่กำหนดค่าคุณภาพเทียบกับเวลาในการตอบสนองคุณต้องตั้งค่า
travelMode
เป็นDRIVE
คำขอโหมดการเดินทางอื่นๆ จะแสดงผลข้อผิดพลาดคุณต้องตั้งค่าตำแหน่งสำหรับจุดอ้างอิงต้นทางในภูมิภาคที่รองรับ มิฉะนั้น API จะแสดงข้อผิดพลาด
เส้นทางนี้ต้องไม่มีจุดระหว่างทาง
การเรียกเก็บเงิน
โดยปกติแล้ว Google Maps Platform จะไม่เรียกเก็บเงินสำหรับการใช้ฟีเจอร์แสดงตัวอย่าง แต่เนื่องจากเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมและการประมาณปริมาณการใช้เชื้อเพลิงนั้น คุณต้องระบุ TRAFFIC_AWARE_OPTIMAL
เป็นค่ากำหนดการกำหนดเส้นทาง ระบบจึงจะเรียกเก็บเงินตาม SKU: Routes
Advanced
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเรียกเก็บเงินสำหรับ Routes API
ขอเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม
หากต้องการส่งคำขอคำนวณเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ในคำขอ
ระบุ
emissionType
สำหรับยานพาหนะโดยใช้ค่าที่กำหนดไว้ใน VehicleEmissionType: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 ที่มี 2 เส้นทาง ได้แก่ เส้นทางเริ่มต้นและเส้นทางประหยัดเชื้อเพลิง คำตอบ:
พร็อพเพอร์ตี้อาร์เรย์
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
จะมี
ป้ายกำกับทั้ง 2 รายการ ได้แก่ DEFAULT_ROUTE
และ FUEL_EFFICIENT
ดังนี้
{ "routes": [ { "distanceMeters": 45875, "duration": "2655s", "routeToken": "CvcDCos…6I40", "routeLabels": [ "DEFAULT_ROUTE", "FUEL_EFFICIENT" ] } ] }
ประมาณการใช้เชื้อเพลิงของเส้นทาง
คุณสามารถขอวิธีส่งคืนการใช้เชื้อเพลิงโดยประมาณสำหรับทั้งเส้นทางเป็นไมโครลิตรได้ วิธีเพิ่มการใช้เชื้อเพลิงโดยประมาณสําหรับเส้นทางในคำตอบ
ตั้งค่าช่องอาร์เรย์
extraComputations
เป็นFUEL_CONSUMPTION
เพื่อเปิดใช้การคำนวณการใช้งานเชื้อเพลิงระบุ
emissionType
สำหรับยานพาหนะโดยใช้ค่าที่กำหนดไว้ใน VehicleEmissionType:DIESEL
,GASOLINE
,ELECTRIC
หรือHYBRID
ค่าเริ่มต้นคือGASOLINE
หาก
emissionType
เป็นHYBRID
แล้ว API จะแปลงการบริโภคไฟฟ้าและเชื้อเพลิงเป็นไมโครลิตรของเชื้อเพลิงหาก
emissionType
เป็นELECTRIC
API จะแปลงการบริโภคไฟฟ้าเป็นไมโครลิตรของเชื้อเพลิงตั้งค่ามาสก์ฟิลด์คำตอบที่ระบุให้แสดงผลคุณสมบัติการตอบสนองที่เชื่อมโยงกับการใช้งานเชื้อเพลิง:
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 ทำงานอย่างต่อเนื่องเพื่อปรับปรุงความครอบคลุมของ บริการ API ของเราในระดับสากล รายการต่อไปนี้แสดงรายละเอียดการครอบคลุมล่าสุดสำหรับเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมโดยแยกตามประเทศ
- แอลเบเนีย (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)