[API] Human Detection

http://localhost:8800/human/detection/detect

描述

將已上傳Local API Server的影像(img_id)做人形偵測，並回傳結果。

參數

"img_id" - 透過storage upload上傳影像至Local API Server後，所得到的影像ID(唯一)。

"track_id" - 需要啟動人型追蹤模式時，必須帶track_id(可選擇，透過/human/detection/trackstart後可得到track_id)。但使用追蹤模式時，請依照時間前後順序執行人型偵測，因為會參考前後人型位置的關係。(可選擇)

回傳值

"namespace" - Local API Server尚未開放此功能。

"session_id" - Local API Server尚未開放此功能。

"humans" - 回傳人型偵測的結果

"human_id" - 經人形偵測後，得到的人形唯一ID。

"human_track_id" - 人形偵測且開啟人形追蹤模式時，可由此ID分辨是否為同一人，離開畫面會導致追蹤失敗，並重新給予新的ID。

"detectPos" - 人型於影像中的區域，影像座標系的(0,0)於左上角。

"state" - 回傳狀態

• STATE_SUCCESSFUL 執行成功
• STATE_FAIL 尚未分類的錯誤
• STATE_REQUEST_METHOD_ERROR Request方式不是使用POST
• STATE_PARAMETER_ERROR Request少給參數或給錯參數
• STATE_PROCESS_ERROR 人形偵測錯誤

JSON格式

{
    "humans": [{
        "angleLeftRight": 1,
        "angleRoll": 7,
        "detectPos": [
            [139, 383],
            [907, 383],
            [907, 1151],
            [139, 1151]
        ],
        "human_id": "42780824c8ff4906913c095cbc4941f2",
        "human_track_id": 0
    }],
    "namespace": "default",
    "session_id": "null",
    "state": 1000
}

[API] Create Human Tracked Detection

http://localhost:8800/human/detection/trackstart

描述

開啟人型追蹤模式，並以一組track_id代表此instance，之後人型偵測需要追蹤人型是否為同一人時，在調用人型偵測(human/detection/detect)必須帶此track_id，一般在串流模式下使用，無時間關聯性的單張影像不建議使用。使用結束後必須呼叫(human/detection/trackend)釋放該instance。可開起追蹤的數量依據序號決定。

參數

回傳值

"track_id" - 開啟追蹤模式，Local API Server回傳一組track_id。

"state" - 回傳狀態

• STATE_SUCCESSFUL 執行成功
• STATE_FAIL 尚未分類的錯誤
• STATE_REQUEST_METHOD_ERROR Request方式不是使用POST
• STATE_PARAMETER_ERROR Request少給參數或給錯參數
• STATE_PROCESS_ERROR 產生track_id發生錯誤

JSON格式

{
    "state":1000,
    "track_id":"71de818b89574a9595635272be4f52aa"
}

[API] Delete Human Tracked Detection

http://localhost:8800/human/detection/trackend

描述

不需要使用追蹤模式時，必須調用此API，將track_id傳給Local API Server刪除該instance。

參數

"track_id" - 開啟追蹤模式(human/detection/trackstart)時得到的ID。

回傳值

"state" - 回傳狀態

• STATE_SUCCESSFUL 執行成功
• STATE_FAIL 尚未分類的錯誤
• STATE_REQUEST_METHOD_ERROR Request方式不是使用POST
• STATE_PARAMETER_ERROR Request少給參數或給錯參數
• STATE_PROCESS_ERROR 刪除track_id發生錯誤

JSON格式

{
    "state":1000
}