車辨系統 API

• 車辨系統 API
  • 辨識紀錄
    • 獲取所有辨識紀錄 (不開放)
    • 獲取辨識紀錄 (透過事件ID)
    • 新增辨識紀錄
    • 批次新增辨識紀錄
    • 查尋軌跡 (車牌查詢)
  • 搜尋紀錄
    • 獲取所有搜尋紀錄
    • 獲取搜尋紀錄 (透過搜尋編號)
    • 新增搜尋紀錄
    • 查詢搜尋紀錄
  • 文件編輯紀錄

辨識紀錄

獲取所有辨識紀錄 (不開放)

URI : /opendb/v1/api/tracks/events

method : GET

body :

{  
}

response :

{
    "status": "",
    "message": "",
    "content": [
        {
            "eventID": "",
            "plateNum": "",
            "carColor": "",
            "carType": "",
            "startTime": "",
            "endTime": "",
            "getSnapshotURI": "",
            "getFileURI": "",
            "cameraID": "",
            "cameraName": "",
            "intersection": "",
            "policeStation": "",
            "precinct": "",
            "district": "",
            "latitude": "",
            "longitude": "",
            "azimuthAngle": "",
            "status": ""
        },
        ...
    ]
}

參數名稱	說明	Data Type
status	狀態碼	INT
message	訊息說明	NVARCHAR(200)
content
eventID	事件編號	INT
plateNum	車牌	NVARCHAR(10)
carColor	車色	INT
carType	車型	INT
startTime	起始時間	DATETIME
endTime	結束時間	DATETIME
getSnapshotURI	快照連結	NVARCHAR(250)
getFileURI	影像連結	NVARCHAR(250)
cameraID	攝影機編號	NVARCHAR(40)
cameraName	攝影機名稱	NVARCHAR(20)
intersection	路口	NVARCHAR(200)
policeStation	管理該監視器的派出所	NVARCHAR(100)
precinct	管理該監視器的分局	NVARCHAR(100)
district	行政區	NVARCHAR(50)
latitude	緯度	REAL
longitude	經度	REAL
azimuthAngle	方位角	INT
status	監視器狀態	INT

舊版

{
    "status": "",
    "message": "",
    "content": [
         {
            "eventID": "",
            "plateNum": "",
            "cameraID": "",
            "cameraName": "",
            "address": "",
            "startTime": "",
            "endTime": "",
            "carColor": "",
            "carType": "",
            "getSnapshotURI": "",
            "getFileURI": "",
            "intersection": "",
            "precinct": "",
            "policeStation": ""
        },
        ...
    ]  
}

參數名稱	說明	Data Type
status	狀態碼	int
message	訊息說明	string
content
eventID	事件編號	int
plateNum	車牌	string
cameraID	攝影機編號	string
cameraName	攝影機名稱	string
address	地址	string
startTime	起始時間	DATETIME
endTime	結束時間	DATETIME
carColor	車色	int
carType	車型	int
getSnapshotURI	快照連結	string
getFileURI	影像連結	string
intersection	路口	string
precinct	機關	string
policeStation	單位	string

---

獲取辨識紀錄 (透過事件ID)

URI : /opendb/v1/api/tracks/event/:event_id

method : GET

body:

{
}

response :

{
    "status": "",
    "message": "",
    "content": [
        {
            "eventID": "",
            "plateNum": "",
            "carColor": "",
            "carType": "",
            "startTime": "",
            "endTime": "",
            "getSnapshotURI": "",
            "getFileURI": "",
            "cameraID": "",
            "cameraName": "",
            "intersection": "",
            "policeStation": "",
            "precinct": "",
            "district": "",
            "latitude": "",
            "longitude": "",
            "azimuthAngle": "",
            "status": ""
        }
    ]
}

參數名稱	說明	Data Type
status	狀態碼	INT
message	訊息說明	NVARCHAR(200)
content
eventID	事件編號	INT
plateNum	車牌	NVARCHAR(10)
carColor	車色	INT
carType	車型	INT
startTime	起始時間	DATETIME
endTime	結束時間	DATETIME
getSnapshotURI	快照連結	NVARCHAR(250)
getFileURI	影像連結	NVARCHAR(250)
cameraID	攝影機編號	NVARCHAR(40)
cameraName	攝影機名稱	NVARCHAR(20)
intersection	路口	NVARCHAR(200)
policeStation	管理該監視器的派出所	NVARCHAR(100)
precinct	管理該監視器的分局	NVARCHAR(100)
district	行政區	NVARCHAR(50)
latitude	緯度	REAL
longitude	經度	REAL
azimuthAngle	方位角	INT
status	監視器狀態	INT

舊版

