Roads API 概览

Roads API 是一项服务,用于接受包含地图上一个或多个点的纬度/经度坐标的 HTTPS 请求。它使用这些点查找附近的道路路段,并返回地点 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 提供的资源以及该 API 返回的数据。

数据资源 返回的数据 返回格式
沿实际道路

用于从路线中返回一个最多包含 100 个 GPS 点的数组。包含经过道路贴靠处理的经度/纬度坐标以及地点 ID。如需了解详情,请参阅贴合道路指南中的响应部分。

  • JSON
最近的道路

一个数组,其中包含最多 100 个独立的纬度/经度坐标,以及每个指定点的最近道路的地点 ID。点不必连续。如需了解详情,请参阅最近的道路指南中的回答部分。

速度限制

最多包含 100 个道路元数据元素的数组。这些数据包含限速和地点 ID,单位为公里/小时或英里/小时。如需了解详情,请参阅速度限制指南中的响应部分。

如何使用 Roads API

1 试用“贴靠到道路”演示 点击演示以创建路线,看看“沿实际道路”端点如何提供平滑数据。请参阅贴合道路指南中的演示 。您无需 API 密钥。
2 开始设置 首先设置 Google Cloud 项目,然后完成后续的设置说明,最后了解如何使用 API 密钥
3 尝试“沿实际道路”请求 使用路线贴靠示例之一 ,并尝试与您的用例相关的示例。
4 获取道路路径的速度限制 使用您为“贴靠到道路”请求提供的路径数据,发出限速查询。请参阅使用路径的示例请求
5 了解如何处理长路径 请参阅高级概念指南中的处理长路径 部分。
6 将道路数据纳入您自己的应用中! 如需开始在自己的应用中构建道路数据功能,请参阅道路贴合演示中的详细代码示例

可用的客户端库

通过以下某个客户端库,以您选择的语言调用此 API:

适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端是由社区提供支持的客户端库,并且根据 Apache 2.0 许可开放源代码。您可以从 GitHub 下载这些库,还可以在 GitHub 上找到安装说明和示例代码。

后续步骤