道路信息查询 API

道路信息查询根据单个或多个带时间戳的 GPS 点匹配道路，并返回行驶涉及道路的名称、道路等级、限速和道路几何点串。适用于轨迹道路属性展示、道路类型分析等场景。

道路信息查询 API

接口描述

输入按行驶顺序排列的 GPS 点串，获取对应道路信息。较长轨迹建议使用 POST，避免 GET URL 长度限制。

请求方式

URL	请求方式
https://lbs.xiaojukeji.com/api/v2/routefeature	POST、GET

请求

查询参数（GET）

参数名	必选	类型	描述	示例值
key	是	string	鉴权用的 API Key	YOUR_API_KEY
packs	是	string	URL 编码后的 JSON 数组；数组元素为 RouteFeaturePack 模型	%5B%7B...%7D%5D

请求体参数（POST）

请求体应为 RouteFeatureRequest 模型的JSON格式。

{
  "packs": [
    {
      "location": "点坐标，格式：lng,lat",
      "timestamp": "GPS 点采集时间，正数、秒级 Unix 时间戳"
    }
  ]
}

请求示例

GET

curl -X GET "https://lbs.xiaojukeji.com/api/v2/routefeature?key=YOUR_API_KEY&packs=%5B%7B%22location%22%3A%22113.953895%2C22.736234%22%2C%22timestamp%22%3A1789156040%7D%5D"

POST

curl -X POST "https://lbs.xiaojukeji.com/api/v2/routefeature?key=YOUR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "packs": [
      {
        "location": "113.953895,22.736234",
        "timestamp": 1789156040
      }
    ]
  }'

响应

成功响应为 RouteFeatureResponse 模型的 JSON 格式。

响应示例

{
  "status": 10000,
  "msg": "OK",
  "trace_id": "ac197cb96aaa61ff64803f4a5a1eacb0",
  "results": {
    "count": 1,
    "roads": [
      {
        "name": "茶林路",
        "type": "县道",
        "speed_limit": 40,
        "geo_list": "113.95387,22.73672;113.95385,22.73593"
      }
    ]
  }
}

错误处理

• packs 为空、坐标格式或范围非法、时间戳小于等于零、点数超过当前上限时，接口返回参数错误。
• 未匹配到道路时，接口成功返回，results.count 为 0，results.roads 为空数组。
• 道路匹配或道路特征服务异常时，接口返回统一的服务错误。可使用 trace_id 协助排查。