速度限制

Roads API 会返回给定路段张贴的速度限制。如果路段具有可变速度限制,则返回相应路段的默认速度限制。

无法保证 Roads API 返回的速度限制数据的准确性。提供的速度限制数据并非实时数据,可能是预估、不准确、不完整和/或过时的数据。如需了解提供速度限制数据的区域,请参阅覆盖范围详情

请求数

速度限制请求必须通过 HTTPS 发送,并采用以下格式:

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

参数用法

必需参数

  • 可以是 pathplaceId 参数。
    • 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。API 不会针对提供的地点 ID 执行道路贴靠。响应包括请求中每个地点 ID 的速度限制。您可以发送 snapToRoadsnearestRoads 请求来查找相关的地点 ID,然后将其作为输入提供给 speedLimits 请求。以下示例展示了包含两个地点 ID 的 placeId 参数:placeId=ChIJX12duJAwGQ0Ra0d4Oi4jOGE&placeId=ChIJLQcticc0GQ0RoiNZJVa5GxU
  • key - 您的应用的 API 密钥。您的应用必须在每次向 Roads API 发送请求时标识自己,方法是在每个请求中添加 API 密钥。了解如何获取密钥

可选参数

  • units - 以公里/小时还是英里/小时为单位返回速度限制。此属性可以设置为 KPHMPH。默认设置为 KPH

响应

speedLimits 响应中可能会出现以下元素:

  • speedLimits - 道路元数据数组。每个元素都由以下字段组成:
    • placeId - 地点的唯一标识符。Roads API 返回的所有地点 ID 都对应于路段。
    • speedLimit - 该路段的速度限制。
    • units - 返回 KPHMPH
  • snappedPoints - 贴靠点的数组。仅当请求包含 path 参数时,才会显示此数组。每个数据点都由以下字段组成:
    • location - 包含 latitudelongitude 值。
    • originalIndex - 一个整数,表示原始请求中的对应值。请求中的每个值都应映射到响应中的某个贴靠值。这些值是从 0 编入索引的,因此 originalIndex4 的点将成为传递给 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,而不是使用纬度/经度对。我们建议您使用 snapToRoadsnearestRoads 请求获取路段的地点 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 缺失的最常见原因是请求对非路段的地点施加速度限制。

以上示例使用瓦斯科达伽马桥来说明概念;该桥支持横跨 Rio Tejo 的 E90 公路。桥梁本身的地点 ID 为 ChIJUzt97ZEwGQ0RM1JzQfqoDtU。上述响应中的第一个路段是 E90 道路的一部分,地点 ID 为 ChIJX12duJAwGQ0Ra0d4Oi4jOGE。在示例请求中,如果您将道路地点 ID 替换为桥梁的地点 ID,则在响应中,speedLimits 数组将只有两个速度限制,因为桥梁的地点 ID 并不引用单独的路段。此外,如果没有任何地点 ID 表示路段,则响应将不包含任何速度限制。

使用地点 ID 发出速度限制请求时,请确保每个地点 ID 都指的是一个路段,而不是不同类型的地点。最好使用 snapToRoadsnearestRoads 请求检索各个路段的地点 ID,这两种请求都可以通过单次调用返回多个地点 ID。