{
    "status": "",
    "message": "",
    "content":[
         {
            "eventID": "",
            "plateNum": "",
            "cameraID": "",
            "cameraName": "",
            "address": "",
            "startTime": "",
            "endTime": "",
            "carColor": "",
            "carType": "",
            "getSnapshotURI": "",
            "getFileURI": "",
            "intersection": "",
            "precinct": "",
            "policeStation": ""
        }
    ]  
}

參數名稱	說明	Data Type
status	狀態碼	int
message	訊息說明	string
content
eventID	事件編號	int
plateNum	車牌	string
cameraID	攝影機編號	string
cameraName	攝影機名稱	string
address	地址	string
startTime	起始時間	DATETIME
endTime	結束時間	DATETIME
carColor	車色	int
carType	車型	int
getSnapshotURI	快照連結	string
getFileURI	影像連結	string
intersection	路口	string
precinct	機關	string
policeStation	單位	string

---

新增辨識紀錄

URI : /opendb/v1/api/tracks/event

method : POST

body :

{
	"plateNum": "",
	"carColor": "",
	"carType": "",
	"startTime": "",
	"endTime": "",
	"getSnapshotURI": "",
	"getFileURI": "",
	"cameraID": "",
}

舊版

 {
    "plateNum": "",
    "cameraID": "",
    "address": "",
    "startTime": "",
    "endTime": "",
    "carColor": "",
    "carType": "",
    "getSnapshotURI": "",
    "getFileURI": "",
    "intersection": "",
    "precinct": "",
    "policeStation": ""
}

參數名稱	說明	Data Type
eventID	事件編號	int
plateNum	車牌	string
cameraID	攝影機編號	string
cameraName	攝影機名稱	string
address	地址	string
startTime	起始時間	DATETIME
endTime	結束時間	DATETIME
carColor	車色	int
carType	車型	int
getSnapshotURI	快照連結	string
getFileURI	影像連結	string
intersection	路口	string
precinct	分局	string
policeStation	派出所	string

response :

{
    "status": "",
    "message": ""
}

參數名稱	說明	Data Type
status	狀態碼	int
message	訊息說明	string

批次新增辨識紀錄

URI : /opendb/v1/api/tracks/events

method : POST

body :

[
    {
        "plateNum": "",
        "carColor": "",
        "carType": "",
        "startTime": "",
        "endTime": "",
        "getSnapshotURI": "",
        "getFileURI": "",
        "cameraID": "",
    },
    ...
]

response :

{
    "status": "",
    "message": "",
    "insertCount": ""
}

參數名稱	說明	Data Type
status	狀態碼	int
message	訊息說明	string
insertCount	新增筆數	int

---

查尋軌跡 (車牌查詢)

URI : /opendb/v1/api/tracks/search

method : GET

param :

Key	Value Type	說明	必填
plateNum	string	車牌 ( 未確定完整車牌可用 * 或 ? 代替 )	O
carColor	int	車色	X
carType	int	車型	X
precinct	string	分局	X
policeStation	string	派出所	X
district	string	行政區	X
cameraID	string	攝影機編號	X
stime	string	搜尋起始時間 ( 刻意與startTime做出區別 )	O
etime	string	搜尋結束時間 ( 刻意與endTime做出區別 )	O

body :

{
}

response :

{
    "status": "",
    "message": "",
    "content": [
        {
            "plateNum": "",
            "num": "",
            "traceStartTime": "",
            "traceEndTime": "",
            "trackList": [
                 {
                    "eventID": "",
                    "plateNum": "",
                    "carColor": "",
                    "carType": "",
                    "startTime": "",
                    "endTime": "",
                    "getSnapshotURI": "",
                    "getFileURI": "",
                    "cameraID": "",
                    "cameraName": "",
                    "intersection": "",
                    "policeStation": "",
                    "precinct": "",
                    "district": "",
                    "latitude": "",
                    "longitude": "",
                    "azimuthAngle": "",
                    "status": ""
                },
                ...
            ]
        },
        ...
    ]
}

參數名稱	說明	Data Type
status	狀態碼	INT
message	訊息說明	NVARCHAR(200)
content
plateNum	車牌	NVARCHAR(10)
num	軌跡數量	INT
traceStartTime	追蹤起始時間	DATETIME
traceEndTime	追蹤結束時間	DATETIME
trackList
eventID	事件編號	INT
plateNum	車牌	NVARCHAR(10)
carColor	車色	INT
carType	車型	INT
startTime	起始時間	DATETIME
endTime	結束時間	DATETIME
getSnapshotURI	快照連結	NVARCHAR(250)
getFileURI	影像連結	NVARCHAR(250)
cameraID	攝影機編號	NVARCHAR(40)
cameraName	攝影機名稱	NVARCHAR(20)
intersection	路口	NVARCHAR(200)
policeStation	管理該監視器的派出所	NVARCHAR(100)
precinct	管理該監視器的分局	NVARCHAR(100)
district	行政區	NVARCHAR(50)
latitude	緯度	REAL
longitude	經度	REAL
azimuthAngle	方位角	INT
status	監視器狀態	INT

