Routes API 概览

Routes API 是一项服务，可接受 HTTPS 请求， 返回两个位置之间的理想路线或者距离和旅行信息 不同起点和终点之间路线矩阵的时间。

为何要使用 Routes API

借助 Routes API，您可以获取准确的路线和行程信息 根据交通详细信息、最新路况和路况信息，以及路线信息， 偏好设置：

  • 不同交通方式的类型和功能

  • 车辆朝向哪个方向

  • 上车点或下车点的路边

  • 路况和封路

  • 出于安全方面的考虑，例如避开危险区域或提供安全上车点 区域

  • 可选功能可根据您的路由需求平衡延迟时间、质量和费用 提供通行费和行程元数据（如时间和距离）以及燃油费等功能 效率

您还可以为调度安排确定最高效的路线，例如 以：

  • 如何以最佳方式分配一组 worker 以提取一系列软件包

  • 确定最适合将包裹寄送到最终订单的仓库 目标账号

Routes API 有哪些用途？

借助 Routes API，您可以获得 信息：

  • 从某个位置到一个或多个目的地的路线

  • 多个起始位置和结束位置之间的可能路线的矩阵。

获取单个或多个目的地的路线

借助 Routes API Compute Routes 方法， 您可以在不同位置之间进行计算：

  • 查询不同出行方式的路线，以及一条或多条路线 目的地：

    • 交通方式，包括公交、驾车、双轮机动车、 例如步行或骑车

    • 一系列航点，您可对这些航点进行优化，从而实现最高效的 传送给他们

  • 指定出发地、目的地和航点的多种方式：

    • 文本字符串。例如："Chicago, IL"、"Darwin, NT, Australia"、 “1800 Amphitheatre Parkway, Mountain View, CA 94043”或“CWF6+FWX Mountain “加利福尼亚视图”

    • 地点 ID

    • 经纬度坐标，（可选）带有车辆方向

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

  • 控制延迟时间和质量，只需使用 字段掩码，这有助于避免不必要的处理时间和 请求结算费率。有关详情，请参阅 选择要返回的信息。

获取可能路由的矩阵

Routes API Compute Route Matrix 方法提供 多个起点和终点之间的推荐路由的信息矩阵 这些点（包括距离和预计到达时间），以帮助您选择 最佳出发地和目的地 业务需求。您可以请求以下类型的距离数据：

  • 所选出行方式的距离

  • 以公里或英里为单位的距离

  • 预估交通时间

利用距离数据，您可以确定最高效的路线 乘客、货物或工作人员之间 目标。

您可以在完成整个矩阵之前流式传输响应元素 从而缩短响应延迟时间。

您可以使用 起点的数量乘以终点的数量，最高为 625。

Routes API 的运作方式

Routes API 有两种方法：ComputeRoutes 和 ComputeRouteMatrix。

ComputeRoutes

Routes API ComputeRoutes 方法接受带有 包含请求详情的 JSON 请求正文。必须指定来源 destination、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'

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

ComputeRouteMatrix

Routes API ComputeRouteMatrix 接受带有 包含请求详情的 JSON 请求正文。必须至少选择一个 出发地、两个或更多目的地、travelMode 以及用于指定 字段。

示例

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

响应包含所有源站组合的可能路由 和目的地航点。

资源

下表总结了 Routes API 及其返回的数据。

数据资源 返回的数据 返回格式
ComputeRoutes 返回路线、路程和路段以及备选路线 （如果需要的话）。 JSON
ComputeRouteMatrix 返回从一个出发地航点到一个目的地的一组路线 航点。

如何使用 Routes API

1 开始设置 请先设置您的 Google Cloud 项目 并完成随后显示的设置说明。
2 计算路线并查看回复 如需了解详情，请参阅获取路线和查看路线响应。
3 计算路由矩阵并查看响应 如需了解详情，请参阅获取路由矩阵 和查看路由矩阵响应。

可用的客户端库

如需了解 Routes API 的可用客户端库列表，请参阅 客户端库。

后续步骤