Routes API 概览

Routes API 是一项服务,它接受 HTTPS 请求并返回两个位置之间的理想路线,或不同出发地和目的地之间的路线矩阵的距离和行程时间。

为何使用 Routes API

借助 Routes API,您可以使用交通详情、最新路况和路况以及路线偏好设置来获取准确的路线和行程信息:

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

  • 车辆的行驶方向

  • 适合上车或下车的路边

  • 路况和封路

  • 安全问题,例如避开危险区域或提供安全上车区域

  • 使用通行费和行程元数据(例如时间和距离以及燃油效率)等可选功能,在您的路线需求之间平衡延迟时间、质量和费用

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

  • 如何以最佳方式指派一组工作人员来挑选一系列包裹

  • 确定将包裹从哪个仓库运送到最终目的地的最佳仓库

Routes API 有哪些功能?

使用 Routes API,您可以获取两类主要的路由信息:

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

  • 许多起点和终点之间的可能路线矩阵

查询单个或多个目的地的路线

借助 Routes API Compute Routes 方法,您可以计算不同位置之间的距离:

  • 获取不同出行方式的路线以及单个或多个目的地的路线:

    • 交通方式,包括公交、驾车、双轮机动车、步行或骑车。

    • 您可以优化的一系列航点,实现这些航点的最高效顺序。

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

    • 文本字符串。例如:“伊利诺伊州芝加哥市”“澳大利亚新南威尔士州达尔文市”“1800 Amphitheatre Parkway, Mountain View, CA 94043”或“CWF6+FWX Mountain View, California”

    • 地点 ID

    • 纬度和经度坐标(可视需要添加车辆方向)

  • 根据您的需求和目标优化路线选项

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

获取可能路线的矩阵

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

  • 所选出行方式的距离

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

  • 交通拥堵时的预估行程时间

利用距离数据,您可以确定在多个可能的出发地和目的地之间路由乘客、货物或工作人员的最有效方式。

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

您可以为每个服务器端请求指定多个出发地和目的地,并将出发地数量乘以目的地数量(最多 625)。

Routes API 的工作原理

Routes API 有两个方法:ComputeRouteComputeRouteMatrix

ComputeRoute

Routes API ComputeRoute 方法接受 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'

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

ComputeRouteMatrix

Routes API ComputeRouteMatrix 接受 HTTP POST 请求,其 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 提供的资源及其返回的数据。

数据资源 返回的数据 返回格式
ComputeRoute 返回路线的路线、路程和路段以及备选路线(如果请求的话)。 JSON
ComputeRouteMatrix 返回从一个出发地航点到一个目的地航点的路线数组。

如何使用 Routes API

1 开始设置 设置您的 Google Cloud 项目开始,完成以下设置说明。
2 计算路线并查看响应 如需了解详情,请参阅获取路线查看路线响应
3 计算路线矩阵并查看响应 如需了解详情,请参阅获取路线矩阵查看路线矩阵响应

可用的客户端库

如需查看 Routes API 的可用客户端库列表,请参阅客户端库

后续步骤