WebService API
    开发指南
示例中心
  • 更新日志
    • 常见问题
    WebService API
    开发指南
    路况查询

    概述

    路况查询服务提供查询轨迹所在道路的实时路况及3个月内历史路况的能力，支持返回道路名称、道路类型、路况速度与拥挤情况等信息。

    本服务主要特点：

    1. 分钟级路况更新，以1分钟更新1次的频率，确保用户获得的是最新的实时路况
    2. 支持查询过去3个月内历史路况
    3. 支持分段返回路况信息，对具体路段的拥堵情况进行评价，并对具体路段进行道路类型划分
    4. 路网覆盖率高，支持腾讯地图全部道路路况

    使用限制：

    ​     使用本接口需要与腾讯位置服务商务人员取得联系，开放权限后方可使用，点击提交工单。

    请求URL
    请求路径（URL） https://apis.map.qq.com/ws/traffic_status
    请求方式（Method） POST
    请求头 content-type:application/json

    请求参数（POST请求）

    参数 必填 说明 示例
    mode 是 路况模式，取值
    1：实时路况
    0：历史路况    		 “mode”:0
    timestamp 否
    （mode为0时，必填）    		 查询指定时间下的路况
    格式：Unix时间戳，支持3个月内任意时间
    当mode=1时，timestamp非必填
    当mode=0时，timestamp为必填    		 “timestamp”:1516183605
    track 是 查询路况的对应轨迹点串，本接口根据此轨迹串查询其所在道路，并获取路况信息。
    为保证响应效率和绑路效果，单次请求不超过300个点，建议不少于50个点
    格式：为一个二维数组，每一个子数组依次包括以下信息：
    1、纬度
    2、经度
    3、时间：用于绑路的轨迹时间戳，Unix时间戳，无时间戳信息填0
    [[ 纬度 , 经度 , 时间]，[ 纬度 , 经度 , 时间]，]    		 “track”: [[39.941528,116.310077,1618812438], [39.941076,116.310050,1618812446], [39.940348,116.310077,1618812457], [39.939710,116.310056,1618812462], [39.939200,116.310045,1618812474], [39.938888,116.309949,1618812485] …]
    key 是 开发key “key”:“YourKey”

    响应结果

    名称 类型 必有 说明
    status number 是 状态码，0为正常，其它为异常，详细请参阅状态码说明
    message string 是 状态说明
    data array 是 分段返回道路及路况信息，结构为二维数组
    每个子数组包含以下参数
    road_name string 是 当前道路名称，无名道路则值为空
    road_type string 是 当前道路类型，支持：
    1、高速
    2、城市快速路
    3、国道
    4、省道
    5、县道
    6、乡镇村道
    7、其他道路
    8、九级道路
    无法查询道路类型时值为空
    speed number 是 当前路况速度，速度为-1则表示无路况
    单位：千米/小时
    status number 是 路段拥堵评价，取值：
    0：畅行
    1：缓行
    2：拥堵
    3：极度拥堵
    4：无路况（大概率畅通）
    ponits_set string 是 道路经纬度点串 格式为：
    每组坐标间英文分号分隔，每组坐标内纬度在前，经度在后，英文逗号分隔
    无法匹配路段时值为空

    调用示例

    //请求体示例：
{
"key":"YourKey",
"mode": 0,
"timestamp": 1516183605,
"track": [ [39.941528,116.310077,1618812438], [39.941076,116.310050,1618812446],
           [39.940348,116.310077,1618812457], [39.939710,116.310056,1618812462],
           [39.939200,116.310045,1618812474], [39.938888,116.309949,1618812485], //…其它省略 ]
}

    //响应示例：
{
    "status": 0, 
    "message": "query ok",
    "request_id": "dbc66bb4a....", 
	"data": [ 
        ["三环","城市高速路",-1,3,"39.943122,116.310013;39.942408,116.310037....."],
        ["三环","城市高速路",-1,3,"39.939135,116.310043;39.938830,116.310046"]
    ]
}

    Postman示例

    发起请求

    响应结果

    本页内容