限行查询接口

限行查询接口
限行查询产品特色

1、车牌限行:不仅包含基础性描述内容,还有首创的“限行区域图片”、“限行区域矢量”
     等特色字段,满足不同产品的使用需求。

     事件限行:提供突发事件(重大赛事、会议、天气、临时交通管制等)临时交通管制信息。

2、覆盖城市全,提供车牌限行以及发生事件限行的所有城市限行数据。

3、限行数据更新快、实时发布。


接口地址:https://xianxing.loopon.cn/api/v1/trafficlimit/number/getCityList

支持格式:json

请求方法:get

请求示例:https://xianxing.loopon.cn/api/v1/trafficlimit/number/getCityList?apikey=******

请求参数:

参数名称 类型 必填 说明
apikey String Y 请求服务的密钥
all int N 是否返回所有的城市列表:
1表示返回所有的城市列表。
0表示只返回限行日期有效的城市列表。
默认为0。

返回参数:

参数名称 类型 说明
rspcode Int 结果状态
data List
city String 城市代号
cityname String 城市名称
districts List 下一级限行的区县城市列表, 如果没有,则为空
districtcode String 区县城市代号
districtname String 区县城市名称

Json返回示例:


1、获取城市列表

接口地址:https://xianxing.loopon.cn/api/v1/trafficlimit/event/getCityList

支持格式:json

请求方法:get

请求示例:https://xianxing.loopon.cn/api/v1/trafficlimit/event/getCityList?apikey=******

请求参数:

参数名称 类型 必填 说明
apikey String Y 请求服务的密钥

返回参数:

参数名称 类型 说明
rspcode Int 结果状态, 20000表示成功
data Array 返回城市列表
city string 城市code
cityname string 城市名称
districts List 下一级限行的区县城市列表, 如果没有,则为空
districtcode String 区县城市代号
districtname String 区县城市名称

Json返回示例:

2、限行信息

接口地址:https://xianxing.loopon.cn/api/v1/trafficlimit/event/getCityLimit

支持格式:json

请求方法:get

请求示例:https://xianxing.loopon.cn/api/v1/trafficlimit/event/getCityLimit?apikey=****-*-**&city=*****[&date=****-**-**]

请求参数:

参数名称 类型 必填 说明
city String Y 表示在接口1中获取的内容,如110000
apikey String Y 申请的apikey
date String N 可选参数,时间参数。填写这个参数,表示要获取填写时间的限行信息

返回参数:

参数名称 类型 说明
rspcode Int 错误代码20000表示成功
data Array 返回事件限行信息
id Int 限行事件ID
cityname string 城市名称
title string 事件名称
time string 限行时间段
sunmary string 概述说明
detail string 详细描述
links string 限行链接

Json返回示例:


接口地址:https://xianxing.loopon.cn/api/v2/trafficlimit/vehicle

支持格式:json

请求方法:get

请求示例:https://xianxing.loopon.cn/api/v2/trafficlimit/vehicle?longitude=******&latitude=******&plate_number=******&apikey=******

请求参数:

参数名称 类型 必填 说明
apikey String Y 请求服务的密钥
longitude Double Y 经度
latitude Double Y 纬度
plate_number String Y 车牌号
date String N 要查询的日期,如果省略,默认为当天
time String N 要查询的时间。
如果省略,默认为所有时间。
1表示使用当前时间查询。
hh:mm:ss格式, 指定具体要查询的时间。
geom Int N 返回几何形状,0或者不填写,表示不返回几何形状点信息。
1表示返回几何形状点信息。
by_area Int N 是否按照限行区域来获取限行信息。

0表示根据指定的经纬度对应点所在的城市来获取限行信息

1表示根据指定的经纬度对应点所在的具体限行区域来获取限行信息

缺省值为1
distance Int N 当by_area为1时,用于指定经纬度对应点所在的范围值。

单位为米,范围为1-100000

当不填写时,根据该点是否在限行区域内来获取限行信息。

当指定一个范围值时,根据指定的经纬度为圆心,以该范围值为半径所构成的一个圆范围是否和限行区域相交来获取限行信息。
show_nolimit Int N 当某一限行规则经系统判断为不限行时,是否返回不限行的具体规则信息:
1表示返回不限行的具体规则信息。
0表示不返回,只返回"result":0这样的结果。
默认为0。

返回参数:

