选择环保路线

默认情况下，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 中定义的值为车辆指定 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 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)