周边路况查询

GET

/traffic/v1/around

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://api.map.baidu.com/traffic/v1/around?center=39.912078,116.464303&radius=200&ak=&sn='

响应示例

{
    "status": 0, 
    "message": "成功", 
    "description": "该区域整体拥堵。京包高速：北向南,从开拓路5到京新高速拥堵。京新上地桥：北向南,京新上地桥拥堵。京新高速：北向南,从京包高速到耳通百安拥堵。小营西路：西向东,上地三街附近拥堵。", 
    "evaluation": {
        "status": 3, 
        "status_desc": "拥堵"
    }, 
    "road_traffic": [
        {
            "road_name": "UNKNOW"
        }, 
        {
            "road_name": "上地三街"
        }, 
        {
            "road_name": "上地三街辅路"
        }, 
        {
            "road_name": "上地东路"
        }, 
        {
            "road_name": "上地五街"
        }, 
        {
            "road_name": "上地六街"
        }, 
        {
            "road_name": "上地四街"
        }, 
        {
            "congestion_sections": [
                {
                    "congestion_distance": 1870, 
                    "speed": 8.45, 
                    "status": 3, 
                    "congestion_trend": "持平", 
                    "section_desc": "北向南,从开拓路5到京新高速", 
                }
            ], 
            "road_name": "京包高速"
        }, 
        {
            "congestion_sections": [
                {
                    "congestion_distance": 1610, 
                    "speed": 7.79, 
                    "status": 3, 
                    "congestion_trend": "持平", 
                    "section_desc": "北向南,京新上地桥", 
                }
            ], 
            "road_name": "京新上地桥"
        }, 
        {
            "congestion_sections": [
                {
                    "congestion_distance": 1870, 
                    "speed": 8.45, 
                    "status": 3, 
                    "congestion_trend": "持平", 
                    "section_desc": "北向南,从京包高速到耳通百安", 
                }
            ], 
            "road_name": "京新高速"
        }, 
        {
            "road_name": "信息路"
        }, 
        {
            "road_name": "创业路"
        }, 
        {
            "road_name": "安宁庄西一条"
        }, 
        {
            "road_name": "安宁庄西三条"
        }, 
        {
            "road_name": "安宁庄西二条"
        }, 
        {
            "road_name": "安宁庄路"
        }, 
        {
            "congestion_sections": [
                {
                    "congestion_distance": 760, 
                    "speed": 6.39, 
                    "status": 3, 
                    "congestion_trend": "加重", 
                    "section_desc": "西向东,上地三街附近", 
                }
            ], 
            "road_name": "小营西路"
        }, 
        {
            "road_name": "小营西路辅路"
        }, 
        {
            "road_name": "开拓路"
        }
    ]
}

请求参数

Query 参数

center

string

必需

中心点坐标；示例：center=39.912078,116.464303

示例值:

39.912078,116.464303

radius

string

必需

查询半径；单位：米，取值范围[1,1000] 示例： radius=200

示例值:

200

coord_type_input

string

可选

请求参数 bounds的坐标类型；默认值：bd09ll 取值范围： bd09ll：百度经纬度坐标 gcj02：国测局加密坐标 wgs84：gps 坐标

示例值:

gcj02

coord_type_output

string

可选

返回结果的坐标类型；默认值：bd09ll 该字段用于控制返回结果中坐标的类型。可选值为： bd09ll：百度经纬度坐标 gcj02：国测局加密坐标

示例值:

gcj02

road_grade

string

可选

道路等级；用户可进行道路等级筛选，支持选择多个道路等级。道路等级之间使用英文“,”分隔。默认值：road_grade=0 道路等级对应表如下： 0：全部驾车道路 1：高速路 2：环路及快速路 3：主干路 4：次干路 5：支干路示例：查询全部驾车道路路况：road_grade:0 查询高速道路路况：road_grade:1 查询高速路、环路及快速路、主干路的路况：road_grade=1,2,3

string

必需

开发者的访问密钥，必填项。v2之前该属性为key。申请秘钥

默认值:

string

可选

可选，若开发者所用AK的校验方式为SN校验时该参数必须。

默认值:

返回响应

🟢200成功

application/json

Body

status

integer

必需

状态码；本次API访问状态，如果成功返回0，如果失败返回其他数字。

message

string

必需

响应信息；对status的中文描述

description

string

必需

路况语义化描述；组成规则：整体拥堵情况概述+拥堵路段。示例："该区域整体拥堵。京包高速：北向南,从开拓路5到京新高速拥堵。京新上地桥：北向南,京新上地桥拥堵。京新高速：北向南,从京包高速到耳通百安拥堵。小营西路：西向东,上地三街附近拥堵。"

evaluation

object

路况整体评估

必需

status

integer

必需

路况整体评价；支持以下值：0：未知路况1：畅通2：缓行3：拥堵4：严重拥堵

status_desc

string

必需

路况整体评价的语义化描述；道路的整体拥堵评价，较status更为细致，分为：畅通、较为畅通、缓行、轻微拥堵、拥堵、严重拥堵

road_traffic

object

路况详细信息

必需

road_name

string

道路名称

必需

congestion_sections

object

必需

拥堵路段详情；若道路上有拥堵路段，则返回该字段。若无拥堵路段，则不返回该字段注意：拥堵路段是依据拥堵情况、车流量、拥堵距离等因素综合计算得到，并不完全参考拥堵情况

修改于 2022-08-22 02:56:04

多边形区域路况查询

服务介绍