在預設情況下,Routes API 會傳回 default 路徑,也就是路徑 而不必將燃油或能源效率納入考量啟用「環保」時 路徑,您仍會在回應中取得預設路徑。此外,您亦可 返回環保路徑,當中顯示最省油或最節能的路線 根據你的車輛引擎類型產生建議
Routes API 傳回的環保路徑經過最佳化調整, 降低整條路線的燃油耗量API 會使用車輛的引擎 以及即時路況和路況等其他因素 選擇環保路徑路線的燃油或能源效率越高, 降低車輛的燃油/能源消耗和二氧化碳排放量。
舉例來說,柴油車輛的相對燃料經濟優勢通常 最優異的高速公路行駛情形。油電混合車和電動車 走走停停的城市和山坡行駛時,效率不斷提高 可廣泛使用並受益於生成式 AI 的環境 剎車
您也可以要求 API 傳回以下項目的預估燃料消耗量: 更棒的是使用預估燃油耗量進行比較 不同的路線,而不是確切的車輛預估油耗。
Google 地圖如何估算燃油效率
Routes API 根據美國的深入分析資訊預估燃油效率 能源部 國家可再生能源實驗室 以及歐洲環境署提供的資料計算時會考量多項因素 ,例如:
- 你所在區域的車輛平均燃油或能源消耗量
- 路線沿途的山坡陡峭程度
- 走走停停的車流量模式
- 道路類型 (例如地區道路或高速公路)
Routes API 會傳回最省油或最節能的路線 與預設路線大致相同的抵達時間。適用情況下 節能模式太小或大幅增加行車時間,API 顯示不同路線之間的相對省油量或節能量,方便你進行比較。
必要條件
如要使用環保路線或預估燃油耗量,請按照下列步驟操作:
您必須指定
TRAFFIC_AWARE_OPTIMAL
做為轉送偏好設定。在本 時,伺服器會更詳細地搜尋路網 找出最佳路線若需更多資訊,請參閲 設定品質與延遲時間。您必須將
travelMode
設為DRIVE
。要求 其他交通方式會傳回錯誤您必須設定起點路線控點的位置,位於 支援區域。否則,API 會傳回錯誤。
路線不得包含中間路點。
帳單
一般而言,Google 地圖平台不會收取預先發布版使用費
而不是每個特徵的分數但因為環保路徑和預估燃料消耗量
您必須指定 TRAFFIC_AWARE_OPTIMAL
做為轉送偏好設定,
計費依據為 SKU:Routes
進階。
預約環保路線
如要要求計算環保路徑,請設定下列屬性 :
使用以下定義的值,為車輛指定
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 回應,其中包含
兩條路線:預設路線和省油路線在回覆中:
針對預設路線,
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 地圖平台團隊持續致力於改善全球服務 涵蓋 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)