車行管理服務(wù)
1 車行空間與設(shè)備
車行空間是對小區(qū)空間下的車輛出入口、停放區(qū)域的空間抽象,主要用于車輛權(quán)限分發(fā),以及停車設(shè)備管理。
數(shù)字社區(qū)車行空間包括:
停車區(qū)域(parking_area):一個獨(dú)立的停車場空間,有單獨(dú)的進(jìn)出口通道;
車道空間(parking_space_channel):車輛進(jìn)出口空間,每個車道綁定一個停車設(shè)備。
一個小區(qū)可以劃分多個停車區(qū)域,一個停車區(qū)域可以包含多個車道,每個車道綁定一個停車設(shè)備,如下圖所示:
2 車輛通行記錄
實(shí)時訂閱車行數(shù)據(jù),用于業(yè)務(wù)層做流程組裝。
模型ID | 版本 |
iot_park_record_v2_model | 1.6 |
車行數(shù)據(jù)
字段名 | 類型 | 備注 |
direction | Integer | 車輛通行的方向:0:進(jìn)場,1:出場 |
openType | Integer | 抬桿類型:0:正常抬桿,1:異常抬桿,2:手動抬桿 |
typePermission | Integer | 車輛的進(jìn)出權(quán)限類型:0:普通車輛,1:臨時車輛,2:白名單,3:黑名單,4:無牌車 |
tollProductKey | String | 車輛道閘設(shè)備productKey |
tollDeviceName | String | 車輛道閘設(shè)備deviceName |
plateNumber | String | 車牌號 |
areaSpaceId | String | 停車區(qū)域空間ID |
iotId | String | 設(shè)備iotId |
plateNumberType | String | 機(jī)動車號牌種類代碼:01-大型汽車號牌;02-小型汽車號牌;03-使館汽車號牌;04-領(lǐng)館汽車號牌;05-境外汽車號牌;06-外籍汽車號牌;07-普通摩托車號牌;08 輕便摩托車號牌;09-使館摩托車號牌;51-大型新能源車牌汽車; 52-小型新能源車牌車;99-其他 |
carColorNumber | String | 機(jī)動車顏色代碼:A-白;B-灰;C-黃;D-粉;E-紅;F-紫;G-綠;H-藍(lán);I-棕;J-黑;K-橙;L-青;M-銀;N-藏青;Z-其他 |
hasPlate | Integer | 有無車牌:0:無車牌,1:有車牌 |
plateColorNumber | Integer | 機(jī)動車號牌顏色:0-白色、1-黃色、2-藍(lán)色、3-黑色,4-其他,5-綠色、6-紅色、7-黃綠雙色, 8-漸變綠色,9-未識別 |
plateRecognitionReliability | Double | 車牌識別可信度:0~1浮點(diǎn)數(shù) |
carLogoBrand | String | 車輛品牌標(biāo)志 |
carEigenvaluesInfo | String | 車輛特征值信息,JSON字符串 |
carExtraInfo | String | 車輛擴(kuò)展信息,JSON字符串 |
userExtraInfo | String | 用戶擴(kuò)展信息,JSON字符串 |
deviceExtraInfo | String | 設(shè)備擴(kuò)展信息,JSON字符串 |
carImageKey | String | 車輛全景圖像ID |
channelSpaceId | String | 車道空間ID(出入口) |
3 車行空間管理
3.1 新建車行空間
見“新建小區(qū)下區(qū)域”接口:
新建停車區(qū)域:選擇空間類型代碼“parking_area”;
新建車道空間:選擇空間類型代碼“parking_space_channel”,并指定車道方向(direction)。
3.2 修改車行空間
見“修改小區(qū)下區(qū)域”接口。
3.3 刪除車行空間
見“刪除小區(qū)下區(qū)域”接口。
3.4 查詢車行空間
見“層級查詢子空間”接口。
見“平鋪查詢子空間”接口
見“查詢空間詳情”接口。
4 車輛權(quán)限管理
4.1 添加(更新)車輛權(quán)限
Path路徑 | /parking/paas/vehicle/permission/add |
請求方式 | post |
接口版本 | 1.0.0 |
請求參數(shù)
參數(shù) | 類型 | 必填 | 描述 |
permList | JSONArray | 是 | |
- spaceId | String | 是 | 空間ID |
- plateNumber | String | 是 | 車牌號 |
- effectiveDate | String | 是 | 車輛有效期的開始時間:yyyy-MM-dd HH:mm:ss |
- expiryDate | String | 是 | 車輛有效期的終止時間:yyyy-MM-dd HH:mm:ss |
返回參數(shù)
參數(shù) | 類型 | 描述 |
無 |
4.2 查詢車輛權(quán)限
Path路徑 | /parking/paas/vehicle/permission/query |
請求方式 | post |
接口版本 | 1.0.0 |
請求參數(shù)
參數(shù) | 類型 | 必填 | 描述 |
spaceIds | List<String> | 是 | 空間ID |
plateNumbers | List<String> | 否 | 車牌號 |
status | String | 否 | 權(quán)限同步狀態(tài):
|
pageNo | Integer | 是 | 頁碼 |
pageSize | Integer | 是 | 頁面大小 |
返回參數(shù)
參數(shù) | 類型 | 描述 |
pageNo | Integer | 頁碼 |
pageSize | Integer | 頁面大小 |
total | Integer | 總數(shù) |
data | JSONArray | 權(quán)限列表 |
- plateNumber | String | 車牌號 |
- effectiveDate | String | 車輛有效期的開始時間:yyyy-MM-dd HH:mm:ss |
- expiryDate | String | 車輛有效期的終止時間:yyyy-MM-dd HH:mm:ss |
- spaceId | String | 空間ID |
- spaceName | String | 空間名稱 |
- status | String | 權(quán)限同步狀態(tài):
|
4.3 刪除車輛權(quán)限
Path路徑 | /parking/paas/vehicle/permission/delete |
請求方式 | post |
接口版本 | 1.0.0 |
請求參數(shù)
參數(shù) | 類型 | 必填 | 描述 |
permList | JSONArray | 是 | |
-spaceId | String | 是 | 空間ID |
-plateNumber | String | 是 | 車牌號 |
返回參數(shù)
參數(shù) | 類型 | 描述 |
無 |
5 黑白名單管理
5.1 添加(更新)黑白名單
Path路徑 | /parking/paas/vehicle/special/concerns/add |
請求方式 | post |
接口版本 | 1.0.0 |
請求參數(shù)
參數(shù) | 類型 | 必填 | 描述 |
permList | JSONArray | 是 | |
- spaceId | String | 是 | 空間ID |
- plateNumber | String | 是 | 車牌號 |
- type | String | 是 | 車輛類型:
|
- brand | String | 否 | 車輛品牌 |
- color | Integer | 否 | 車身顏色: 0-其他 1-白 2-灰 3-黃 4-粉 5-紅 6-紫 7-綠 8-藍(lán) 9-棕 10-黑 11-青 |
返回參數(shù)
參數(shù) | 類型 | 描述 |
無 |
5.2 刪除黑白名單
Path路徑 | /parking/paas/vehicle/special/concerns/delete |
請求方式 | post |
接口版本 | 1.0.1 |
請求參數(shù)
參數(shù) | 類型 | 必填 | 描述 |
permList | JSONArray | 是 | |
- spaceId | String | 是 | 空間ID |
- plateNumber | String | 是 | 車牌號 |
返回參數(shù)
參數(shù) | 類型 | 描述 |
無 |
5.3 查詢黑白名單
Path路徑 | /parking/paas/vehicle/special/concerns/query |
請求方式 | post |
接口版本 | 1.0.0 |
請求參數(shù)
參數(shù) | 類型 | 必填 | 描述 |
spaceIds | List<String> | 是 | 空間ID |
plateNumbers | List<String> | 否 | 車牌號 |
type | String | 是 | 車輛類型:
|
pageNo | Integer | 是 | 頁碼 |
pageSize | Integer | 是 | 頁面大小 |
返回參數(shù)
參數(shù) | 類型 | 描述 |
pageNo | Integer | 頁碼 |
pageSize | Integer | 頁面大小 |
total | Integer | 總數(shù) |
data | JSONArray | 權(quán)限列表 |
- plateNumber | String | 車牌號 |
- brand | String | 車輛品牌 |
- color | Integer | 車身顏色: 0-其他 1-白 2-灰 3-黃 4-粉 5-紅 6-紫 7-綠 8-藍(lán) 9-棕 10-黑 11-青 |
- spaceId | String | 空間ID |
- status | String | 黑白名單同步狀態(tài):
|
6 停車設(shè)備管理
6.1 綁定停車設(shè)備
Path路徑 | /parking/paas/toll/bind |
請求方式 | post |
接口版本 | 1.0.0 |
請求參數(shù)
參數(shù) | 類型 | 必填 | 描述 |
iotId | String | 是 | 設(shè)備唯一標(biāo)識 |
spaceId | String | 是 | 車道空間ID |
返回參數(shù)
參數(shù) | 類型 | 描述 |
無 |
6.2 解綁停車設(shè)備
Path路徑 | /parking/paas/toll/unbind |
請求方式 | post |
接口版本 | 1.0.0 |
請求參數(shù)
參數(shù) | 類型 | 必填 | 描述 |
iotId | String | 是 | 設(shè)備唯一標(biāo)識 |
返回參數(shù)
參數(shù) | 類型 | 描述 |
無 |
6.3 查詢停車設(shè)備
Path路徑 | /parking/paas/toll/query |
請求方式 | post |
接口版本 | 1.0.0 |
請求參數(shù)
參數(shù) | 類型 | 必填 | 描述 |
spaceId | String | 是 | 車道空間ID |
getDeviceStatus | Boolean | 否 | 是否查詢設(shè)備狀態(tài):
|
返回參數(shù)
參數(shù) | 類型 | 描述 |
iotId | String | 設(shè)備iotId |
name | String | 設(shè)備名稱 |
productKey | String | 設(shè)備productKey |
status | Integer | 設(shè)備狀態(tài):
|
7 遠(yuǎn)程開關(guān)道閘
見“觸發(fā)物的服務(wù)”接口。
請求參數(shù)
參數(shù) | 類型 | 必填 | 備注 |
iotId | String | 是 | 設(shè)備唯一標(biāo)識 |
args | map | 是 | {"OperatType": 1}
|
identifier | String | 是 | 固定值:OperatGate |
返回結(jié)果
字段名 | 類型 | 備注 |
無 | 無 | 無 |
8 車道視頻直播
見“查詢推流地址”接口。
9 LED內(nèi)容下發(fā)
9.1 LED內(nèi)容下發(fā)模式
見“獲取物的屬性”接口,屬性標(biāo)識為“LedNoticeMode”,支持以下屬性值:
0:設(shè)備支持分離下發(fā)模式,可分別下發(fā)提示語音、提示顯示、默認(rèn)顯示;
1:設(shè)備僅支持混合下發(fā)提示信息,屏幕不支持單行刷新。
9.2 提示語音下發(fā)
見“觸發(fā)物的服務(wù)”接口。
請求參數(shù)
參數(shù) | 類型 | 必填 | 備注 |
iotId | String | 是 | 設(shè)備唯一標(biāo)識 |
args | Map | 是 | {"VoiceContent": "語音提示信息","PlaySpeed":1} |
-VoiceContent | String | 是 | 語音播報內(nèi)容,數(shù)據(jù)長度2048 |
-PlaySpeed | Integer | 否 | 語音播報速度,取值范圍:1 - 10,步長:1 |
identifier | String | 是 | 固定值:NoticeBroadcast |
返回結(jié)果
字段名 | 類型 | 備注 |
無 | 無 | 無 |
9.3 提示顯示下發(fā)
見“觸發(fā)物的服務(wù)”接口。
請求參數(shù)
參數(shù) | 類型 | 必填 | 備注 |
iotId | String | 是 | 設(shè)備唯一標(biāo)識 |
args | Map | 是 | {"DisplayContent": "提示顯示信息","RowNumber":1} |
-DisplayContent | String | 是 | 顯示內(nèi)容,數(shù)據(jù)長度2048 |
-RowNumber | Integer | 是 | 屏幕行號,取值范圍:1 - 100 |
-MovingSpeed | Integer | 否 | 文字移動速度,取值范圍:1 - 10,步長:1 |
-DisplayTime | Integer | 否 | 顯示時長,取值范圍:1 - 3600,單位:秒 |
-MovingType | Integer | 否 | 文字移動方式:
|
identifier | String | 是 | 固定值:NoticeDisplay |
返回結(jié)果
字段名 | 類型 | 備注 |
無 | 無 | 無 |
9.4 默認(rèn)顯示下發(fā)
見“觸發(fā)物的服務(wù)”接口。
請求參數(shù)
參數(shù) | 類型 | 是否必填 | 備注 |
iotId | String | 是 | 設(shè)備唯一標(biāo)識 |
args | Map | 是 | {"DisplayContent": "提示顯示信息", "RowNumber":1, "DefaultSituation":0} |
-DisplayContent | String | 是 | 顯示內(nèi)容,數(shù)據(jù)長度2048 |
-RowNumber | Integer | 是 | 屏幕行號,取值范圍:1 - 100 |
-DefaultSituation | Integer | 是 | 默認(rèn)顯示場景:
|
identifier | String | 是 | 固定值:DefaultDisplay |
返回結(jié)果
字段名 | 類型 | 備注 |
無 | 無 | 無 |
9.5 LED內(nèi)容混合下發(fā)
不支持“提示語音”、“提示顯示”分離下發(fā)的設(shè)備,使用以下接口混合下發(fā)提示信息。
Path路徑 | /parking/paas/led/content/download |
請求方式 | post |
接口版本 | 1.0.0 |
請求參數(shù)
參數(shù) | 類型 | 必填 | 描述 |
iotId | String | 是 | 車行攝像頭的設(shè)備ID |
type | Integer | 是 | 下發(fā)場景類型:
|
situation | Integer | 否 | 固定場景種類:
|
showTime | Integer | 否 | 內(nèi)容持續(xù)顯示時長,單位:秒,默認(rèn)值:10 |
audioContextInfo | String | 否 | 自定義語音播報內(nèi)容 |
screenLineNum | Integer | 是 | 屏幕顯示行數(shù),默認(rèn)值:4 |
contextList | JSONArray | 是 | 屏幕顯示內(nèi)容,每個元素表示一行 |
- runType | Integer | 否 | 文字滾動方式:
|
- colorType | Integer | 否 | 文字顏色:
|
- customContext | String | 是 | 自定義內(nèi)容,長度0-128。內(nèi)容支持以下通配符:
|
- audio | Integer | 否 | 是否進(jìn)行語音播報:
|
返回參數(shù)
參數(shù) | 類型 | 描述 |
無 |
10 手動觸發(fā)車牌識別
見“觸發(fā)物的服務(wù)”接口。
請求參數(shù)
參數(shù) | 類型 | 是否必填 | 備注 |
iotId | String | 是 | 設(shè)備唯一標(biāo)識 |
args | Map | 是 | {} |
identifier | String | 是 | 固定值:TriggerRecognition |
返回結(jié)果
字段名 | 類型 | 備注 |
無 | 無 | 無 |
11 二維碼下發(fā)
11.1 是否支持二維碼
見“獲取物的屬性”接口,屬性標(biāo)識為“IsSurportQrCode”,支持以下屬性值:
0:不支持
1:支持
11.2 二維碼下發(fā)
見“觸發(fā)物的服務(wù)”接口。
請求參數(shù)
參數(shù) | 類型 | 是否必填 | 備注 |
iotId | String | 是 | 設(shè)備唯一標(biāo)識 |
args | Map | 是 | {"QrCode":"二維碼文本信息"} |
identifier | String | 是 | 固定值:QrCodeDisplay |
返回結(jié)果
字段名 | 類型 | 備注 |
無 | 無 | 無 |