为何使用 Roads API
借助 Roads API,您可以获取速度限制、预计到达时间或其他道路元数据。借助此类道路元数据,您可以通过以下功能增强驾驶应用:
- 将纬度/经度坐标与道路连接起来。
- 根据一组坐标查找最近的道路
- 获取路段的速度限制
Roads API 的用途
借助 Roads API,您可以将 GPS 坐标映射到道路的几何图形,并确定路段沿线的速度限制。
- 沿实际道路:此服务会根据提供的 GPS 坐标集返回最有可能已行驶的道路。您最多可以指定路线沿途收集的 100 个 GPS 点。或者,您还可以请求服务插值其他点,使生成的路径平滑地遵循道路的几何图形。
- 最近的道路:此服务会返回一个 GPS 点最近的路段。您最多可以指定 100 个 GPS 点。 您指定的点不必是连续路径的一部分。
- 速度限制:此服务会返回某个路段的公布速度限制。速度限制服务可供拥有资产跟踪许可的所有客户使用。对于已改用随用随付价格模式的 Google Maps Platform 专业版方案客户,该功能仍然有效。
Roads API 的运作方式
Roads API 使用三个端点,这些端点接受纬度/经度坐标或地点 ID 以提供道路路径、路段或速度限制数据。以下示例展示了如何根据一组纬度/经度坐标请求获取最近道路:
https://roads.googleapis.com/v1/nearestRoads ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796 &key=YOUR_API_KEY
资源
下表总结了 Roads API 提供的资源及其返回的数据。
数据资源 | 返回的数据 | 返回格式 |
---|---|---|
沿实际道路 |
用于返回路线中最多包含 100 个 GPS 点的数组。包括道路贴靠的经度/纬度坐标以及地点 ID。如需了解详情,请参阅贴靠道路指南中的响应。 |
|
最近的道路 |
一个数组,包含最多 100 个独立的纬度/经度坐标,以及每个指定点最近道路的地点 ID。点不必是连续的。如需了解详情,请参阅最近的道路指南中的响应。 |
|
速度限制 |
最多包含 100 个道路元数据元素的数组。这些字段包含速度限制和地点 ID,单位为 KPH 或 MPH。如需了解详情,请参阅速度限制指南中的响应部分。 |
如何使用 Roads API
1 | 试用道路吸附演示 | 点击演示即可创建一条航迹,看看吸附到道路的端点如何提供平滑的数据。请参阅沿实际道路指南中的演示 。您不需要 API 密钥。 |
2 | 进行设置 | 从设置您的 Google Cloud 项目开始,完成接下来的设置说明,然后了解如何使用 API 密钥。 |
3 | 尝试沿实际道路请求 | 使用一个道路吸附示例 ,并尝试与您的用例相关的一个示例。 |
4 | 查看道路的限速信息 | 使用您为道路吸附请求提供的相同路径数据,发出速度限制查询。请参阅使用路径的请求示例。 |
5 | 了解如何处理长路径 | 按照高级概念指南中有关处理长路径 的部分进行操作。 |
6 | 将道路数据整合到您自己的应用中! | 请参阅道路贴靠演示中的详细代码示例,开始将道路数据功能构建到您自己的应用中。 |
可用的客户端库
请通过以下任一客户端库以您选择的语言调用此 API:
- 适用于 Google 地图服务的 Java 客户端
- 适用于 Google 地图服务的 Python 客户端
- 适用于 Google 地图服务的 Go 客户端
- 适用于 Google 地图服务的 Node.js 客户端
适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端是由社区提供支持的客户端库,并且根据 Apache 2.0 许可开源。请从 GitHub 下载这些示例,您还可以从 GitHub 中找到安装说明和示例代码。