โดยค่าเริ่มต้น Routes API จะแสดงผลเส้นทางเริ่มต้น ซึ่งหมายถึงเส้นทาง โดยไม่คำนึงถึงการประหยัดเชื้อเพลิงหรือพลังงาน เมื่อคุณเปิดใช้การเป็นมิตรต่อสิ่งแวดล้อม การกำหนดเส้นทาง คุณจะยังคงได้รับเส้นทางเริ่มต้นในการตอบกลับ นอกจากนี้ คุณยัง แสดงเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมซึ่งแสดงเส้นทางที่ประหยัดพลังงานหรือประหยัดพลังงานมากที่สุด โดยอิงตามประเภทเครื่องยนต์ของรถ
เส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมจาก Routes API ได้รับการเพิ่มประสิทธิภาพเพื่อ ลดการใช้เชื้อเพลิงตลอดเส้นทาง API ใช้เครื่องมือของรถคุณ พร้อมกับปัจจัยอื่นๆ เช่น การจราจรแบบเรียลไทม์และสภาพถนนเพื่อ ให้เลือกเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม ยิ่งเส้นทางประหยัดเชื้อเพลิงหรือพลังงานมากเท่าใด ระบบ ลดการใช้เชื้อเพลิง/พลังงานของรถและการปล่อยก๊าซ CO2
ตัวอย่างเช่น โดยทั่วไปแล้วรถดีเซลจะมีข้อได้เปรียบในการประหยัดเชื้อเพลิงแบบสัมพัทธ์ ซึ่งเหมาะที่สุดกับการขับรถทางหลวง ยานพาหนะไฮบริดและรถยนต์ไฟฟ้ามักให้ มีประสิทธิภาพมากขึ้นขึ้นเรื่อยๆ ในการขับขี่ในเมืองแบบหยุดพักและเดินทางและขับรถบนเนินเขา ที่สามารถใช้ประโยชน์จากการสร้าง การเบรก
คุณยังขอให้ API แสดงปริมาณการใช้เชื้อเพลิงโดยประมาณสำหรับ ตลอดเส้นทาง ใช้ค่าประมาณของการใช้พลังงานเชื้อเพลิงเพื่อเปรียบเทียบ เส้นทางต่างๆ ไม่ใช่ค่าประมาณการใช้เชื้อเพลิงที่ชัดเจนสำหรับยานพาหนะจริงของคุณ
วิธีที่ Google Maps ประมาณการประหยัดพลังงาน
Routes API ประมาณการประหยัดพลังงานโดยใช้ข้อมูลเชิงลึกจากสหรัฐอเมริกา กระทรวงพลังงาน ห้องปฏิบัติการพลังงานหมุนเวียนแห่งชาติ และข้อมูลจากสำนักงานสิ่งแวดล้อมยุโรป การคํานวณนี้ประกอบด้วยปัจจัย ที่มีผลต่อการใช้เชื้อเพลิงและพลังงาน รวมถึงการปล่อยก๊าซ CO2 เช่น
- การบริโภคเชื้อเพลิงหรือพลังงานโดยเฉลี่ยของยานพาหนะในภูมิภาคของคุณ
- ความสูงชันของเนินเขาในเส้นทางของคุณ
- รูปแบบการจราจรที่เคลื่อนที่สลับหยุดนิ่ง
- ประเภทถนน (เช่น ถนนในท้องถิ่นหรือทางหลวง)
Routes API จะแสดงเส้นทางที่ประหยัดเชื้อเพลิงหรือพลังงานมากที่สุดเมื่อมี เวลาถึงใกล้เคียงกับเส้นทางเริ่มต้น ในกรณีที่มีเชื้อเพลิงหรือ การประหยัดพลังงานเล็กเกินไป หรือเพิ่มเวลาในการขับรถขึ้นอย่างมาก API แสดงการประหยัดเชื้อเพลิงหรือพลังงานแบบสัมพัทธ์ระหว่างเส้นทางเพื่อช่วยคุณในการเปรียบเทียบ
อ่านเพิ่มเติมเกี่ยวกับเทคโนโลยีการกําหนดเส้นทางที่เป็นมิตรกับสิ่งแวดล้อม (PDF)
ข้อกำหนดเบื้องต้น
หากต้องการใช้เส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมหรือประมาณปริมาณการใช้เชื้อเพลิง ให้ทำดังนี้
คุณต้องระบุ
TRAFFIC_AWARE_OPTIMAL
เป็นค่ากำหนดการกำหนดเส้นทาง ด้วยวิธีนี้ เซิร์ฟเวอร์จะค้นหาเครือข่ายถนนอย่างละเอียดมากขึ้น เพื่อ ค้นหาเส้นทางที่ดีที่สุด สำหรับข้อมูลเพิ่มเติม โปรดดู กำหนดค่าคุณภาพเทียบกับเวลาในการตอบสนองคุณต้องตั้งค่า
travelMode
เป็นDRIVE
คำขอสำหรับ โหมดการเดินทางอื่นๆ จะแสดงข้อผิดพลาดคุณต้องตั้งค่าตำแหน่งสำหรับจุดอ้างอิงต้นทางใน ภูมิภาคที่รองรับ มิฉะนั้น API จะแสดงข้อผิดพลาด
เส้นทางนี้ไม่สามารถมีจุดอ้างอิงกลาง
การเรียกเก็บเงิน
โดยปกติแล้ว Google Maps Platform จะไม่เรียกเก็บเงินสำหรับการใช้เวอร์ชันตัวอย่าง
อย่างไรก็ตาม เนื่องจากการกำหนดเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมและการประมาณการใช้เชื้อเพลิง
คุณต้องระบุ TRAFFIC_AWARE_OPTIMAL
เป็นค่ากำหนดการกำหนดเส้นทาง
เรียกเก็บเงินตาม SKU: เส้นทาง
ขั้นสูง
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเรียกเก็บเงินสำหรับ Routes API
ขอเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม
หากต้องการส่งคำขอเพื่อคำนวณเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ ในคำขอ:
ระบุ
emissionType
สำหรับยานพาหนะโดยใช้ค่าที่กำหนดไว้ใน VehicleEmissionType: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 ที่มี
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
ประกอบด้วย
ป้ายกำกับทั้งสอง: 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)