接入指南

接入API,有以下必要步骤:

  • 申请合法APIkey
  • 获取必要的接入信息
  • 开始集成
申请密钥
按需求设置传参(示例)
接口地址:https://xianxing.loopon.cn/api/v1/trafficlimit/number/getCityList
支持格式:json
请求方法:get
请求示例:https://xianxing.loopon.cn/api/v1/trafficlimit/number/getCityList?apikey=******
请求参数:
参数名称类型必填说明
apikeyStringY请求服务的密钥
allIntN
请求服务的密钥
1表示返回所有的城市列表。
0表示只返回限行日期有效的城市列表。
默认为0。
获取必要的返回信息
返回参数:
参数名称类型说明
rspCodeInt结果状态
dataArray返回城市列表
cityString城市代号
citynameString城市名称
districtsArray下一级限行区县的城市列表,如果没有,则为空
districtCodeString区县城市代号
districtNameString区县城市名称
返回示例:
复制代码
定时同步数据
路帮数据为实时更新,请根据产品需求定时获取最新数据。
响应代码含义
代码含义
20000API调用成功
10001没有指定Api key
10002Api key无效
10003apikey对应的不是该接口
10005该Api调用缺少必须的参数
10006Geocode结果无效
10007Geocode服务不可用
10008该城市缺少本地车牌号数据
10009该条规则数据错误
10010该Api的参数值不在有效范围内
10011该Api的参数值无效
10012该Api key不在有效期内
10013该Api key不能用于调用该服务
10014该Api key已经超过使用额度
10201城市参数错误
10202没找到该城市的数据
10203日期参数错误
查询全国限行城市
接口地址:https://xianxing.loopon.cn/api/v1/trafficlimit/number/getCityList
支持格式:json
请求方法:get
请求示例:https://xianxing.loopon.cn/api/v1/trafficlimit/number/getCityList?apikey=******
请求参数:
参数名称类型必填说明
apikeyStringY请求服务的密钥
allIntN
请求服务的密钥
1表示返回所有的城市列表。
0表示只返回限行日期有效的城市列表。
默认为0。
返回参数:
参数名称类型说明
rspCodeInt结果状态
dataArray返回城市列表
cityString城市代号
citynameString城市名称
districtsArray下一级限行区县的城市列表,如果没有,则为空
districtCodeString区县城市代号
districtNameString区县城市名称
Json返回示例:
复制代码
查询城市限行规则
接口地址:https://xianxing.loopon.cn/api/v1/trafficlimit/number/getCityLimit
支持格式:json
请求方法:get
请求示例:https://xianxing.loopon.cn/api/v1/trafficlimit/number/getCityLimit?apikey=******&city=******
请求参数:
参数名称类型必填说明
apikeyStringY请求服务的密钥
cityStringY城市代号
dateStringN要查询的日期,如果省略,默认为当天。
daysIntN 要查询的天数,如果省略,默认为7天。范围为1到40天
date_checkIntN
日期检查模式:
1: 返回date指定的日期在有效期内的限行规则。
2: 返回有效期的截止日期大于date指定日期的限行规则。
缺省为1。
geomIntN
0或者不填写,表示不返回几何形状点信息。
1表示返回几何形状点信息。
allIntN
当city指定的城市为市级行政区时:
1表示返回下一级的所有区县级城市的限行信息。
0表示只返回city所指定城市的限行信息。
默认为1。
返回参数:
参数名称类型说明
rspCodeInt结果状态
citynameString城市名称
localcarArray
本地车规定(Array每一项见下方说明
foreigncarArray
外地车规定(Array每一项见下方说明
allcarsArray
本地车及外地车规定(Array每一项见下方说明
本地车规定:
参数名称类型说明
idInt限行规则ID
dateString日期
weekString星期
typeString
限行类型
日期限行
星期限行
日期单双号限行
休息日单双号限行
开四停四
景区限行
特殊号牌
时间累积
所有号牌-单一路段
所有号牌-区域
日期含尾号限行
区域号牌
rangeString
有效期(分号分隔)
例如: 20150310-20150810;20160310-20160810
缺省为空,表达每天
timeString
限行时间(分号分隔)
例如: 07:30-09:30;17:00-19:00
为空:00:00-24:00
numberString
限制尾号
显示当天及其后连续一周限行尾号
engnumberString
英文尾号车牌限行规定:
按“0”处理;
按“4”处理;
最后一位数字;
只对英文结尾车牌限行;
不对英文结尾车牌限行
holidayString
法定节假日是否限行:
不限行;
限行
workdayString
工作日是否限行:
不限行;
限行
weekendString
周末是否限行:
不限行;
限行
areaString限行区域
summaryString限行规定
detailString限行详细描述
statusInt
限行规则的状态:
1: 表示该限行规则已暂停。
2: 表示该限行规则处于正常状态。
bigimageIntpc端限行区域图片
smallimageInt移动端限行区域图片
geoinfoArray
限行区域矢量 (详见geoinfo说明
外地车规定:
参数名称类型说明
idInt限行规则ID
dateString日期
weekString星期
typeString
限行类型
日期限行
星期限行
日期单双号限行
休息日单双号限行
开四停四
景区限行
特殊号牌
时间累积
所有号牌-单一路段
所有号牌-区域
日期含尾号限行
区域号牌
rangeString
有效期(分号分隔)
例如: 20150310-20150810;20160310-20160810
缺省为空,表达每天
timeString
限行时间(分号分隔)
例如: 07:30-09:30;17:00-19:00
为空:00:00-24:00
numberString
限制尾号
显示当天及其后连续一周限行尾号
engnumberString
英文尾号车牌限行规定:
按“0”处理;
按“4”处理;
最后一位数字;
只对英文结尾车牌限行;
不对英文结尾车牌限行
holidayString
法定节假日是否限行:
不限行;
限行
workdayString
工作日是否限行:
不限行;
限行
weekendString
周末是否限行:
不限行;
限行
areaString限行区域
summaryString限行规定
detailString限行详细描述
statusInt
限行规则的状态:
1: 表示该限行规则已暂停。
2: 表示该限行规则处于正常状态。
bigimageIntpc端限行区域图片
smallimageInt移动端限行区域图片
geoinfoArray
限行区域矢量 (详见geoinfo说明
本地车及外地车规定:
参数名称类型说明
idInt限行规则ID
dateString日期
weekString星期
typeString
限行类型
日期限行
星期限行
日期单双号限行
休息日单双号限行
开四停四
景区限行
特殊号牌
时间累积
所有号牌-单一路段
所有号牌-区域
日期含尾号限行
区域号牌
rangeString
有效期(分号分隔)
例如: 20150310-20150810;20160310-20160810
缺省为空,表达每天
timeString
限行时间(分号分隔)
例如: 07:30-09:30;17:00-19:00
为空:00:00-24:00
numberString
限制尾号
显示当天及其后连续一周限行尾号
engnumberString
英文尾号车牌限行规定:
按“0”处理;
按“4”处理;
最后一位数字;
只对英文结尾车牌限行;
不对英文结尾车牌限行
holidayString
法定节假日是否限行:
不限行;
限行
workdayString
工作日是否限行:
不限行;
限行
weekendString
周末是否限行:
不限行;
限行
areaString限行区域
summaryString限行规定
detailString限行详细描述
statusInt
限行规则的状态:
1: 表示该限行规则已暂停。
2: 表示该限行规则处于正常状态。
bigimageIntpc端限行区域图片
smallimageInt移动端限行区域图片
geoinfoArray
限行区域矢量 (详见geoinfo说明
geoinfo说明:
参数名称类型说明
geoArray形状点坐标
infoArray限行信息
Json返回示例:
复制代码
经纬度和车牌号限行查询
接口地址:https://xianxing.loopon.cn/api/v2/trafficlimit/vehicle
支持格式:json
请求方法:get
请求示例:https://xianxing.loopon.cn/api/v2/trafficlimit/vehicle?longitude=******&latitude=******&plate_number=******&apikey=******
请求参数:
参数名称类型必填说明
apikeyStringY请求服务的密钥
longitudeDoubleY经度
latitudeDoubleY纬度
plate_numberStringY车牌号
dateStringN要查询的日期,如果省略,默认为当天
timeStringN
要查询的时间。
如果省略,默认为所有时间。
1表示使用当前时间查询。
hh:mm:ss格式, 指定具体要查询的时间。
geomIntN
返回几何形状:
0或者不填写,表示不返回几何形状点信息。
1表示返回几何形状点信息。
by_areaIntN
是否按照限行区域来获取限行信息。
0表示根据指定的经纬度对应点所在的城市来获取限行信息
1表示根据指定的经纬度对应点所在的具体限行区域来获取限行信息
缺省值为1
distanceIntN
当by_area为1时,用于指定经纬度对应点所在的范围值。

单位为米,范围为1-100000

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

当指定一个范围值时,根据指定的经纬度为圆心,以该范围值为半径所构成的一个圆范围是否和限行区域相交来获取限行信息。
show_nolimitIntN
当某一限行规则经系统判断为不限行时,是否返回不限行的具体规则信息:
1表示返回不限行的具体规则信息。
0表示不返回,只返回"result":0这样的结果。
默认为0。
返回参数:
参数名称类型说明
rspCodeInt结果状态
dataArray返回的具体限行信息,为一数组,包含有多条限行规则(详细内容见下表)
data说明:
参数名称类型说明
resultInt限行结果,1为限行,0为不限行
typeInt限行规则类型,0 为事件限行,1 为车牌尾号限行
idInt
当type为0时, 这个字段是限行事件ID.
当type为1时,这个字段是限行规则ID.
titleString事件限行的标题,仅为事件限行规则有,车牌尾号限行没有这个字段
timeArray限行时间,为一数组,每一项包含起始时间和终止时间, 如果数组为空,表示全天限行。
numberString限行尾号,如果有多个尾号,则以半角逗号间隔, 如3,5。 当rtype是1,2,3,4,11时,这个字段才有值,rtype为其他值时,该字段为空。
areaString限行区域
ruleString限行规则内容
rtypeInt
限行类型
1: 日期
2: 星期
3: 日期单双号
4: 休息日单双号限行
5: 开四停四
6: 景区限行
7: 特殊号牌
8: 时间累积
9: 所有号牌-单一路段
10: 所有号牌-区域
11: 日期含尾号限行
12: 区域号牌
ptypeInt
车牌归属地类型
1: 本地
2: 外地
3: 本地+外地
ntypeInt
当某条规则经系统判断为不限行时,且show_nolimit为1时,该字段表示具体的不限行原因类型:
1: 该规则不在限行时间段内
2: 该规则工作日不限行
3: 该规则调休日不限行
4: 该规则在节假日不限行
5: 该规则在周末不限行
6: 该规则在31号不限行
7: 该车牌号不在限行尾号内
8: 该车辆在开四停四规则下,属于可以行驶状态
9: 该规则处于暂停状态,不限行
40: 找不到有效规则
holiday_titlesArray当某条规则不限行时,当show_nolimit为1且ntype为4时,该字段表示节假日的名称,为一字符串数组,当没有名称时,为空。
geoinfoArray
限行区域矢量,当geom请求参数设为1时才有,且仅为限行规则才有 (详见geoinfo说明
Json返回示例:
复制代码
车牌号在某城市内限行查询
接口地址:https://xianxing.loopon.cn/api/v2/trafficlimit/city
支持格式:json
请求方法:get
请求示例:https://xianxing.loopon.cn/api/v2/trafficlimit/city?admin_code=******&plate_number=******&apikey=******
请求参数:
参数名称类型必填说明
apikeyStringY请求服务的密钥
admin_codeStringY城市行政区代码
plate_numberStringY车牌号
dateStringN要查询的日期,如果省略,默认为当天
timeStringN
要查询的时间。
如果省略,默认为所有时间。
1表示使用当前时间查询。
hh:mm:ss格式, 指定具体要查询的时间。
daysIntN 要查询的天数,如果省略,默认为7天。范围为1到40天
geomIntN
返回几何形状:
0或者不填写,表示不返回几何形状点信息。
1表示返回几何形状点信息。
allIntN
当admin_code指定的城市为市级行政区时:
1表示返回下一级的所有区县级城市的限行信息。
0表示只返回admin_code所指定城市的限行信息。
默认为1。
show_nolimit IntN
当某一限行规则经系统判断为不限行时,是否返回不限行的具体规则信息:
1表示返回不限行的具体规则信息。
0表示不返回,只返回"result":0这样的结果。
默认为0。
vehicle_statusStringN
当某城市的限行规则为开四停四时,该字段用于指定最近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进行判断。

返回参数:
参数名称类型说明
rspCodeInt结果状态
dataArray返回的具体限行信息,为一数组,包含有每天的限行规则。(详见下表)
data说明:
参数名称类型说明
dateString日期
limitArraydate 所指定日期的限行规则,为一数组,包含有相应日期的限行规则。
resultInt限行结果,1为限行,0为不限行
typeInt限行规则类型,0 为事件限行,1 为车牌尾号限行
idInt
当type为0时, 这个字段是限行事件ID.
当type为1时,这个字段是限行规则ID.
titleString
事件限行的标题,仅为事件限行规则有,车牌尾号限行没有这个字段
dateArray
事件限行的起始和终止日期,仅为事件限行规则有,车牌尾号限行没有这个字段。
值为一数组,第一项是起始日期,第二项是终止日期
timeArray
限行时间,为一数组,每一项包含起始时间和终止时间, 如果数组为空,表示全天限行。
numberString
限行尾号,如果有多个尾号,则以半角逗号间隔, 如3,5。
当rtype是1,2,3,4,11时,这个字段才有值,rtype为其他值时,该字段为空。
areaString
限行区域
ruleString
限行规则内容
rtypeInt
限行类型
1: 日期
2: 星期
3: 日期单双号
4: 休息日单双号限行
5: 开四停四
6: 景区限行
7: 特殊号牌
8: 时间累积
9: 所有号牌-单一路段
10: 所有号牌-区域
11: 日期含尾号限行
12: 区域号牌
ptypeInt
车牌归属地类型
1: 本地
2: 外地
3: 本地+外地
ntypeInt
当某条规则经系统判断为不限行时,且show_nolimit为1时,该字段表示具体的不限行原因类型:
1: 该规则不在限行时间段内
2: 该规则工作日不限行
3: 该规则调休日不限行
4: 该规则在节假日不限行
5: 该规则在周末不限行
6: 该规则在31号不限行
7: 该车牌号不在限行尾号内
8: 该车辆在开四停四规则下,属于可以行驶状态
9: 该规则处于暂停状态,不限行
40: 找不到有效规则
holiday_titlesArray
当某条规则不限行时,当show_nolimit为1且ntype为4时,该字段表示节假日的名称,为一字符串数组,当没有名称时,为空。
geoinfoArray
限行区域矢量,当geom请求参数设为1时才有,且仅为限行规则才有详见geoinfo说明
Json返回示例:
复制代码
某城市不限行事件
接口地址:https://xianxing.loopon.cn/api/v2/trafficlimit/events
支持格式:json
请求方法:get
请求示例:https://xianxing.loopon.cn/api/v2/trafficlimit/events?admin_code=******&apikey=******
使用说明:该Api主要用于一些开四停四限行规则的城市使用,这个不限行事件的信息将影响开四停四规则的判断。
请求参数:
参数名称类型必填说明
apikeyStringY请求服务的密钥
admin_codeStringY
城市行政区代码
dateStringN
要查询的日期,如果省略,默认为当天
daysIntN
要查询的天数,如果省略,默认为8天。范围为1到40天
返回参数:
参数名称类型说明
rspCodeInt结果状态
dataArray
Json返回示例:
复制代码
查询全国限行城市
接口地址:https://xianxing.loopon.cn/api/v3/trucklimit/city_list
支持格式:json
请求方法:get
请求示例:http://xianxing.loopon.cn/api/v3/trucklimit/city_list?apikey=******
请求参数:
参数名称类型必填说明
apikeyStringY请求服务的密钥
返回参数:
参数名称类型说明
rspCodeInt结果状态
dataArray限行城市列表(列表中每一项见下表)
data中每一项:
参数名称类型说明
admin_codeString城市行政区代码
nameString城市名称
local_marksArray城市本地车牌号标识,为一字符串数组,如["辽A", "辽B"], 如果没有则为空
Json返回示例:
复制代码
经纬度和车牌号限行查询
接口地址:https://xianxing.loopon.cn/api/v3/trucklimit/location
支持格式:json
请求方法:get
请求示例1(不指定货车基本信息的调用):
http://xianxing.loopon.cn/api/v3/trucklimit/location? apikey=******&longitude=******&latitude=******&distance=******
请求示例2(指定货车基本信息的调用):
http://xianxing.loopon.cn/api/v3/trucklimit/location?apikey=******&longitude=******&latitude=******&distance=******&
plate_number=******&type=3&weight=5
请求参数:
参数名称类型必填说明
apikeyString请求服务的密钥
longitudeDouble经度
latitudeDouble纬度
distanceDouble用于指定经纬度对应点所在的范围值。单位为米,范围为1-100000,如果不填,缺省值为50。
dateString要查询的日期,如果不填,默认为当天。
plate_numberString货车的车牌号,如果不填,则货车的其他基本信息可以不填,表明该API调用只根据longitude,latitude,distance来返回限行信息。
typeInt
车辆类型。值范围为1-5,含义如下:
1: 微型货车
2: 轻型货车
3: 中型货车
4: 重型货车
5: 低速货车
weightFloat总质量,单位为吨。
load_weightFloat核定载质量,单位为吨。
tractor_weightFloat牵引车准牵引总质量,以吨为单位。
powerInt
动力类型, 值范围为1-4,含义如下:
1: 汽油
2: 柴油
3: 纯电动
4: 插电混动
useInt
使用性质, 值范围为1-3, 含义如下:
1: 货运
2: 危化品运输
3: 其他
colorInt
车牌颜色, 值范围为1-4, 含义如下:
1: 蓝牌
2: 绿牌
3: 黄牌
4: 黑牌
emissionInt
排放标准, 值范围为1-6, 含义如下:
1: 国一
2: 国二
3: 国三
4: 国四
5: 国五
6: 国六
axleInt
轴数, 值范围为1-7, 含义如下:
1: 1轴
2: 2轴
3: 3轴
4: 4轴
5: 5轴
6: 6轴
7: 6轴以上
调用说明:
1.plate_number, type, weight, load_weigth, tractor_weight, power, use, color, emission, axle 属于货车的基本信息。
2.如果调用API时,不指定plate_number,则API实现认为不传货车基本信息,这些表示基本信息的字段为可选, API实现只根据
longitude, latitude, distance值,来返回指定位置附近的限行信息。
3.如果调用API时,指定plate_number,则API实现认为要传递货车基本信息,这些表示基本信息的字段为必填, API实现会进行校验。
另外对于牵引车,如果指定tractor_weight, 则可以不指定weight, load_weight。 如果非牵引车, 可以不指定tractor_weight。
返回参数:
参数名称类型说明
idInt规则ID
typeInt规则类型,0为货车限行规则,1为乘用车限行规则。
dateArray
限行日期。
对于type为0的货车限行规则,date为2个元素的数组,元素类型为字符串。第1个为起始日期,第2个为结束日期,如为空的话,表示无结束日期。如["2020-01-02", "2020-04-03"]或["2020-01-02", ""]。
对于type为1的乘用车限行规则,这个date为多个元素的数组,每个元素的类型为包含2个元素(起始日期,结束日期)的数组,如[["2020-01-02","2020-04-03"],["2020-03-05","2020-05-08"]]。
timeArray限行时间段,为多个元素的数组,每个元素类型是一个包含2个字符串类型的数组,第1个为起始时间,第2个为结束时间。如[["07:00","12:00"],["08:00", "19:00"]],如果为全天限行,该数组为空,即为[]。
areaString限行区域
ruleString限行规定
ruleString限行规定
reasonString限行原因
suggestionString绕行建议
passString通行证办理说明
sourceString限行来源
ptypeInt
限行归属地, 含义如下:
1: 本地
2: 外地
3: 本地+外地
geoinfoArray
货车限行区域形状,为一数组,元素类型为GeoInfo,(参见geoinfo描述),如果没有数据,则为空, 即为[]
关于响应内容的说明:
当type为1时,表示返回的规则是乘用车限行规则,返回的字段只有id, type, date, time, area, rule, ptype。 且date为多个元素的数组,每一个元素表示起始日期,结束日期。
Json返回示例1(不指定货车基本信息的调用):
复制代码
Json返回示例2(指定货车基本信息的调用):
复制代码
共通规则说明
货车限行规则数据的说明:
参数名称类型说明
idInt规则ID
nameString规则规则名称
dateArray
限行日期,为2个元素的数组,元素类型为字符串。第1个为起始日期,第2个为结束日期,如为空的话,表示无结束日期。如["2020-01-02", "2020-04-03"]或["2020-01-02", ""]
timeArray限行时间段,为多个元素的数组,每个元素类型是一个包含2个字符串类型的数组,第1个为起始时间,第2个为结束时间。如[["07:00","12:00"],["08:00", "19:00"]],如果为全天限行,该数组为空,即为[]
weekendInt周末是否限行,1表示限行,0表示不限行
workdayInt工作日是否限行, 1表示限行,0表示不限行
holidayInt节假日是否限行,1表示限行,0表示不限行
rest_workdayInt调休日是否限行,1表示限行,0表示不限行
areaString限行区域
ruleString限行规定
ptypeInt
限行归属地, 含义如下:
1: 本地
2: 外地
3: 本地+外地
allInt
是否所有货车都限行,1表示所有货车都限行,0表示需要根据下面的具体的限行条件字段来进行判断.
rule_andInt
货车具体的判断条件是否为并且的关系,1为并且,0为或者
typesArray
限行车辆类型, 为一数组,元素类型为整数,含义如下:
1:微型货车
2:轻型货车
3:中型货车
4:重型货车
5:低速货车
structuresArray
限行车辆结构, 为一数组,元素类型为整数,含义如下:
1:普通货车
2:厢式货车
3:仓栅式货车
4:封闭货车
5:罐式货车
6:平板货车
7:集装箱车
8:车辆运输车
9:特殊结构货车
10:自卸货车
11:半挂牵引车
12:全挂牵引车
power_typesArray
限行动力类型, 为一数组,元素类型为整数,含义如下:
1:汽油
2:柴油
3:纯电动
4:插电混动
use_propertiesArray
限行使用性质, 为一数组,元素类型为整数,含义如下:
1:货运
2:危化品运输
3:其他
plate_colorsArray
限行车牌颜色, 为一数组,元素类型为整数,含义如下:
1:蓝牌
2:绿牌
3:黄牌
4:黑牌
emission_standardsArray
限行排放标准, 为一数组,元素类型为整数,含义如下:
1:国一
2:国二
3:国三
4:国四
5:国五
6:国六
axle_number_typesArray
限行轴数, 为一数组, 元素类型为整数,含义如下:
1:1轴
2:2轴
3:3轴
4:4轴
5:5轴
6:6轴
7:6轴以上
trailer_typesArray
挂车类型, 为一数组, 元素类型为整数,含义如下:
1:全挂车
2:中置轴挂车
3:半挂车
st_structuresArray
半挂车结构, 为一数组, 元素类型为整数,含义如下:
1:普通半挂车
2:厢式半挂车
3:仓栅式半挂车
4:罐式半挂车
5:平板半挂车
6:集装箱半挂车
7:自卸半挂车
8:低平板半挂车
9:车辆运输半挂车
10:特殊结构半挂车
11:旅居半挂车
12:专项作业半挂车
cst_structuresArray
中置轴挂车结构, 为一数组, 元素类型为整数,含义如下:
1:中置轴旅居挂车
2:中置轴车辆运输车
3:中置轴普通挂车
ft_structuresArray
Array 全挂车结构, 为一数组, 元素类型为整数,含义如下:
1:普通全挂车
2:厢式全挂车
3:仓栅式全挂车
4:罐式全挂车
5:平板全挂车
6:集装箱全挂车
7:自卸全挂车
8:旅居全挂车
9:专项作业全挂车
heightArray
限行高度, 单位为米,为一2个元素的数组,元素类型为字符串,字符串的内容为浮点数。 第一个表示最小值,第二个表示最大值,如果为空字符串,表示没有限定, 如["12.3", ""], ["12", "15"], ["", "12"]
widthArray
限行宽度, 单位为米,为一2个元素的数组,元素类型为字符串,字符串的内容为浮点数。 第一个表示最小值,第二个表示最大值,如果为空字符串,表示没有限定, 如["12.3", ""], ["12", "15"], ["", "12"]
lengthArray
限行长度, 单位为米,为一2个元素的数组,元素类型为字符串,字符串的内容为浮点数。 第一个表示最小值,第二个表示最大值,如果为空字符串,表示没有限定, 如["12.3", ""], ["12", "15"], ["", "12"]
axle_weightArray
限行轴重, 单位为吨,为一2个元素的数组,元素类型为字符串,字符串的内容为浮点数。 第一个表示最小值,第二个表示最大值,如果为空字符串,表示没有限定, 如["12.3", ""], ["12", "15"], ["", "12"]
qualityArray
限行总质量, 单位为吨,为一2个元素的数组,元素类型为字符串,字符串的内容为浮点数。 第一个表示最小值,第二个表示最大值,如果为空字符串,表示没有限定, 如["12.3", ""], ["12", "15"], ["", "12"]
load_qualityArray
限行核定载质量, 单位为吨,为一2个元素的数组,元素类型为字符串,字符串的内容为浮点数。 第一个表示最小值,第二个表示最大值,如果为空字符串,表示没有限定, 如["12.3", ""], ["12", "15"], ["", "12"]
updated_atString
规则的更新时间,如"2020-11-11 11:59:00"
geoinfoArray
货车限行区域形状,为一数组,元素类型为GeoInfo,参见geoinfo的描述,如果没有数据,则为空, 即为[]。
货车限行尾号规则数据:
参数名称类型说明
idInt货车限行尾号规则ID
dateArray
限行日期段,为多个元素的数组,每个元素类型是一个包含2个字符串类型的数组, 第1个为起始日期,第2个为结束日期,如[["2020-01-02", "2020-04-03"], ["2020-08-02", "2020-09-03"]], 如果为永久限行,则该数组为空,即为[]
timeArray
限行时间段,为多个元素的数组,每个元素类型是一个包含2个字符串类型的数组,第1个为起始时间,第2个为结束时间。 如[["07:00","12:00"],["08:00", "19:00"]],如果为全天限行,该数组为空,即为[]
weekendInt
周末是否限行,1表示限行,0表示不限行
workdayInt工作日是否限行, 1表示限行,0表示不限行
holidayInt节假日是否限行,1表示限行,0表示不限行
thirty_oneInt 31号是否限行,1表示限行,0表示不限行
rest_workdayInt 调休日是否限行,1表示限行,0表示不限行
only_license_plateInt是否只使用车牌尾号限行,1表示是,0表示否. 当为1时,就不考虑weekend, workday, holiday, thirty_one, rest_workday的值了,直接根据车牌尾号进行判断
rtypeInt
限行类型, 含义如下:
1: 日期
2: 星期
3: 日期单双号
4: 休息日单双号限行
5: 开四停四
6: 景区限行
7: 特殊号牌
8: 时间累积
9: 所有号牌-单一路段
10: 所有号牌-区域
11: 日期含尾号限行
12: 区域号牌
ltypeInt
车牌号尾号为英文的限行规定, 含义如下:
0: 按“0”处理
1: 按单号车牌处理
2: 按双号车牌处理
4: 按“4”处理
10: 按最后一位数字处理
11: 只对英文结尾车牌限行
-1: 不对英文结尾车牌限行
12: 对英文和数字结尾车牌都限行
ptypeInt
限行归属地, 含义如下:
1: 本地
2: 外地
3: 本地+外地
tail_numbersString
限行尾号内容, 如0,2,4,6,8;1,3,5,7,9等, 对应rule描述的限行尾号规则, 如周末及法定节假日实行单双号限行措施,单日单号行,双日双号行. 格式为尾号组之间用半角分号;分隔,尾号组内用半角逗号,分隔。
areaString
限行区域
ruleString
限行规定
updated_atString
规则的更新时间,如"2020-11-11 11:59:00"
geoinfoArray
限行区域形状,为一数组,元素类型为GeoInfo,参见geoinfo的描述,如果没有数据,则为空, 即为[]。
货车限行规则的逻辑判断:

1.根据指定点的经纬度和限行规则的限行区域形状geoinfo,可以取得包含指定经纬度的点的限行规则。

2.根据车牌号和限行规则的ptype,可以过滤出符合车牌号归属地的限行规则。

3.根据当天的日期和时间,结合限行规则的date, time, weekend, workday, holiday, rest_workday等字段,可以进一步过滤出符合条件的规则。

4.再根据过滤出来的规则,如果all为1,则该规则为一条符合条件的限行规则,否则继续进行下面5-7步的处理。

5.规则中的types, structures, power_types, use_properties, plate_colors, emission_standards, axle_number_types 为一些基本信息的 判断字段,如果这些字段不为[], 则根据货车的类型,结构,动力类型,使用性质,车牌颜色,排放标准, 车轴数等基本信息,如果有一项包含在 该规则的这些判断字段数组中,则该规则为符合条件的限行规则。比如规则的 types为[2],某货车为轻型货车,则该规则符合限行。

6.规则中的height, width, length, axle_weight, quality, load_quality为货车的高度,长度,重量等信息的判断字段,为一个含有2个值的数组, 第一个值指定最小值,第二值指定最大值,这两个值都可以为空字符串,表示不限制。如某一规则:(1)height为["2", ""], 表示该规则在货车高度2米以上时限行。(2)height为["", "5"],则表示该规则在货车高度在5米以下限行。(3)height为["2", "5"], 则表示该规则在货车高度在2米以上,在5米以下限行。(4)height为[],则表示该规则在货车高度上没有限制。 width, length, axle_weight, quality, load_quality 含义类似。

7.规则中rule_and为指定并且关系的字段,如为1则表示 5, 6步骤中的规则判断字段之间的关系是并且的关系。 如 height为["2", ""], types为[2] , 如rule_and为1,则表示该规则在货车高度2米以上并且为轻型货车,则限行。 如果rule_and为0,则表示该规则在货车高度2米以上限行,或者为轻型货车也限行。

8.经过以上步骤处理后,如果获得的限行规则列表不为空,则该货车在指定的经纬度位置限行。如果列表为空,则不限行。