参数名称 类型 说明
rspcode Int 响应代码, 20000为执行成功。
data Array 返回的具体限行信息,为一数组,包含有多条限行规则
result Int 限行结果,1为限行,0为不限行
type Int 限行规则类型,0 为事件限行,1 为车牌尾号限行
id Int 当type为0时, 这个字段是限行事件ID.
当type为1时,这个字段是限行规则ID.
title String 事件限行的标题,仅为事件限行规则有,车牌尾号限行没有这个字段
time Array 限行时间,为一数组,每一项包含起始时间和终止时间, 如果数组为空,表示全天限行。
number String 限行尾号,如果有多个尾号,则以半角逗号间隔, 如3,5。
当rtype是1,2,3,4,11时,这个字段才有值,rtype为其他值时,该字段为空。
area String 限行区域
rule String 限行规则内容
rtype Int 限行类型
1: 日期
2: 星期
3: 日期单双号
4: 休息日单双号限行
5: 开四停四
6: 景区限行
7: 特殊号牌
8: 时间累积
9: 所有号牌-单一路段
10: 所有号牌-区域
11: 日期含尾号限行
12: 区域号牌
ptype Int 车牌归属地类型
1: 本地
2: 外地
3: 本地+外地
ntype Int 当某条规则经系统判断为不限行时,且show_nolimit为1时,该字段表示具体的不限行原因类型:

1: 该规则不在限行时间段内
2: 该规则工作日不限行
3: 该规则调休日不限行
4: 该规则在节假日不限行
5: 该规则在周末不限行
6: 该规则在31号不限行
7: 该车牌号不在限行尾号内
8: 该车辆在开四停四规则下,属于可以行驶状态
9: 该规则处于暂停状态,不限行
40: 找不到有效规则
holiday_titles Array 当某条规则不限行时,当show_nolimit为1且ntype为4时,该字段表示节假日的名称,为一字符串数组,当没有名称时,为空。
geoinfo Array 限行区域矢量,当geom请求参数设为1时才有,且仅为限行规则才有
geo Array 形状点坐标
x Double 经度(单位:度)
y Double 纬度(单位:度)
info Array 限行信息
isrestrict bool 是否限行
shapetype Int 要素类型
0:线
1:面
2:面+线

Json返回示例:


接口地址:https://xianxing.loopon.cn/api/v2/trafficlimit/city

支持格式:json

请求方法:get

请求示例:https://xianxing.loopon.cn/api/v2/trafficlimit/city?admin_code=******&plate_number=******&apikey=******

请求参数:

参数名称 类型 必填 说明
apikey String Y 请求服务的密钥
admin_code String Y 城市行政区代码
plate_number String Y 车牌号
date String N 要查询的日期,如果省略,默认为当天
time String N 要查询的时间。
如果省略,默认为所有时间。
1表示使用当前时间查询。
hh:mm:ss格式, 指定具体要查询的时间。
days Int N 要查询的天数,如果省略,默认为7天。范围为1到40天
geom Int N 返回几何形状,0或者不填写,表示不返回几何形状点信息。
1表示返回几何形状点信息。
all Int N 当admin_code指定的城市为市级行政区时:
1表示返回下一级的所有区县级城市的限行信息。
0表示只返回admin_code所指定城市的限行信息。
默认为1。
show_nolimit Int N 当某一限行规则经系统判断为不限行时,是否返回不限行的具体规则信息:
1表示返回不限行的具体规则信息。
0表示不返回,只返回"result":0这样的结果。
默认为0。
vehicle_status String N 当某城市的限行规则为开四停四时,该字段用于指定最近8天的车辆行驶状态,系统使用该信息进行开四停四规则的判断。

内容为一个8个长度的,只包含0,1的字符串。0代表该车辆在admin_code指定的城市处于停驶状态,1代表行驶状态。

从左到右依次表示前第8天,前第7天, ... , 前第1天的行驶状态。
比如10001001表示前第8天为行驶, 前第4天为行驶,前第1天为行驶,其余为停驶状态。

另外如果某日是节假日或不限行的事件(这一信息可通过api/v2/trafficlimit/events获得), 则该日 不限行。如果该日在前8天内,处于已经行驶的状态,但该日是节假日,则状态为停驶。

比如vehicle_status为10000001, 如果前1天是节假日,则vehicle_status将被置为10000000,则开四停四规则将根据 10000000进行判断。

返回参数:

