为何要使用 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 的可用客户端库列表,请参阅 客户端库。