Theo mặc định, Routes API trả về tuyến đường mặc định, nghĩa là một tuyến đường không tính đến mức tiết kiệm nhiên liệu hoặc năng lượng. Khi bật tính năng đường đi thân thiện với môi trường, bạn vẫn nhận được tuyến đường mặc định trong phản hồi. Ngoài ra, bạn cũng sẽ nhận được một tuyến đường thân thiện với môi trường cho biết tuyến đường tiết kiệm nhiên liệu hoặc năng lượng nhất dựa trên loại động cơ của xe.
Tuyến đường thân thiện với môi trường do Routes API trả về được tối ưu hoá để giảm mức tiêu thụ nhiên liệu trên toàn bộ tuyến đường. API này sử dụng loại động cơ của xe cùng với các yếu tố khác như tình trạng giao thông và đường theo thời gian thực để chọn tuyến đường thân thiện với môi trường. Tuyến đường càng tiết kiệm nhiên liệu hoặc năng lượng, mức sử dụng nhiên liệu/năng lượng và lượng khí thải CO2 của xe càng thấp.
Ví dụ: ưu điểm tiết kiệm nhiên liệu tương đối của xe chạy bằng dầu diesel thường đạt mức lớn nhất khi bạn lái xe trên đường cao tốc. Xe lai điện và xe điện có xu hướng tiết kiệm hơn trong thành phố khi bạn không thể di chuyển với tốc độ ổn định và khi lái xe trên đồi dốc cần thường xuyên sử dụng phanh tái sinh.
Bạn cũng có thể yêu cầu API trả về mức tiêu thụ nhiên liệu ước tính cho toàn bộ tuyến đường. Hãy sử dụng số liệu ước tính mức tiêu thụ nhiên liệu để so sánh các tuyến đường, chứ không phải là số liệu ước tính mức sử dụng nhiên liệu chính xác cho xe của bạn.
Cách Google Maps ước tính hiệu suất nhiên liệu
Routes API ước tính hiệu suất nhiên liệu dựa trên thông tin chi tiết của Phòng thí nghiệm quốc gia về năng lượng tái tạo của Bộ Năng lượng Hoa Kỳ và dữ liệu của Cơ quan Môi trường Châu Âu. Cách tính này xét tới những yếu tố ảnh hưởng đến mức sử dụng nhiên liệu và năng lượng cũng như lượng khí thải CO2, chẳng hạn như:
- Mức tiêu thụ nhiên liệu hoặc năng lượng trung bình của các xe ở khu vực của bạn
- Độ dốc của đồi trên tuyến đường
- Tình hình giao thông di chuyển chậm chạp
- Các loại đường (chẳng hạn như đường nội đô hoặc đường cao tốc)
Routes API trả về tuyến đường tiết kiệm nhiên liệu hoặc năng lượng nhất khi tuyến đường đó có thời gian đến gần như cùng lúc với tuyến đường mặc định. Trong trường hợp mức tiết kiệm nhiên liệu hoặc năng lượng quá nhỏ hoặc khiến thời gian lái xe tăng lên đáng kể, API sẽ hiển thị mức tiết kiệm nhiên liệu hoặc năng lượng tương đối giữa các tuyến đường để giúp bạn so sánh.
Đọc thêm về công nghệ định tuyến theo hướng thân thiện với môi trường (PDF).
Điều kiện tiên quyết
Cách sử dụng tính năng định tuyến theo hướng thân thiện với môi trường hoặc ước tính mức tiêu thụ nhiên liệu:
Bạn phải chỉ định
TRAFFIC_AWARE_OPTIMALlàm lựa chọn ưu tiên về định tuyến. Ở chế độ này, máy chủ sẽ tìm kiếm mạng lưới đường một cách kỹ lưỡng hơn để tìm tuyến đường tối ưu. Để biết thêm thông tin, hãy xem phần Định cấu hình chất lượng so với độ trễ.Bạn phải đặt
travelModethànhDRIVE. Yêu cầu về bất kỳ phương tiện di chuyển nào khác sẽ trả về lỗi.Bạn phải đặt vị trí cho điểm trung gian gốc trong một khu vực được hỗ trợ. Nếu không, API sẽ trả về lỗi.
Tuyến đường không được chứa điểm trung gian.
Thanh toán
Thông thường, Nền tảng Google Maps không tính phí khi bạn sử dụng tính năng Xem trước. Tuy nhiên, vì tính năng định tuyến thân thiện với môi trường và tính năng ước tính mức tiêu thụ nhiên liệu yêu cầu bạn chỉ định TRAFFIC_AWARE_OPTIMAL làm tuỳ chọn định tuyến ưu tiên, nên bạn sẽ bị tính phí dựa trên SKU: Routes Advanced (Mặt hàng: Tuyến nâng cao).
Tìm hiểu thêm về thông tin thanh toán cho Routes API.
Yêu cầu tuyến đường thân thiện với môi trường
Để đưa ra yêu cầu tính toán tuyến đường thân thiện với môi trường, hãy đặt các thuộc tính sau trong yêu cầu:
Chỉ định
emissionTypecho xe bằng cách sử dụng các giá trị được xác định trong VehicleEmissionType:DIESEL,GASOLINE,ELECTRIChoặcHYBRID. Giá trị mặc định làGASOLINE.Đặt
requestedReferenceRoutesthànhFUEL_EFFICIENT.Đặt mặt nạ trường phản hồi chỉ định trả về các thuộc tính phản hồi liên kết với một tuyến đường thân thiện với môi trường:
routes.routeLabels:Xác định từng tuyến làDEFAULT_ROUTE,FUEL_EFFICIENThoặcDEFAULT_ROUTE_ALTERNATE.routes.routeToken:Mã thông báo tuyến mà bạn có thể truyền đến Navigation SDK để truy xuất tuyến tuỳ chỉnh.
Ví dụ về yêu cầu thân thiện với môi trường
Mã sau đây cho thấy một yêu cầu về tuyến đường thân thiện với môi trường. Trong ví dụ này, bạn sử dụng mặt nạ trường phản hồi để trả về các thuộc tính phản hồi liên kết với một tuyến đường thân thiện với môi trường cùng với các thuộc tính routes.distanceMeters và 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'
Ví dụ về câu trả lời thân thiện với môi trường
Lệnh gọi computeRoutes ở trên tạo ra một phản hồi JSON chứa hai tuyến đường: tuyến đường mặc định và tuyến đường tiết kiệm nhiên liệu. Trong phản hồi:
Đối với tuyến mặc định, thuộc tính mảng
routeLabelschứaDEFAULT_ROUTE.Đối với tuyến đường thân thiện với môi trường, thuộc tính mảng
routeLabelschứaFUEL_EFFICIENT.Nếu bạn đặt
computeAlternativeRoutestrong yêu cầu thànhtrueđể tính toán các tuyến đường thay thế, thì thuộc tính mảngrouteLabelssẽ chứaDEFAULT_ROUTE_ALTERNATE.
{
"routes": [
{
"distanceMeters": 138939,
"duration": "5412s",
"routeToken": "CoYJCpoIC…0n9S1cu",
"routeLabels": [
"DEFAULT_ROUTE"
]
},
{
"distanceMeters": 116887,
"duration": "5631s",
"routeToken": "CuEHCu0G…xqm",
"routeLabels": [
"FUEL_EFFICIENT"
]
}
]
}
Do điều kiện lái xe hiện tại và các yếu tố khác, tuyến đường mặc định và tuyến đường thân thiện với môi trường có thể giống nhau. Trong trường hợp này, routeLabels chứa cả hai nhãn: DEFAULT_ROUTE và FUEL_EFFICIENT:
{
"routes": [
{
"distanceMeters": 45875,
"duration": "2655s",
"routeToken": "CvcDCos…6I40",
"routeLabels": [
"DEFAULT_ROUTE",
"FUEL_EFFICIENT"
]
}
]
}
Ước tính mức sử dụng nhiên liệu cho tuyến đường
Bạn có thể yêu cầu phương thức này trả về mức tiêu thụ nhiên liệu ước tính cho toàn bộ tuyến đường, tính bằng microlit. Cách thêm mức sử dụng nhiên liệu ước tính cho một tuyến đường vào phản hồi:
Đặt trường mảng
extraComputationsthànhFUEL_CONSUMPTIONđể bật tính năng tính toán mức sử dụng nhiên liệu.Chỉ định
emissionTypecho xe bằng cách sử dụng các giá trị được xác định trong VehicleEmissionType:DIESEL,GASOLINE,ELECTRIChoặcHYBRID. Giá trị mặc định làGASOLINE.Nếu
emissionTypelàHYBRID, API sẽ chuyển đổi mức tiêu thụ điện và nhiên liệu thành microlit nhiên liệu.Nếu
emissionTypelàELECTRIC, API sẽ chuyển đổi mức tiêu thụ điện thành microlit nhiên liệu.Đặt mặt nạ trường phản hồi chỉ định trả về các thuộc tính phản hồi liên kết với mức sử dụng nhiên liệu:
routes.travelAdvisory.fuelConsumptionMicroliters.
Ví dụ sau đây yêu cầu mức sử dụng nhiên liệu ước tính trong một yêu cầu cũng bao gồm tuyến đường thân thiện với môi trường:
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'
Nội dung phản hồi chứa mức tiêu thụ nhiên liệu ước tính cho cả tuyến đường mặc định và tuyến đường thân thiện với môi trường:
{
"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"
]
}
]
}
Khu vực được hỗ trợ
Nhóm Google Maps Platform không ngừng nỗ lực để cải thiện phạm vi cung cấp quốc tế cho các dịch vụ API của chúng tôi. Danh sách sau đây cho biết thông tin chi tiết mới nhất về phạm vi cung cấp dịch vụ theo từng quốc gia đối với tính năng định tuyến thân thiện với môi trường:
- Albania (AL)
- Áo (AT)
- Bỉ (BE)
- Bosnia và Herzegovina (BA)
- Bulgaria (BG)
- Canada (CA)
- Croatia (HR)
- Síp (CY)
- Cộng hoà Séc (CZ)
- Đan Mạch (DK)
- Estonia (EE)
- Phần Lan (FI)
- Pháp (FR)
- Đức (DE)
- Hy Lạp (GR)
- Hungary (HU)
- Iceland (IS)
- Ireland (IE)
- Ý (IT)
- Kosovo (XK)
- Latvia (LV)
- Liechtenstein (LI)
- Lithuania (LT)
- Luxembourg (LU)
- Malta (MT)
- Montenegro (ME)
- Hà Lan (NL)
- Bắc Macedonia (MK)
- Na Uy (NO)
- Ba Lan (PL)
- Bồ Đào Nha (PT)
- Romania (RO)
- Serbia (RS)
- Slovakia (SK)
- Slovenia (SI)
- Tây Ban Nha (ES)
- Thuỵ Điển (SE)
- Thuỵ Sĩ (CH)
- Thổ Nhĩ Kỳ (TR)
- Vương Quốc Anh (GB)
- Hoa Kỳ (US)