计算路线概览

“计算路线”是 Routes API 服务中的一个方法，用于接受 HTTPS 请求并返回两个地点之间的理想路线。提供多个地点之间的公交、骑车、驾车、2 轮机动车辆或步行路线，并显示实时路况。

需要路线矩阵？如果您对路线矩阵感兴趣，请参阅计算路线矩阵概览。

正在迁移？如果您要从 Distance Matrix API（旧版）进行迁移，请参阅从为何迁移到 Routes API 开始的迁移说明。

为何使用计算路线

借助计算路线，您可以根据自己的偏好设置路线详情，同时优化费用和质量，为车辆或包裹规划路线。

您可以使用计算路线做些什么？

借助 Routes API Compute Routes 方法，您可以执行以下操作：

  • 查询不同交通方式的路线，以及单个或多个目的地的路线：

    • 交通方式：公交、驾车、两轮车、步行或骑车。

    • 一系列航点，您可以对其进行优化，以便以最有效的顺序前往这些航点。

  • 可通过多种方式指定起点、目的地和路点：

    • 文本字符串。例如：“芝加哥，伊利诺伊州”“达尔文，澳大利亚北领地”“1800 Amphitheatre Parkway, Mountain View, CA 94043”或“CWF6+FWX Mountain View, California”

    • 地点 ID

    • 经纬度坐标（可选填车辆航向）

  • 根据您的需求和目标微调路线选项：

  • 使用字段掩码仅请求所需数据，从而控制延迟时间和质量，这有助于避免产生不必要的处理时间和更高的请求结算费率。如需了解详情，请参阅选择要返回的信息。

计算路线的运作方式

Routes API ComputeRoutes 方法接受包含请求详细信息的 JSON 请求正文的 HTTP POST 请求。必需提供来源、目的地、travelMode 和字段掩码，以指定要返回的字段。

示例

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

然后，该服务会计算所请求的路线，并返回您请求的字段。

资源

下表汇总了通过 Routes API Compute Routes 方法提供的资源以及它返回的数据。

数据资源 返回的数据 返回格式
ComputeRoutes 返回路线、路段和步骤，以及备选路线（如果请求）。 JSON

如何使用计算路线

1 开始设置 首先设置 Google Cloud 项目，然后完成后续的设置说明。
2 了解 Routes API 的计费方式 如需了解详情，请参阅用量和结算。
3 计算路线并查看响应 如需了解详情，请参阅获取路线和查看路线响应。

可用的客户端库

如需查看适用于 Compute 路线的可用客户端库列表，请参阅客户端库。

后续步骤