行人重識別服務

適用情境應用：人流計數、特定行人追蹤。

應用場域

AI行人識別能快速計算人流計數

出入口人流計數

使用行人識別服務，能快速計算出畫面中人數及行人位置，運此辨識功能可匯入即有的監視影像，實作人流計數功能。
透過行人重識別能進行特定人物識別比對

特定行人比對

每當匯入照片後，系統會給定唯一ID，當需要比對畫面中是否為指定人物時，可透過行人重識別服務立即得知結果，做為後續系統判斷依據。

行人比對API使用方式

當應用場域無法使用人臉做精確比對或是僅需要概略知道人潮狀況時，可使用可使用行人比對服務做行人整體外觀的比對，透過API [“add_person”] 建立專屬行人資料庫，當資料庫建立後，透過API [“find_person”] 輸入行人照片， 即能比對是否為專屬行人資料庫中的行人。

❖注意：若行人外顯特徵變化 (如：穿外套)，將被視為不同人，因此該服務不適合作為重要判斷使用。

人物識別與行人比對的API使用方式
透過API判別指定人物

新增行人至比對資料庫

透過 [“add_person”] 將行人資訊建立至專屬資料庫，建立完成後，系統將回應該圖片中所有行人位置以及特徵編號(ID)，特徵編號為唯一碼，可用於特定人物特徵比對使用；當匯入圖片中有多筆行人時，可透過回傳座標來確認行人對應之唯一碼。

行人圖片範例：
[“add_person”] 僅支援單一行人辨識，匯入圖片前，需將行人單獨裁切如下左圖，若需要協助辨識截圖範圍，可參考運用物件辨識API [“object_detection”] 擷取person位置，即可找出人物在照片中的特定位置。

行人重辨識需提供裁切圖

HTTP方法與請求網址：

POST https://saas.intemotech.com/saasapi/detect

Content-type

application/form-data

請求from-data正文：

KEYVALUE
file匯入照片檔案 (image)
api_name[“add_person”] (string)

cURL：

curl --location --request POST 'https://saas.intemotech.com/saasapi/detect' \
--header 'Authorization: Bearer <TOKEN>' \
--form 'api_name="[\"add_person\"]"' \
--form 'file=@"/xxxx.png"'

辨識結果文本：

{
    "data": [
        {
            "add_person": [
                {
                    "count": 1,
                    "person_id": "14"
                }
            ]
        }
    ],
    "states": "Sucessfully"
}
欄位名稱欄位說明
add_person加入行人資料庫
person_id行人特徵ID，可做為確認行人時的唯一值
states新增行人成功、失敗
回傳欄位說明

比對資料庫行人

當需要確認目前圖片中是否有資料庫中的特定行人時，透過 [“find_person”] API將單一張圖片資訊傳送至iSeek平台，平台會比對使用 [“add_person”] 中所建立的行人資料庫內，最相近的行人前五名，並依照信心值由排序(數字越小代表越相近)。

HTTP方法與請求網址：

POST https://saas.intemotech.com/saasapi/detect

Content-type

application/form-data

請求from-data正文：

KEYVALUE
file匯入照片檔案，支援格式：JPG、PNG、JPEG (image)
api_name[“find_person”] (string)

cURL：

curl --location --request POST 'https://saas.intemotech.com/saasapi/detect' \
--header 'Authorization: Bearer <TOKEN>' \
--form 'file=@"/xxx.png"' \
--form 'api_name="[\"find_person\"]"'

辨識回覆文本：

{
    "data": [
        {
            "find_person": [
                {
                    "count": 1,
                    "data": [
                        {
                            "id": "15",
                            "p": 13.9427569425831
                        },
                        {
                            "id": "12",
                            "p": 15.0301023601303
                        },
                        {
                            "id": "13",
                            "p": 15.0301023601303
                        },
                        {
                            "id": "14",
                            "p": 19.0816949283287
                        },
                        {
                            "id": "11",
                            "p": 20.241345199024
                        }
                    ]
                }
            ]
        }
    ],
    "states": "Sucessfully"
}
欄位名稱欄位說明
find_person行人比對
data該位置行人比對結果
id資料庫行人編號
p與現有行人特徵相符分數，分數越接近0表示越相近
states回應成功、失敗
回傳欄位說明

刪除資料庫行人

當要刪除資料庫中特定行人時，可透過 [“del_person”] API指定ID將行人刪除。

HTTP方法與請求網址：

DELETE https://saas.intemotech.com/saasapi/detect

Content-type

application/form-data

請求from-data正文：

KEYVALUE
value刪除person ID (array)
api_namedel_person (string)

cURL：

curl --location -g --request DELETE 'https://saas.intemotech.com/saasapi/detect?api_name=del_person&value=[18,17]' \
--header 'Authorization: Bearer <TOKEN>' \

辨識回覆文本：

{
    "data": [
        {
            "del_persons": {
                "msg": [
                    "del:18",
                    "del:17"
                ]
            }
        }
    ],
    "states": "Sucessfully"
}
欄位名稱欄位說明
del_persons刪除行人
msg刪除行人列表
del刪除行人ID
states回應成功、失敗
回傳欄位說明