为何使用 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 客户端、Python 客户端、Go 客户端和 Node.js 客户端 服务是社区支持的客户端库，已按照 Apache 2.0 许可。 您可以从 GitHub 下载它们，您还可以在 GitHub 上找到安装说明和示例代码。