規劃環保路線

在預設情況下，Routes API 會傳回 default 路徑，也就是路徑 而不必將燃油或能源效率納入考量啟用「環保」時 路徑，您仍會在回應中取得預設路徑。此外，您亦可 返回環保路徑，當中顯示最省油或最節能的路線 根據你的車輛引擎類型產生建議

Routes API 傳回的環保路徑經過最佳化調整， 降低整條路線的燃油耗量API 會使用車輛的引擎 以及即時路況和路況等其他因素 選擇環保路徑路線的燃油或能源效率越高， 降低車輛的燃油/能源消耗和二氧化碳排放量。

舉例來說，柴油車輛的相對燃料經濟優勢通常 最優異的高速公路行駛情形。油電混合車和電動車 走走停停的城市和山坡行駛時，效率不斷提高 可廣泛使用並受益於生成式 AI 的環境 剎車

您也可以要求 API 傳回以下項目的預估燃料消耗量： 更棒的是使用預估燃油耗量進行比較 不同的路線，而不是確切的車輛預估油耗。

Google 地圖如何估算燃油效率

Routes API 根據美國的深入分析資訊預估燃油效率 能源部 國家可再生能源實驗室 以及歐洲環境署提供的資料計算時會考量多項因素 ，例如：

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

Routes API 會傳回最省油或最節能的路線 與預設路線大致相同的抵達時間。適用情況下 節能模式太小或大幅增加行車時間，API 顯示不同路線之間的相對省油量或節能量，方便你進行比較。

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

必要條件

如要使用環保路線或預估燃油耗量，請按照下列步驟操作：

  • 您必須指定 TRAFFIC_AWARE_OPTIMAL 做為轉送偏好設定。在本 時，伺服器會更詳細地搜尋路網 找出最佳路線若需更多資訊，請參閲 設定品質與延遲時間。

  • 您必須將 travelMode 設為 DRIVE。要求 其他交通方式會傳回錯誤

  • 您必須設定起點路線控點的位置，位於 支援區域。否則，API 會傳回錯誤。

  • 路線不得包含中間路點。

帳單

一般而言，Google 地圖平台不會收取預先發布版使用費 而不是每個特徵的分數但因為環保路徑和預估燃料消耗量 您必須指定 TRAFFIC_AWARE_OPTIMAL 做為轉送偏好設定， 計費依據為 SKU：Routes 進階。

進一步瞭解 Routes API 的計費方式。

預約環保路線

如要要求計算環保路徑，請設定下列屬性 ：

  • 使用以下定義的值，為車輛指定 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)