本頁面由 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：路徑介面集向您收取費用。

進一步瞭解 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: API_KEY' \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2: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: 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)
比利時 (比利時)
波士尼亞與赫塞哥維納 (BA)
保加利亞 (BG)
加拿大 (CA)
克羅埃西亞 (HR)
賽普勒斯 (CY)
捷克 (CZ)
丹麥 (DK)
愛沙尼亞 (EE)
芬蘭 (FI)
法國 (FR)
德國 (德國)
希臘 (GR)
匈牙利 (HU)
冰島 (IS)
愛爾蘭
義大利 (IT)
科索沃 (XK)
拉脫維亞 (LV)
列支敦斯登 (LI)
立陶宛 (LT)
盧森堡 (LU)
馬爾他 (MT)
蒙特內哥羅 (ME)
荷蘭 (NL)
北馬其頓 (MK)
挪威 (NO)
波蘭 (PL)
葡萄牙 (PT)
羅馬尼亞 (RO)
塞爾維亞 (RS)
斯洛伐克 (SK)
斯洛維尼亞 (SI)
西班牙 (ES)
瑞典 (SE)
瑞士 (CH)
土耳其 (TR)
英國 (GB)
美國 (US)