一切就绪!

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

激活 Google Maps Roads API

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

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

最近的道路

Google Maps Roads API 可以接收多达 100 个独立坐标,并返回每个点最近的路段。 传递的点不必为连续路径的一部分。

如果您要处理按顺序排列的 GPS 点,请使用 Snap to Roads

请求

最近的道路请求必须通过 HTTPS 发送,并采用下列格式:

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

参数使用

必填参数

  • points — 纬度/经度对列表。 纬度值和经度值应使用逗号分隔。 坐标应使用管道字符“|”分隔。 例如: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796
  • key — 您的应用的 API 密钥。 您的应用必须在每次向 Google Maps Roads API 发送请求时通过为请求附带 API 密钥对自身加以标识。

了解如何获取密钥

响应

对于每个有效的请求,Google Maps Roads API 都会以请求网址内指定的格式返回响应。 Snap to Roads 响应中可能存在下列元素:

  • snappedPoints — 吸附点数组。 每个点都包含下列字段:

    • location — 包含一个 latitude 值和一个 longitude 值。
    • originalIndex — 一个表示原始请求中对应值的整数。 请求中的每个点在响应中都映射到最多两个路段:

      • 如果附近没有道路,将不会返回路段。
      • 如果最近的道路为单向,将返回一个路段。
      • 如果最近的道路为双向,将返回两个路段。
        • placeId — 地点的唯一标识符。 Google Maps Roads API 返回的所有地点 ID 均对应于路段。

    [地点 ID] 可与包括 Google Places APIGoogle Maps JavaScript API 在内的其他 Google API 结合使用。

例如,如果您需要获取 Google Maps Roads API 返回的吸附点的道路名称,可以将 placeId 传递给 Google Places APIGoogle Maps Geocoding API

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

示例请求

下面的请求将根据指定的坐标列表返回一组路段。

请求

https://roads.googleapis.com/v1/nearestRoads?points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796&key=YOUR_API_KEY

响应

{
  "snappedPoints": [
    {
      "location": {
        "latitude": 60.170877918672588,
        "longitude": 24.942699821922421
      },
      "originalIndex": 0,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170876898776406,
        "longitude": 24.942699912064771
      },
      "originalIndex": 1,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    },
    {
      "location": {
        "latitude": 60.170874902634374,
        "longitude": 24.942700088491474
      },
      "originalIndex": 2,
      "placeId": "ChIJNX9BrM0LkkYRIM-cQg265e8"
    }
  ]
}

发送以下问题的反馈:

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