计算路线概览

欧洲经济区 (EEA) 开发者

简介

Compute Routes 是 Routes API 服务中的一种方法，可接受 HTTPS 请求并返回两个地点之间的理想路线。提供多个地点之间的公交、骑行、驾车、两轮机动车或步行路线及实时路况。

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

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

为何使用 Compute Routes

借助 Compute Routes，您可以根据自己的偏好，利用各种路线详情来规划车辆或包裹的路线，同时优化成本和质量。

Compute Routes 有哪些用途？

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

  • 查询不同出行方式的路线，以及前往单个或多个目的地的路线：

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

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

  • 使用多种方式指定起点、终点和航点：

    • 文本字符串。例如：“Chicago, IL”“Darwin, NT, Australia”“1800 Amphitheatre Parkway, Mountain View, CA 94043”或“CWF6+FWX Mountain View, California”

    • 地点 ID

    • 纬度和经度坐标，可选择包含车辆朝向

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

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

Compute Routes 的运作方式

Routes API ComputeRoutes 方法接受 HTTP POST 请求，其中包含 JSON 请求正文，其中包含请求详细信息。必填字段包括起点、终点、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

如何使用 Compute Routes

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

可用的客户端库

如需查看 Compute Routes 的可用客户端库列表，请参阅客户端库。

后续步骤