参数名称 类型 说明
rspcode Int 响应代码, 20000为执行成功。
data Array 返回的具体限行信息,为一数组,包含有每天的限行规则。
date String 日期
limit Array date 所指定日期的限行规则,为一数组,包含有相应日期的限行规则。
result Int 限行结果,1为限行,0为不限行
type Int 限行规则类型,0 为事件限行,1 为车牌尾号限行
id Int 当type为0时, 这个字段是限行事件ID.
当type为1时,这个字段是限行规则ID.
title String 事件限行的标题,仅为事件限行规则有,车牌尾号限行没有这个字段
date Array 事件限行的起始和终止日期,仅为事件限行规则有,车牌尾号限行没有这个字段。
值为一数组,第一项是起始日期,第二项是终止日期
time Array 限行时间,为一数组,每一项包含起始时间和终止时间, 如果数组为空,表示全天限行。
number String 限行尾号,如果有多个尾号,则以半角逗号间隔, 如3,5。
当rtype是1,2,3,4,11时,这个字段才有值,rtype为其他值时,该字段为空。
area String 限行区域
rule String 限行规则内容
rtype Int 限行类型
1: 日期
2: 星期
3: 日期单双号
4: 休息日单双号限行
5: 开四停四
6: 景区限行
7: 特殊号牌
8: 时间累积
9: 所有号牌-单一路段
10: 所有号牌-区域
11: 日期含尾号限行
12: 区域号牌
ptype Int 车牌归属地类型
1: 本地
2: 外地
3: 本地+外地
ntype Int 当某条规则经系统判断为不限行时,且show_nolimit为1时,该字段表示具体的不限行原因类型:

1: 该规则不在限行时间段内
2: 该规则工作日不限行
3: 该规则调休日不限行
4: 该规则在节假日不限行
5: 该规则在周末不限行
6: 该规则在31号不限行
7: 该车牌号不在限行尾号内
8: 该车辆在开四停四规则下,属于可以行驶状态
9: 该规则处于暂停状态,不限行
40: 找不到有效规则
holiday_titles Array 当某条规则不限行时,当show_nolimit为1且ntype为4时,该字段表示节假日的名称,为一字符串数组,当没有名称时,为空。
geoinfo Array 限行区域矢量,当geom请求参数设为1时才有,且仅为限行规则才有
geo Array 形状点坐标
x Double 经度(单位:度)
y Double 纬度(单位:度)
info Array 限行信息
isrestrict Bool 是否限行
shapetype Int 要素类型
0:线
1:面
2:面+线

Json返回示例:


接口地址:https://xianxing.loopon.cn/api/v2/trafficlimit/location

支持格式:json

请求方法:get

请求示例:https://xianxing.loopon.cn/api/v2/trafficlimit/location?longitude=******&latitude=******&apikey=******

请求参数:

参数名称 类型 必填 说明
apikey String Y 请求服务的密钥
longitude Double Y 经度
latitude Double Y 纬度
date String N 要查询的日期,如果省略,默认为当天
geom Int N 返回几何形状,0或者不填写,表示不返回几何形状点信息。
1表示返回几何形状点信息。
by_area Int N 是否按照限行区域来获取限行信息。

0表示根据指定的经纬度对应点所在的城市来获取限行信息

1表示根据指定的经纬度对应点所在的具体限行区域来获取限行信息

缺省值为1
distance Int N 当by_area为1时,用于指定经纬度对应点所在的范围值。

单位为米,范围为1-100000

当不填写时,根据该点是否在限行区域内来获取限行信息。

当指定一个范围值时,根据指定的经纬度为圆心,以该范围值为半径所构成的一个圆范围是否和限行区域相交来获取限行信息。

返回参数:

