車牌辨識子系統

Version: 0.2

Last Update: 2017-06-08

泊律恆保有修改的權利

Synopsis

本文件說明車牌辨識系統和客戶端應用程式的溝通協定，及設定。車牌辨識系統包含二個獨立的子系統:

車牌辨識子系統:接受客戶端(client)的車牌辨識請求，並回覆辨識結果。
影像服務子系統:提供影像查詢。

車牌辨識 API 採用非同步架構: 一個辨識事件，分為觸發及取得結果2個動作。每個動作都要即時回應。

SmartPark 可與第三方車辨系統串接, 只要車辨系統提供符合本文件的 API, SmartPark 就可以與之串接.

車牌辨識 APIs

URL 結構

http://{Server-IP}/[path/]{command}?{param}

- {Server-IP}: 伺服器IP
- [path/]: API 路徑，非必要
- {command}: 命令
- {param}: 命令參數

API 範例

http://192.168.100.1/api/v1/trigger?lane=3

- 192.168.100.1: Server-IP
- api/v1/: API 路徑
- trigger: 命令
- lane=3: 命令參數

取得版本資訊

[GET] version

Smartpark 請求

呼叫範例:

http://192.168.1.100/version

車辨系統回覆

版本字串
由車辨自訂，用以識別不同車辨系統

啟動車辨系統

[GET] trigger?lane={車道編號}

Smartpark 請求

{車道編號}: 001~999
呼叫範例:

http://192.168.1.100/trigger?lane=3

車辨系統回覆

不重覆的辨識序號 aveid, 長度: 17碼
例：20170607080912111

取得辨識結果

[GET] result?lane={車道編號}&aveid={aveid}

Smartpark 請求

{車道編號}: 001~999
{aveid}: 不重覆的辨識序號，由 trigger API 取得
呼叫範例:

http://192.168.1.100/result?lane=3&aveid=20170607080912111

車辨系統回覆

車牌辨識結果：可能的回覆如下
1. 合法的車牌: 長度4～10個字元. 例: ABC1234
2. *: 辨識尚未完成, 停管系統會持續呼叫此API直到有結果.
3. !: 辨識錯誤. 例: !無法辨識
4. ?: 攝影機錯誤. 例: ?攝影機離線
5. 000000: 無法辨識

影像服務子系統 Image Service

[GET] image/{lane}-{aveid}.jpg

Image Server 為一部固定 IP 的網頁伺服器。負責提供車牌辨識的照片。

Protocol: HTTP
Port: 80
Image format: jpg
URL 結構:
http://{Image-Server-IP}/image/{lane}-{aveid}.jpg
- {Image-Server-IP}: 伺服器IP，同車辨伺服器IP
- image: 固定字串，不可省略
- {lane}: 車道代碼，3碼
- {aveid}: 車辨序號，17碼
範例: http://192.168.100.1/image/003-20170607103012999.jpg

Page updated

Report abuse