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 下载这些客户端库，并在那里找到安装说明和示例代码。

后续步骤