---

搜尋紀錄

獲取所有搜尋紀錄

URI : /opendb/v1/api/search_history

method : GET

body :

{
}

response :

{
    "status": "",
    "message": "",
    "content": [
        {
            "searchID": "",
            "eventID": "",
            "personID": "",
            "caseID": "",
            "searchTime": ""
        },
        ...
    ]
}

參數名稱	說明	Data Type
status	狀態碼	int
message	訊息說明	string
content
searchID	搜尋編號	int
eventID	事件編號	int
personID	查詢人ID	string
caseID	案號	string
searchTime	搜尋時間	DATETIME

---

獲取搜尋紀錄 (透過搜尋編號)

URI : /opendb/v1/api/search_history/:searchID

method : GET

body :

{
}

response :

{
    "status": "",
    "message": "",
    "content": [
        {
            "searchID": "",
            "eventID": "",
            "personID": "",
            "caseID": "",
            "searchTime": ""
        }
    ]
}

參數名稱	說明	Data Type
status	狀態碼	int
message	訊息說明	string
content
searchID	搜尋編號	int
eventID	事件編號	int
personID	查詢人ID	string
caseID	案號	string
searchTime	搜尋時間	DATETIME

---

新增搜尋紀錄

URI : /opendb/v1/api/search_history

method : POST

body :

{
    "eventID": "",
    "personID": "",
    "caseID": ""
}

參數名稱	說明	Data Type
eventID	事件編號	int
personID	查詢人ID	string
caseID	案號	string

• searchID 應該由 server 端產生
• searchTime 可以由 server 端的時間直接新增至資料庫即可

response :

{
    "status": "",
    "message": ""
}

參數名稱	說明	Data Type
status	狀態碼	int
message	訊息說明	string

---

查詢搜尋紀錄

URI : /opendb/v1/api/search_history/search

method : GET

param :

Key	Value Type	說明	必填
name	string	查詢人名稱	O
reason	string	案由	O
stime	string	搜尋起始時間	O
etime	string	搜尋結束時間	O

body :

{
}

response :

{
    "status": "",
    "message": "",
    "content": [
        {
            "searchID": "",
            "eventID": "",
            "personID": "",
            "caseID": "",
            "searchTime": ""
        },
        ...
    ]
}

參數名稱	說明	Data Type
status	狀態碼	int
message	訊息說明	string
content
searchID	搜尋編號	int
eventID	事件編號	int
personID	查詢人ID	string
caseID	案號	string
searchTime	搜尋時間	DATETIME

文件編輯紀錄

• 12/13 將查尋軌跡的部分 parm 移除: 查詢者名稱、案由、案號

• 12/13 將 URI 前綴改成 /opendb/v1/api/

• 5/23 修改查尋軌跡必填欄位

• 5/3 修改查詢搜尋紀錄必填欄位

• 5/3 移除新增辨識紀錄JSON中的eventID

• 5/3 eventID 與 searchID datatype 從 string 改成 int

• 4/20 新增查詢搜尋紀錄param中的參數

• 4/4 移除新增辨識紀錄參數裡的cameraName、address

• 3/16 新增了搜尋紀錄相關的 API：
  獲取所有搜尋紀錄、獲取搜尋紀錄、新增搜尋紀錄

• 3/16 將API中所有時間的參數的 data type 改成 DATETIME

• 3/15 新增辨識紀錄 URI 修改：
  /api/tracks/events/:eventID → /api/tracks/events

• 3/8 將查詢軌跡與分析軌跡兩API合併，名稱為查詢軌跡，response則沿用分析軌跡的response

• 3/6 在查詢軌跡與分析軌跡的 Param 中新增參數 district

• 3/5 API名稱修改：
  獲取所有軌跡 → 獲取所有辨識紀錄
  獲取軌跡(透過事件ID) → 獲取辨識紀錄(透過事件ID)
  新增軌跡 → 新增辨識紀錄

• 3/5 增加查詢軌跡與分析軌跡中的 query string 參數是否必填欄位

• 3/5 修改查詢軌跡與分析軌跡中的 query string 參數說明：
  機關 → 分局
  單位 → 派出所

• 2/23 將變數名稱更改與 SQLite 小組一樣

• 2/19 獲取所有軌跡 URI 修改：
  /api/tracks → /api/tracks/events

• 2/19 獲取軌跡(透過事件ID) URI 修改：
  /api/tracks/<event_id> → /api/tracks/events/:event_id

• 2/19 新增軌跡 URI 修改：
  /api/tracks/<event_id> → /api/tracks/events/:event_id