Roads API 概览

Roads API 服务可接受带有 地图上的一个或多个点的纬度/经度坐标。它使用 用于查找附近的路段，并返回地点 ID 及元数据 例如最近的路段和限速信息

为何使用 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 的信息。详情请访问 响应 在沿实际道路 指南。
  • JSON
最近的道路

最多包含 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 上找到安装说明和示例代码。

后续步骤