速度限制

Roads API 针对特定路段返回公布的限速信息。如果路段的限速可变，则返回该路段的默认限速。

无法保证 Roads API 返回的车速限制数据的准确性。提供的限速数据并非实时数据，可能为估算数据，也可能不准确、不完整或已过时。如需查看提供限速数据的区域，请参阅覆盖范围详情。

请求

使用 HTTPS 发送限速请求，格式如下： 

https://roads.googleapis.com/v1/speedLimits?parameters&key=YOUR_API_KEY

参数使用情况

必需参数

  • path 或 placeId 参数。

    • path - 最多包含 100 个纬度/经度对的列表，表示一条路径。纬度和经度值必须以英文逗号分隔。 纬度/经度对必须以竖线字符“|”分隔。当您提供 path 参数时，API 会先将路径贴合到车辆最有可能行驶的道路上（与 snapToRoads 请求一样），然后确定相关路段的速度限制。如果您不希望 API 对路径进行贴合，则必须传递 placeId 参数，如下所述。以下示例展示了包含三对纬度/经度的 path 参数：path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796。

    • placeId - 表示一个或多个路段的地点 ID。 确保每个地点 ID 都指向路段，而不是其他类型的地点。您可以在每个请求中传递最多 100 个地点 ID。响应包含请求中每个地点 ID 的速度限制。

      该 API 不会对提供的地点 ID 执行道路贴合操作。 您可以发送 snapToRoads 或 nearestRoads 请求来查找相关地点 ID，然后将这些 ID 作为输入提供给 speedLimits 请求。以下示例展示了包含两个地点 ID 的 placeId 参数： placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU

  • key - 您应用的 API 密钥。您的应用每次向 Roads API 发送请求时都必须标识自己，方法是在每个请求中添加 API 密钥。了解如何获取密钥。

可选参数

  • units - 是否以公里/小时或英里/小时为单位返回速度限制。可以设置为 KPH 或 MPH。默认设置为 KPH。

响应

speedLimits 响应中可能包含以下元素：

  • speedLimits - 道路元数据的数组。每个元素都包含以下字段：
    • placeId - 地点的唯一标识符。Roads API 返回的所有地点 ID 都将对应于路段。
    • speedLimit -相应路段的限速。
    • units - 返回 KPH 或 MPH。
  • snappedPoints - 贴合点的数组。仅当请求包含 path 参数时，此数组才会存在。每个点都包含以下字段：
    • location - 包含 latitude 和 longitude 值。
    • originalIndex - 一个整数，用于指示原始请求中的相应值。请求中的每个值都应映射到响应中的贴靠值。这些值的索引从 0 开始，因此 originalIndex 为 4 的点将是传递给 path 参数的第 5 个纬度/经度的贴靠值。
    • placeId - 地点的唯一标识符。Roads API 返回的所有地点 ID 都将对应于路段。 placeId 可在限速请求中传递，以确定相应路段的限速。
  • warning_message - 包含用户可见警告的字符串。

使用路径的请求示例

此请求会获取路径中距离指定纬度/经度对最近的每个路段的限速信息，该路径会穿过葡萄牙里斯本的瓦斯科·达·伽马大桥。

请求

https://roads.googleapis.com/v1/speedLimits?path=38.75807927603043,-9.03741754643809|38.6896537,-9.1770515|41.1399289,-8.6094075&key=YOUR_API_KEY

答案

{
  speedLimits:
  [
    {
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE",
      speedLimit: 105,
      units: "KPH"
    },
    {
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU",
      speedLimit: 70,
      units: "KPH"
    },
    {
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M",
      speedLimit: 55,
      units: "KPH"
    }
  ],
  snappedPoints:
  [
    {
      location:
      {
        latitude: 38.75807927603043,
        longitude: -9.037417546438084
      },
      originalIndex: 0,
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE"
    },
    {
      location:
      {
        latitude: 38.689653701836896,
        longitude: -9.177051486847693
      },
      originalIndex: 1,
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU"
    },
    {
      location:
      {
        latitude: 41.13993011767777,
        longitude: -8.609400794783655
      },
      originalIndex: 2,
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M"
    }
  ],
  warningMessage: "Input path is too sparse. You should provide a path where consecutive points are closer to each other. Refer to the 'path' parameter in Google Roads API documentation."
}

请注意上述响应中有关点稀疏性的警告消息。如果您要请求任意点处最近路段的限速，则必须使用从 nearestRoads 端点检索到的地点 ID 调用 speedLimits。

使用地点 ID 的请求示例

您可以传递路段的地点 ID，而不是使用经纬度对。我们建议您使用 snapToRoads 或 nearestRoads 请求获取路段的地点 ID。传递地点 ID 时，API 会返回每个地点 ID 所代表的路段的限速信息。该 API 不会对提供的地点 ID 应用任何道路贴合。

以下示例请求了葡萄牙里斯本瓦斯科达伽马大桥上部分路段的限速。

请求

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU&placeId=ChIJJ4vQRudkJA0RpednU70A-5M&key=YOUR_API_KEY

答案

{
  "speedLimits": [
    {
      placeId: "ChIJX12duJAwGQ0Ra0d4Oi4jOGE",
      speedLimit: 105,
      units: "KPH"
    },
    {
      placeId: "ChIJLQcticc0GQ0RoiNZJVa5GxU",
      speedLimit: 70,
      units: "KPH"
    },
    {
      placeId: "ChIJJ4vQRudkJA0RpednU70A-5M",
      speedLimit: 55,
      units: "KPH"
    }
  ]
}

使用建议

为了尽量减少对速度限制服务的调用次数，我们建议每隔 5 到 15 分钟对资产位置进行采样（确切的值取决于资产的行驶速度）。如果资产固定不动，一个位置样本就够（无需多次调用）。

为了尽可能缩短总体延迟时间，我们建议您在累积一些数据后再调用速度限制服务，而不是每次收到移动资产位置时都调用 API。

为什么缺少部分/所有限速信息？

缺少 speedLimits 的最常见原因是请求了非路段位置的限速。

上述示例使用瓦斯科·达·伽马大桥来说明相关概念；该桥梁支持 E90 公路跨越特茹河。该桥梁本身的地点 ID 为 ChIJUzt97ZEwGQ0RM1JzQfqoDtU。上述响应中的第一个路段是 E90 公路的一部分，其地点 ID 为 ChIJX12duJAwGQ0Ra0d4Oi4jOGE。在示例请求中，如果您将道路地点 ID 替换为桥梁的地点 ID，则响应中的 speedLimits 数组中将只有两个限速，因为桥梁的地点 ID 不会引用单个路段。此外，如果所有地点 ID 都不对应于路段，则响应中不会包含任何限速信息。

使用地点 ID 发出限速请求时，请确保每个地点 ID 都指向路段，而不是其他类型的地点。最好使用 snapToRoads 或 nearestRoads 请求来检索各个路段的地点 ID，这两种请求都可以通过一次调用返回多个地点 ID。