参数名称 类型 说明
rspcode Int 响应代码, 20000为执行成功。
data Hash 返回的具体限行信息
result Int 限行结果,1为限行,0为不限行
localcar List 本地车规定
id Int 限行规则ID
date String 日期
rtype Int 限行类型
1: 日期
2: 星期
3: 日期单双号
4: 休息日单双号限行
5: 开四停四
6: 景区限行
7: 特殊号牌
8: 时间累积
9: 所有号牌-单一路段
10: 所有号牌-区域
11: 日期含尾号限行
12: 区域号牌
time String 限行时间(分号分隔 07:30-09:30;17:00-19:00)
空:00:00-24:00
number String 限制尾号
显示当天限行尾号
rule String 限行规定
area String 限行区域
detail String 限行详细描述
geoinfo List 限行区域矢量
geo List 形状点坐标
x Double 经度(单位:度)
y Double 纬度(单位:度)
info List 限行信息
isrestrict bool 是否限行
shapetype int 要素类型
0:线
1:面
2:面+线
foreigncar List 外地车规定
id Int 限行规则ID
date String 日期
rtype Int 限行类型
1: 日期
2: 星期
3: 日期单双号
4: 休息日单双号限行
5: 开四停四
6: 景区限行
7: 特殊号牌
8: 时间累积
9: 所有号牌-单一路段
10: 所有号牌-区域
11: 日期含尾号限行
12: 区域号牌
time String 限行时间(分号分隔 07:30-09:30;17:00-19:00)
空:00:00-24:00
number String 限制尾号
显示当天限行尾号
rule String 限行规定
area String 限行区域
detail String 限行详细描述
geoinfo List 限行区域矢量
geo List 形状点坐标
x Double 经度(单位:度)
y Double 纬度(单位:度)
info List 限行信息
isrestrict bool 是否限行
shapetype int 要素类型
0:线
1:面
2:面+线
allcars List 本地车及外地车规定
id Int 限行规则ID
date String 日期
rtype Int 限行类型
1: 日期
2: 星期
3: 日期单双号
4: 休息日单双号限行
5: 开四停四
6: 景区限行
7: 特殊号牌
8: 时间累积
9: 所有号牌-单一路段
10: 所有号牌-区域
11: 日期含尾号限行
12: 区域号牌
time String 限行时间(分号分隔 07:30-09:30;17:00-19:00)
空:00:00-24:00
number String 限制尾号
显示当天限行尾号
rule String 限行规定
area String 限行区域
detail String 限行详细描述
geoinfo List 限行区域矢量
geo List 形状点坐标
x Double 经度(单位:度)
y Double 纬度(单位:度)
info List 限行信息
isrestrict bool 是否限行
shapetype int 要素类型
0:线
1:面
2:面+线

Json返回示例:

1. 当该位置不限行时:

2. 当该位置限行时:


接口地址:https://xianxing.loopon.cn/api/v2/trafficlimit/events

支持格式:json

请求方法:get

请求示例:https://xianxing.loopon.cn/api/v2/trafficlimit/events?admin_code=******&apikey=******

使用说明:该Api主要用于一些开四停四限行规则的城市使用,这个不限行事件的信息将影响开四停四规则的判断。

请求参数:

参数名称 类型 必填 说明
apikey String Y 请求服务的密钥
admin_code String Y 城市行政区代码
date String N 要查询的日期,如果省略,默认为当天
days Int N 要查询的天数,如果省略,默认为8天。范围为1到40天

返回参数:

参数名称 类型 说明
rspcode Int 响应代码, 20000为执行成功。
data Array 返回的具体信息,为一数组,包含有每天的不限行事件。
date String 日期
events Array date 所指定日期的不限行事件名称,
如果该日期没有不限行事件,则events为空。

Json返回示例:


接口地址:https://xianxing.loopon.cn/api/v4/nevlimit/getCityLimit

支持格式:json

请求方法:get

请求示例:https://xianxing.loopon.cn/api/v4/nevlimit/getCityLimit?apikey=******&city=******

请求参数:

参数名称 类型 必填 说明
apikey String Y 请求服务的密钥
city String Y 城市代号
date String N 要查询的日期,如果省略,默认为当天。
days Int N 要查询的天数,如果省略,默认为7天。范围为1到40天
date_check Int N 日期检查模式:
1: 返回date指定的日期在有效期内的限行规则。
2: 返回有效期的截止日期大于date指定日期的限行规则。
缺省为1。
geom int N 0或者不填写,表示不返回几何形状点信息。
1表示返回几何形状点信息。
all int N 当city指定的城市为市级行政区时:
1表示返回下一级的所有区县级城市的限行信息。
0表示只返回city所指定城市的限行信息。
默认为1。

返回参数:

