选择环保路线

默认情况下,Routes API 会返回默认路线,即不考虑燃料或能效的路线。启用环保路由后,您仍会在响应中获得默认路由。此外,您还可以返回环保路线,该路线会根据车辆的引擎类型显示最省油或最节能的路线。

Routes API 返回的环保路线经过优化,可降低整个路线的燃料消耗。该 API 会根据您车辆的引擎类型以及实时路况和路况等其他因素来选择环保路线。路线的燃油或能源效率越高,汽车的燃料/能源使用量和二氧化碳排放量就越低。

例如,柴油车的相对燃油经济效益在公路驾驶中通常最大。混合动力汽车和电动汽车在走走不停的城市驾驶和丘陵驾驶环境中往往效率会逐渐提高,在这类环境下,可以广泛使用再生制动系统并从中受益。

您还可以请求 API 返回整个路线的估算耗油量。使用油耗估算值作为比较不同路线的方式,而不是作为确切车辆的明确燃油用量估算值。

Google 地图如何估算燃油效率

Routes API 使用美国能源部国家可再生能源实验室的数据分析和欧洲环境署的数据来估算燃油效率。此计算结果包含影响燃料和能源使用量以及二氧化碳排放量的因素,例如:

  • 您所在地区车辆的平均油耗或能耗
  • 路线沿途山坡陡峭程度
  • 走走停停路况模式
  • 道路类型(例如市县级道路或高速公路)

当 Routes API 与默认路线的到达时间大致相同时,会返回最省油或最节能的路线。如果节省的燃油或能耗过少或行车时间大幅增加,该 API 会显示不同路线之间的相对燃油或节能量,以便您进行比较。

不妨详细了解环保路线技术 (PDF)

前提条件

若要使用环保路线或估算燃料消耗,请执行以下操作:

  • 您必须将 TRAFFIC_AWARE_OPTIMAL 指定为路由偏好设置。在此模式下,服务器会对道路网执行更详尽的搜索,以找到最佳路线。如需了解详情,请参阅配置质量与延迟时间

  • 您必须将 travelMode 设置为 DRIVE。针对任何其他出行方式的请求会返回错误。

  • 您必须在受支持的区域中设置出发地航点的位置。否则,该 API 会返回错误。

  • 路线不能包含中间航点。

结算

通常,Google Maps Platform 不会就预览版功能的使用收费。不过,由于环保路线和估算燃料消耗要求您将 TRAFFIC_AWARE_OPTIMAL 指定为路线偏好设置,因此您需要根据 SKU:高级路线付费。

详细了解 Routes API 的结算方式

查询环保路线

如需发出计算环保路线的请求,请在请求中设置以下属性:

  • 使用 VehicleEmissionType 中定义的值为车辆指定 emissionTypeDIESELGASOLINEELECTRICHYBRID。默认值为 GASOLINE

  • requestedReferenceRoutes 设为 FUEL_EFFICIENT

  • 设置一个响应字段掩码,用于指定返回与环保路线相关联的响应属性:

    • routes.routeLabels: 将每个路由标识为 DEFAULT_ROUTEFUEL_EFFICIENTDEFAULT_ROUTE_ALTERNATE

    • routes.routeToken::可传递给 Navigation SDK 以检索自定义路线的路线令牌。

环保请求示例

以下代码显示了一个环保路线请求。在此示例中,您将使用响应字段掩码返回与环保路线相关的响应属性以及 routes.distanceMetersroutes.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

  • 如果您在针对 true 的请求中设置 computeAlternativeRoutes 以计算备选路线,则 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_ROUTEFUEL_EFFICIENT 这两个标签:

{
  "routes": [
    {
      "distanceMeters": 45875,
      "duration": "2655s",
      "routeToken": "CvcDCos…6I40",
      "routeLabels": [
        "DEFAULT_ROUTE",
        "FUEL_EFFICIENT"
      ]
    }
  ]
}

估算路线的燃料用量

您可以请求使用该方法返回整个路线的预估燃料用量(以微升为单位)。如需将路线的预估燃料用量添加到响应,请执行以下操作:

  • extraComputations 数组字段设置为 FUEL_CONSUMPTION 以启用燃料用量计算。

  • 使用 VehicleEmissionType 中定义的值为车辆指定 emissionTypeDIESELGASOLINEELECTRICHYBRID。默认值为 GASOLINE

    如果 emissionTypeHYBRID,API 会将电力和燃料消耗转换为微升燃料。

    如果 emissionTypeELECTRIC,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 Maps Platform 团队始终致力于扩大我们的 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)