一切就绪!

着手开发前,请先阅读我们的开发者文档

激活 Google Maps Roads API

为帮助您起步,我们将引导您在 Google Developers Console 中先完成几项任务:

  1. 创建或选择项目
  2. 激活 Google Maps Roads API
  3. 创建相应密钥
继续

速度限制

注:速度限制服务只提供给拥有资产追踪许可证的 Google Maps APIs Premium Plan

客户。

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

无法保证 Google Maps Roads API 所返回速度限制数据的精确度。 提供的速度限制数据并非实时数据,可能是预估、不准确、不完整和/或过时的数据。 可通过 [Google 地图标记工具]服务报告不准确的数据。

请求

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

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

参数使用

必填参数

  • 一个 path 或者一个或多个 placeId

    • path — 需要吸附的路径。 path 参数接受纬度/经度对列表。 纬度值和经度值应使用逗号分隔。 坐标应使用管道符号“|”分隔。 例如: path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796
    • placeId — 路段的地点 ID。 snapToRoadsnearestRoads 请求的响应中将返回地点 ID。 最多可随每个请求传递多达 100 个 placeId
  • key — 您的应用的 API 密钥。 您的应用必须在每次向 Google Maps Roads API 发送请求时通过为请求附带 API 密钥对自身加以标识。

了解如何获取密钥

选填参数

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

您可以使用一个 path 或一系列 placeId 来请求速度限制数据;不过,对于请求中每个唯一的 placeId,您只会收到一个响应。

短距离沿线有多个点时,可能存在重复的 placeId

响应

speedLimits 响应中可能存在下列元素:

  • speedLimits — 道路元数据数组。 每个元素都包含下列字段:

    • placeId — 地点的唯一标识符。 Google Maps Roads API 返回的所有 placeId 均对应于路段。

    • speedLimit — 该路段的速度限制。

    • units — 返回 KPHMPH
    • snappedPoints — 吸附点数组。 此数组只存在于请求包含 path 参数时。 每个点都包含下列字段:

    • location — 包含一个 latitude 值和一个 longitude 值。

    • originalIndex — 一个表示原始请求中对应值的整数。 请求中的每个值都应与响应中的某个吸附值相对应。 这些值的索引起始值为 0,因此 originalIndex4 的点将是传递给 path 参数的第 5 个纬度/经度的吸附值。

    • placeId — 地点的唯一标识符。 Google Maps Roads API 返回的所有 placeId 均对应于路段。

    您可以在速度限制请求中传递 placeId 来确定该路段沿线的速度限制。

示例请求

以下请求将确定澳大利亚堪培拉某个短距离路段的速度限制。

请求

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJ1Wi6I2pNFmsRQL9GbW7qABM
        &placeId=ChIJ58xCoGlNFmsRUEZUbW7qABM
        &placeId=ChIJ9RhaiGlNFmsR0IxAbW7qABM
        &placeId=ChIJabjuhGlNFmsREIxAbW7qABM
        &placeId=ChIJcSAlFWpNFmsRMHlUbW7qABM
        &placeId=ChIJI2FUTGhNFmsRcHpAbW7qABM
        &placeId=ChIJiy6YT2hNFmsRkHZAbW7qABM
        &placeId=ChIJoR7CemhNFmsRQB9QbW7qABM
        &placeId=ChIJP2m_FWpNFmsRIHlUbW7qABM
        &placeId=ChIJtV7La2pNFmsRAGpHbW7qABM
        &placeId=ChIJW5JAZmpNFmsRegG0-Jc80sM
        &placeId=ChIJW9R7smlNFmsRMH1AbW7qABM
        &placeId=ChIJy8c0r2lNFmsRQEZUbW7qABM
        &key=YOUR_API_KEY

响应

{
  "speedLimits": [
    {
      "placeId": "ChIJ1Wi6I2pNFmsRQL9GbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ58xCoGlNFmsRUEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ9RhaiGlNFmsR0IxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJabjuhGlNFmsREIxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJcSAlFWpNFmsRMHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJI2FUTGhNFmsRcHpAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJiy6YT2hNFmsRkHZAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJoR7CemhNFmsRQB9QbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJP2m_FWpNFmsRIHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJtV7La2pNFmsRAGpHbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW5JAZmpNFmsRegG0-Jc80sM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW9R7smlNFmsRMH1AbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJy8c0r2lNFmsRQEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    }
  ]
}

发送以下问题的反馈:

此网页
Google Maps Roads API
Google Maps Roads API
需要帮助?请访问我们的支持页面