接入指南

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

  • 申請合法APIkey
  • 獲取必要的接入信息
  • 開始集成
申請密鑰
按需求設置傳參(示例)
接口地址:https://xianxing.www.hkywq.cn/api/v1/trafficlimit/number/getCityList
支持格式:json
請求方法:get
請求示例:https://xianxing.www.hkywq.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.www.hkywq.cn/api/v1/trafficlimit/number/getCityList
支持格式:json
請求方法:get
請求示例:https://xianxing.www.hkywq.cn/api/v1/trafficlimit/number/getCityList?apikey=******
請求參數:
參數名稱類型必填說明
apikeyStringY請求服務的密鑰
allIntN
請求服務的密鑰
1表示返回所有的城市列表。
0表示只返回限行日期有效的城市列表。
默認為0。
返回參數:
參數名稱類型說明
rspCodeInt結果狀態
dataArray返回城市列表
cityString城市代號
citynameString城市名稱
districtsArray下一級限行區縣的城市列表,如果沒有,則為空
districtCodeString區縣城市代號
districtNameString區縣城市名稱
Json返回示例:
復制代碼
查詢城市限行規則
接口地址:https://xianxing.www.hkywq.cn/api/v1/trafficlimit/number/getCityLimit
支持格式:json
請求方法:get
請求示例:https://xianxing.www.hkywq.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.www.hkywq.cn/api/v2/trafficlimit/vehicle
支持格式:json
請求方法:get
請求示例:https://xianxing.www.hkywq.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.www.hkywq.cn/api/v2/trafficlimit/city
支持格式:json
請求方法:get
請求示例:https://xianxing.www.hkywq.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.www.hkywq.cn/api/v2/trafficlimit/events
支持格式:json
請求方法:get
請求示例:https://xianxing.www.hkywq.cn/api/v2/trafficlimit/events?admin_code=******&apikey=******
使用說明:該Api主要用于一些開四停四限行規則的城市使用,這個不限行事件的信息將影響開四停四規則的判斷。
請求參數:
參數名稱類型必填說明
apikeyStringY請求服務的密鑰
admin_codeStringY
城市行政區代碼
dateStringN
要查詢的日期,如果省略,默認為當天
daysIntN
要查詢的天數,如果省略,默認為8天。范圍為1到40天
返回參數:
參數名稱類型說明
rspCodeInt結果狀態
dataArray
Json返回示例:
復制代碼
查詢全國限行城市
接口地址:https://xianxing.www.hkywq.cn/api/v3/trucklimit/city_list
支持格式:json
請求方法:get
請求示例:http://xianxing.www.hkywq.cn/api/v3/trucklimit/city_list?apikey=******
請求參數:
參數名稱類型必填說明
apikeyStringY請求服務的密鑰
返回參數:
參數名稱類型說明
rspCodeInt結果狀態
dataArray限行城市列表(列表中每一項見下表)
data中每一項:
參數名稱類型說明
admin_codeString城市行政區代碼
nameString城市名稱
local_marksArray城市本地車牌號標識,為一字符串數組,如["遼A", "遼B"], 如果沒有則為空
Json返回示例:
復制代碼
經緯度和車牌號限行查詢
接口地址:https://xianxing.www.hkywq.cn/api/v3/trucklimit/location
支持格式:json
請求方法:get
請求示例1(不指定貨車基本信息的調用):
http://xianxing.www.hkywq.cn/api/v3/trucklimit/location? apikey=******&longitude=******&latitude=******&distance=******
請求示例2(指定貨車基本信息的調用):
http://xianxing.www.hkywq.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.經過以上步驟處理后,如果獲得的限行規則列表不為空,則該貨車在指定的經緯度位置限行。如果列表為空,則不限行。

在线看黄色电影