本頁面由 Cloud Translation API 翻譯而成。

規劃環保路線
透過集合功能整理內容你可以依據偏好儲存及分類內容。

根據預設，Routes API 會傳回預設路線，也就是不考量燃料或能源效率的路線。啟用環保路由後，您仍會在回應中取得預設路由。此外，系統也會根據車輛引擎類型，顯示最省油或最節能的環保路線。

Routes API 傳回的環保路線經過最佳化處理，可降低整個路線的油耗。這個 API 會根據車輛的引擎類型，以及即時車流量和路況等其他因素，選擇最環保的路線。路線的燃油或能源效率越高，車輛的燃油/能源消耗和二氧化碳排放量就越低。

舉例來說，柴油車通常在高速公路上能發揮相對最佳的燃油效率。油電混合車及電動車在走走停停的城市和山坡行駛時，會頻繁利用再生煞車功能，可逐步發揮出色的燃油/能源效率。

您也可以要求 API 傳回整個路線的預估油耗。請使用油耗預估值比較不同路線，而非用於預估特定車輛的油耗。

Google 地圖如何估算燃油效率

Routes API 會根據美國能源部國家可再生能源實驗室的洞察資料，以及歐洲環境署提供的資料，估算燃油效率。計算時會納入影響燃油和能源消耗以及二氧化碳排放量的因素，例如：

你所在區域的車輛平均燃油或能源消耗量
路線沿途的山坡陡峭程度
走走停停的車流量模式
道路類型 (例如地區道路或高速公路)

如果最省油或最節能路線與預設路線的抵達時間相近，Routes API 會傳回這類路線。如果省油量或節能量過少，或是行車時間大幅增加，API 會顯示不同路線之間相對的省油量或節能量，方便你進行比較。

進一步瞭解環保路徑技術 (PDF)。

必要條件

如要使用環保路徑功能或估算油耗，請按照下列步驟操作：

您必須將 TRAFFIC_AWARE_OPTIMAL 指定為路由偏好設定。在這個模式中，伺服器會針對道路網路執行更詳盡的搜尋，以找出最佳路線。詳情請參閱「設定品質與延遲之間的關係」。
您必須將 travelMode 設為 DRIVE。其他任何行程模式的請求都會傳回錯誤。
您必須在支援的地區中設定原點路線點的位置。否則，API 會傳回錯誤。
路線不得包含中途控點。

帳單

一般來說，Google 地圖平台不會針對預先發布功能收費。不過，由於環保路徑和估算油耗功能需要您將 TRAFFIC_AWARE_OPTIMAL 指定為路徑偏好設定，因此系統會根據 SKU：Compute Routes Pro 計費。

進一步瞭解 Routes API 的結帳。

要求環保路徑

如要提出要求來計算環保路線，請在要求中設定下列屬性：

使用 VehicleEmissionType 中定義的值，為車輛指定 emissionType：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，即可啟用燃料使用量計算。
使用 VehicleEmissionType 中定義的值，為車輛指定 emissionType：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)