为何使用 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 客户端
- 适用于 Google 地图服务的 Python 客户端
- 适用于 Google 地图服务的 Go 客户端
- 适用于 Google 地图服务的 Node.js 客户端
适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端是由社区提供支持的客户端库,并且根据 Apache 2.0 许可开放源代码。您可以从 GitHub 下载这些客户端库,还可以在其中找到安装说明和示例代码。
后续步骤
- 试用 Roads API:前往 Roads Inspector
- 了解如何发出 Roads API 请求:前往您感兴趣的服务:
- 了解高级概念:前往高级概念
- 遵循最佳实践:前往 Web 服务最佳实践