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获取的资源以及返回的数据。

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

返回路线中最多 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 上找到安装说明和示例代码。

后续步骤