参数名称 类型 说明
rspcode Int 结果状态
cityname string 城市名称
localcar List 本地车规定
id Int 限行规则ID
date String 日期
week String 星期
type String 限行类型
日期限行
星期限行
日期单双号限行
休息日单双号限行
开四停四
景区限行
特殊号牌
时间累积
所有号牌-单一路段
所有号牌-区域
日期含尾号限行
区域号牌
range String 有效期(分号分隔。
20150310-20150810;20160310-20160810
缺省为空,表达每天)
time String 限行时间(分号分隔 07:30-09:30;17:00-19:00)
空:00:00-24:00
number String 限制尾号
显示当天及其后连续一周限行尾号
engnumber String 英文尾号车牌限行规定
按“0”处理
按“4”处理
最后一位数字
只对英文结尾车牌限行
不对英文结尾车牌限行
holiday String 法定节假日是否限行
不限行
限行
workday String 工作日是否限行
不限行
限行
weekend String 周末是否限行
不限行
限行
area String 限行区域
summary String 限行规定
detail String 限行详细描述
status Int 限行规则的状态:
1: 表示该限行规则已暂停。
2: 表示该限行规则处于正常状态。
powertypes List 新能源车的动力类型,为一列表, 如[1, 2]:
1: 纯电动汽车。
2: 混合动力电动汽车。
geoinfo List 限行区域矢量
geo List 形状点坐标
x Double 经度(单位:度)
y Double 纬度(单位:度)
info List 限行信息
isrestrict bool 是否限行
shapetype int 要素类型
0:线
1:面
2:面+线
foreigncar List 外地车规定
id Int 限行规则ID
date String 日期
week String 星期
type String 限行类型
日期限行
星期限行
日期单双号限行
休息日单双号限行
开四停四
景区限行
特殊号牌
时间累积
所有号牌-单一路段
所有号牌-区域
日期含尾号限行
区域号牌
range String 有效期(分号分隔。
20150310-20150810;20160310-20160810
缺省为空,表达每天)
time String 限行时间(分号分隔 07:30-09:30;17:00-19:00)
空:00:00-24:00
number String 限制尾号
显示当天及其后连续一周限行尾号
engnumber String 英文尾号车牌限行规定
按“0”处理
按“4”处理
最后一位数字
只对英文结尾车牌限行
不对英文结尾车牌限行
holiday String 法定节假日是否限行
不限行
限行
workday String 工作日是否限行
不限行
限行
weekend String 周末是否限行
不限行
限行
area String 限行区域
summary String 限行规定
detail String 限行详细描述
status Int 限行规则的状态:
1: 表示该限行规则已暂停。
2: 表示该限行规则处于正常状态。
powertypes List 新能源车的动力类型,为一列表, 如[1, 2]:
1: 纯电动汽车。
2: 混合动力电动汽车。
geoinfo List 限行区域矢量
geo List 形状点坐标
x Double 经度(单位:度)
y Double 纬度(单位:度)
info List 限行信息
isrestrict bool 是否限行
shapetype String 要素类型
0:线
1:面
2:面+线
allcars List 本地车及外地车规定
id Int 限行规则ID
date String 日期
week String 星期
type String 限行类型
日期限行
星期限行
日期单双号限行
休息日单双号限行
开四停四
景区限行
特殊号牌
时间累积
所有号牌-单一路段
所有号牌-区域
日期含尾号限行
区域号牌
range String 有效期(分号分隔。
20150310-20150810;20160310-20160810
缺省为空,表达每天)
time String 限行时间(分号分隔 07:30-09:30;17:00-19:00)
空:00:00-24:00
number String 限制尾号
显示当天及其后连续一周限行尾号
engnumber String 英文尾号车牌限行规定
按“0”处理
按“4”处理
最后一位数字
只对英文结尾车牌限行
不对英文结尾车牌限行
holiday String 法定节假日是否限行
不限行
限行
workday String 工作日是否限行
不限行
限行
weekend String 周末是否限行
不限行
限行
area String 限行区域
summary String 限行规定
detail String 限行详细描述
status Int 限行规则的状态:
1: 表示该限行规则已暂停。
2: 表示该限行规则处于正常状态。
powertypes List 新能源车的动力类型,为一列表, 如[1, 2]:
1: 纯电动汽车。
2: 混合动力电动汽车。
geoinfo List 限行区域矢量
geo List 形状点坐标
x Double 经度(单位:度)
y Double 纬度(单位:度)
info List 限行信息
isrestrict bool 是否限行
shapetype String 要素类型
0:线
1:面
2:面+线

Json返回示例:


接口地址:https://xianxing.loopon.cn/api/access_info

支持格式:json

请求方法:get

请求示例:https://xianxing.loopon.cn/api/access_info?apikey=******

请求参数:

参数名称 类型 必填 说明
apikey String Y 请求服务的密钥

返回参数:

参数名称 类型 说明
rspcode Int 结果状态
data 为一object类型 具体的数据内容
quota Int 该apikey的调用额度,单位为次数
count Int 已经发生的api调用次数

Json返回示例:


错误码参照说明:

错误码 说明
10001 没有指定Api key
10002 Api key无效
10003 apikey对应的不是该接口
10005 该Api调用缺少必须的参数
10006 Geocode结果无效
10007 Geocode服务不可用
10008 该城市缺少本地车牌号数据
10009 该条规则数据错误
10010 该Api的参数值不在有效范围内
10011 该Api的参数值无效
10012 该Api key不在有效期内
10013 该Api key不能用于调用该服务
10014 该Api key已经超过使用额度
10201 城市参数错误
10202 没找到该城市的数据
10203 日期参数错误
20000 正常