《T-CSPIA 008-2022 視頻圖像目標(biāo)聚類服務(wù)技術(shù)要求》

ICS13.310

CCSA91CSPIA

團體標(biāo)準(zhǔn)

T/CSPIA008-2022

視頻圖像目標(biāo)聚類服務(wù)技術(shù)要求

Technicalrequirementsforobjectclusteringservicebased

onvideoandimage

2022-08-30發(fā)布2022-08-30實施

中國安全防范產(chǎn)品行業(yè)協(xié)會發(fā)布

T/CSPIA008-2022

視頻圖像目標(biāo)聚類服務(wù)技術(shù)要求

1范圍

本文件規(guī)定了安全防范領(lǐng)域基于視頻圖像目標(biāo)聚類服務(wù)的功能組成、功能要求和性能要求。

本文件適用于安全防范領(lǐng)域基于視頻圖像目標(biāo)聚類服務(wù)的規(guī)劃設(shè)計、開發(fā)應(yīng)用、檢測驗收。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T28181公共安全視頻監(jiān)控聯(lián)網(wǎng)系統(tǒng)信息傳輸、交換、控制技術(shù)要求

GA/T543.1公安數(shù)據(jù)元（1）

GA/T1399-2017（所有部分）公安視頻圖像分析系統(tǒng)

GA/T1400.1-2017公安視頻圖像信息應(yīng)用系統(tǒng)第1部分：通用技術(shù)要求

GA/T1400.3-2017公安視頻圖像信息應(yīng)用系統(tǒng)第3部分：數(shù)據(jù)庫技術(shù)要求

GA/T1400.4-2017公安視頻圖像信息應(yīng)用系統(tǒng)第4部分：接口協(xié)議要求

IETFRFC2616超文本傳輸協(xié)議-HTTP/1.1(HypertextTransferProtocol-HTTP/1.1)

3術(shù)語、定義和縮略語

3.1術(shù)語和定義

GA/T1399.1-2017、GA/T1400.1—2017界定的以及下列術(shù)語和定義適用于本文件。

3.1.1

視頻圖像目標(biāo)videoandimageobject

視頻圖像中的人員、人臉、機動車、非機動車、物體等特定對象。

3.1.2

目標(biāo)聚合objectaggregating

通過目標(biāo)特征向量相似度計算等分析方法將特定視頻圖像目標(biāo)根據(jù)相似程度歸類的過程。

3.1.3

目標(biāo)歸檔objectarchiving

通過比對、關(guān)聯(lián)、合并等方法將目標(biāo)聚合結(jié)果形成包含特定目標(biāo)基礎(chǔ)信息和明細信息的目標(biāo)檔案的

過程。

3.1.4

1

T/CSPIA008-2022

目標(biāo)檔案庫objectarchivalrepository

存儲目標(biāo)檔案的數(shù)據(jù)庫。

3.1.5

目標(biāo)聚類服務(wù)objectclusteringservice

具有視頻圖像目標(biāo)聚合、目標(biāo)歸檔能力及相應(yīng)管理和接口功能的服務(wù)。

3.1.6

輔助聚合auxiliaryaggregating

根據(jù)目標(biāo)的時空、屬性、身份等信息輔助目標(biāo)聚合的過程。

3.1.7

關(guān)聯(lián)聚合associationaggregating

根據(jù)目標(biāo)關(guān)聯(lián)的視頻圖像、社會屬性等信息輔助目標(biāo)聚合的過程。

3.1.8

目標(biāo)建檔objectarchivesbuilding

建立目標(biāo)檔案的過程。

3.1.9

歸檔合并mergearchiving

對多個目標(biāo)檔案進行合并的過程。

3.1.10

歸檔置信archiveidentifying

對檔案目標(biāo)進行身份信息查驗的過程。

3.1.11

聚類精確率precisionrate

對于給定的視頻圖像數(shù)據(jù)集合，聚類后，目標(biāo)檔案內(nèi)正確的樣本數(shù)占該檔案總樣本數(shù)的比例。計算

公式見附錄A中A.1。

3.1.12

聚類召回率recallrate

對于給定的視頻圖像數(shù)據(jù)集合，聚類后，目標(biāo)檔案內(nèi)正確的樣本數(shù)占該目標(biāo)實際應(yīng)被聚類正確的樣

本數(shù)的比例。計算公式見附錄A中A.2。

3.1.13

聚類擴散率diffusionrate

對于給定的視頻圖像數(shù)據(jù)集合，聚合歸類后，樣本形成的檔案個數(shù)與樣本實際類別數(shù)的比值。計算

公式見附錄A中A.3。

3.1.14

2

T/CSPIA008-2022

聚類率clusterrate

對于給定的視頻圖像數(shù)據(jù)集合，聚合歸類后，形成檔案的樣本數(shù)占數(shù)據(jù)集合樣本總數(shù)的比例。計算

公式見附錄A中A.4。

3.2縮略語

下列符合和縮略語適用于本文件。

REST：表述性狀態(tài)傳遞（RepresentationalStateTransfer）

HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）

URI：全局資源標(biāo)識符（UniversalResourceIdentifier)

4功能組成

4.1目標(biāo)聚類服務(wù)由目標(biāo)聚合、目標(biāo)歸檔、目標(biāo)檔案庫、管理功能和接口功能等幾部分組成，應(yīng)符合圖

1的要求。

圖1目標(biāo)聚類服務(wù)功能組成

4.2目標(biāo)聚合包括全量聚合、增量聚合、輔助聚合、關(guān)聯(lián)聚合等功能。

4.3目標(biāo)歸檔包括目標(biāo)建檔、歸檔合并、歸檔置信等功能。

4.4目標(biāo)檔案庫由檔案基礎(chǔ)信息和檔案明細信息組成。

4.5管理功能包括任務(wù)管理、級聯(lián)管理、統(tǒng)計管理等功能。

4.6接口功能包括采集接口、分析接口、數(shù)據(jù)服務(wù)接口、級聯(lián)接口。

5功能要求

5.1目標(biāo)聚合

目標(biāo)聚合符合以下要求：

a)應(yīng)支持全量聚合功能，支持對某一批次圖像集合、視頻片段集合中的視頻圖像目標(biāo)進行全量聚

合形成目標(biāo)類，支持將多個類合并為一個類；

3

T/CSPIA008-2022

b)應(yīng)支持增量聚合功能，支持對持續(xù)更新的視頻流、圖像流或者視頻片段集合進行增量聚合形成

目標(biāo)類，并將持續(xù)增量聚合形成的目標(biāo)類與已聚合的目標(biāo)類進行類合并，形成持續(xù)增量更新的

目標(biāo)類；

c)宜支持輔助聚合功能，支持結(jié)合視頻圖像目標(biāo)的抓拍時間、設(shè)備經(jīng)緯度、顏色、姿態(tài)、尺寸、

光照、角度、截斷、身份置信信息等屬性進行輔助聚合；

d)宜支持關(guān)聯(lián)聚合功能，支持結(jié)合視頻圖像目標(biāo)的伴隨關(guān)聯(lián)、駕乘關(guān)聯(lián)、攜帶物、職業(yè)、學(xué)歷、

專業(yè)等屬性進行關(guān)聯(lián)聚合。

5.2目標(biāo)歸檔

目標(biāo)歸檔符合以下要求：

a)應(yīng)支持全量聚合結(jié)果建檔，支持按照目標(biāo)檔案的結(jié)構(gòu)要求形成目標(biāo)的檔案基礎(chǔ)信息和檔案明

細信息并進行組裝，形成目標(biāo)檔案；

b)應(yīng)支持增量聚合結(jié)果歸檔合并和多級聚合結(jié)果歸檔合并，支持未置信但攜帶類代表圖片（能代

表對象檔案的一個或多個圖片）或者類中心特征的目標(biāo)檔案歸檔合并，支持已置信目標(biāo)檔案歸

檔合并；

c)應(yīng)支持對目標(biāo)檔案進行置信，將置信結(jié)果記錄到檔案基礎(chǔ)信息中；

d)宜支持基于目標(biāo)檔案進行共性模型分析和自定義模型分析。

5.3目標(biāo)檔案庫

目標(biāo)檔案庫符合以下要求：

a）應(yīng)支持目標(biāo)檔案庫的增加、刪除、修改和查詢等功能，接口應(yīng)符合附錄B中B.5的規(guī)定；

b）目標(biāo)檔案庫中的檔案應(yīng)包含檔案基礎(chǔ)信息和檔案明細信息；

c）檔案基礎(chǔ)信息應(yīng)包含檔案名稱、基本屬性、目標(biāo)類代表、典型圖像等信息，宜包含目標(biāo)置信信

息；

d）檔案明細信息應(yīng)包含圖像、特征向量、擴展屬性、目標(biāo)標(biāo)簽、目標(biāo)位置、采集時間、采集地點

等信息；運動目標(biāo)宜包含時間、經(jīng)緯度、行政區(qū)劃等時空信息和軌跡信息；

e）應(yīng)支持目標(biāo)檔案庫中檔案的新建、更新、合并、拆分、刪除和查詢等功能，接口應(yīng)符合附錄B中

B.9、B.10的規(guī)定；

f）應(yīng)支持目標(biāo)檔案庫中檔案明細信息的增加、更新、刪除和查詢等功能，接口應(yīng)符合附錄B中B.11、

B.12的規(guī)定；

g）應(yīng)支持條件檢索、屬性查詢和以圖像搜檔案等功能。

5.4管理功能

5.4.1任務(wù)管理

任務(wù)管理符合以下要求：

a)應(yīng)支持創(chuàng)建、編輯、刪除和啟停目標(biāo)聚類任務(wù)，接口應(yīng)符合附錄B中B.6的規(guī)定；

b)宜支持設(shè)置任務(wù)歸檔時刻、歸檔方式等關(guān)鍵參數(shù)。

5.4.2級聯(lián)管理

級聯(lián)管理符合以下要求：

a)應(yīng)支持目標(biāo)檔案庫級聯(lián)，應(yīng)支持對上下級目標(biāo)檔案庫之間進行檔案數(shù)據(jù)的訂閱通知和查詢，接

口應(yīng)符合附錄B中B.7、B.8和附錄B中B.9、B.11的規(guī)定；

4

T/CSPIA008-2022

b)應(yīng)支持級聯(lián)訂閱數(shù)據(jù)的推送管理。

5.4.3統(tǒng)計管理

檔案數(shù)據(jù)統(tǒng)計管理符合以下要求：

a)應(yīng)支持按小時、天、周、月、季、年和總數(shù)統(tǒng)計檔案數(shù)據(jù)，應(yīng)支持按置信主題庫統(tǒng)計檔案數(shù)據(jù)；

b)應(yīng)支持按小時、天、周、月、季、年和總數(shù)統(tǒng)計檔案數(shù)據(jù)明細信息，宜支持按置信主題庫統(tǒng)計

檔案數(shù)據(jù)明細信息；

c)應(yīng)支持已置信檔案數(shù)據(jù)統(tǒng)計。

5.5接口功能

5.5.1協(xié)議結(jié)構(gòu)

a)接口協(xié)議結(jié)構(gòu)應(yīng)符合GA/T1400.1—2017的規(guī)定；

b)所有接口交互信息定義為RESTful架構(gòu)下的資源，使用URI唯一標(biāo)識，通過HTTP/HTTPS的方法實

現(xiàn)；

c)接口消息體通常情況下應(yīng)采用JSON進行封裝，消息通用頭部應(yīng)符合附錄B的要求；

d)接口交互連接方式應(yīng)支持HTTP長連接和短連接，實現(xiàn)機制應(yīng)符合IETFRFC2616中的相關(guān)規(guī)定。

5.5.2公共功能

實現(xiàn)聚類服務(wù)與其他服務(wù)之間，下級聚類服務(wù)與上級聚類服務(wù)之間的注冊、注銷、保活、校時，應(yīng)

符合GA/T1400.4-2017中5.1的規(guī)定。

5.5.3采集接口

實現(xiàn)視頻圖像信息的自動采集，應(yīng)符合GA/T1400.4-2017中5.2的規(guī)定。

5.5.4分析接口

實現(xiàn)與其他服務(wù)之間進行視頻圖像分析任務(wù)的操作。應(yīng)符合GA/T1400.4-2017中5.5的規(guī)定。增加

和更新的接口見附錄B中B.6。

5.5.5數(shù)據(jù)服務(wù)接口

實現(xiàn)與其他服務(wù)之間數(shù)據(jù)的查詢、訂閱與通知等交互。應(yīng)符合GA/T1400.4-20175.3中的規(guī)定。增

加和更新的接口見附錄B中B.5、B.7、B.8、B.9、B.10、B.11、B.12。

5.5.6級聯(lián)接口

實現(xiàn)上下級之間數(shù)據(jù)的交互。應(yīng)符合GA/T1400.4-2017中5.4的規(guī)定。增加和更新的接口見附錄B中

B.7、B.8、B.9、B.10。

5.5.7接口資源描述

聚類服務(wù)接口資源請求URI見表1。

表1接口資源請求URI

序號服務(wù)URI說明

1/VIAS/Tasks聚類任務(wù)資源

5

T/CSPIA008-2022

2/VIID/ProfileLibrarys目標(biāo)檔案庫資源

3/VIID/Subscribes訂閱資源

4/VIID/SubscribeNotifications訂閱通知資源

5/VIID/Profiles檔案資源

6/VIID/ProfilesQuerySync檔案查詢資源

7/VIID/ProfileSubjects檔案明細信息資源

8/VIID/ProfileDetailInfoQuerySync檔案明細信息查詢資源

6性能要求

6.1聚類效果

聚類效果應(yīng)滿足實際應(yīng)用要求，有效利用應(yīng)用場景采集的圖像數(shù)據(jù)。根據(jù)目標(biāo)規(guī)模大小制定相應(yīng)的

指標(biāo)，指標(biāo)應(yīng)符合表2的要求。

表2目標(biāo)聚類服務(wù)聚類效果指標(biāo)

聚類目標(biāo)規(guī)模數(shù)據(jù)聚類精確率聚類召回率聚類擴散率聚類率

百萬級≥99%≥90%≤150%≥60%

千萬級≥95%≥85%≤150%≥55%

6.2聚類效率

聚類效率應(yīng)符合以下要求：

a)在百萬級目標(biāo)檔案規(guī)模上進行百萬級圖片數(shù)據(jù)增量聚類的時間應(yīng)不超過1h；在千萬級目標(biāo)檔案

規(guī)模上進行千萬級圖片數(shù)據(jù)增量聚類的時間應(yīng)不超過4h；

b)聚類數(shù)據(jù)基礎(chǔ)信息檢索、以圖像搜檔案、全文檢索等檢索功能，檢索響應(yīng)時間應(yīng)不超過5s；宜

不超過3s。

6.3存儲時間

檔案明細信息存儲時間應(yīng)不低于6個月，檔案基礎(chǔ)信息宜長期存儲。

6

T/CSPIA008-2022

附錄A

（資料性）

評價指標(biāo)說明

A.1聚類精確率

計算公式：假設(shè)抽取的檔案個數(shù)為N，每個檔案內(nèi)和目標(biāo)圖片為同類的個數(shù)為TP，檔案內(nèi)錯誤樣

本個數(shù)為FP，檔案內(nèi)總樣本數(shù)為M，則單個檔案精確率為：

????

?????????==

???+???

總體的精確率為：

?

∑???

precision=?

∑??

A.2聚類召回率

計算公式：假設(shè)抽取的檔案個數(shù)為N，每個檔案內(nèi)和目標(biāo)圖片為同類的個數(shù)為TP，目標(biāo)實際的樣

本數(shù)為W，未被聚類到該檔案的樣本數(shù)為FN，則單個檔案召回率為：

????

??????==

???+???

總體的召回率為：

?

∑???

recall=?

∑??

A.3聚類擴散率

計算公式：假設(shè)樣本集合中實際類別數(shù)為G，C表示聚合歸檔后的檔案個數(shù)，則聚類擴散率為：

?

?????????=

?

A.4聚類率

計算公式：假設(shè)總樣本數(shù)為W，未被成功聚類的孤立樣本數(shù)為S，則聚類率為：

???

cluster=

?

7

T/CSPIA008-2022

示例1：

如上圖所示，總樣本數(shù)為46，一共有黑色正方形、白色三角形、黑色圓形、黑色三角形4種類型

的樣本，聚類結(jié)果為A、B、C、D四個檔案，則有

8+11+10+1

precision==0.909

9+13+10+1

8+11+10+1

recall==0.652

10+17+16+3

diffusion=4/4=1

46?13

cluster==0.717

46

8

T/CSPIA008-2022

示例2：

如上圖所示，總樣本數(shù)為48，一共有黑色正方形、白色三角形、黑色圓形、黑色三角形4種類型

的樣本，聚類結(jié)果為A、B、C、D、E五個檔案，E視為C的分裂檔案，不納入C檔案的統(tǒng)計內(nèi)，則有

7+10+9+2

precision==0.875

8+12+9+3

7+10+9+2

recall==0.583

9+17+18+4

diffusion=5/4=1.25

48?13

cluster==0.729

48

9

T/CSPIA008-2022

附錄B

（規(guī)范性）

接口定義

B.1HTTP消息通用請求頭部

HTTP消息通用請求頭部應(yīng)符合表B.1的要求。

表B.1HTTP消息通用請求頭字段

HeaderNameDescription

User-Identify系統(tǒng)ID，用于標(biāo)識請求者，必須攜帶

Client-IP客戶端IP，指第三方系統(tǒng)面向的客戶端IP

Content-Type消息體的類型，如:application/VIID+JSON

Content-Length消息體的長度，不包括請求頭部

Date請求端的當(dāng)前本地時間，例如:Sat,31Dec201523:59:59GMT

Host服務(wù)器的域名或IP地址，如0

ServerID可選，目標(biāo)系統(tǒng)ID，應(yīng)符合GB/T28181中E.1的要求

B.2HTTP消息通用響應(yīng)頭部

HTTP消息通用響應(yīng)頭部見應(yīng)符合表B.2的要求。

表B.2HTTP消息通用響應(yīng)頭字段

HeaderNameDescription

Content-Length消息體的長度，不包括請求頭部

Content-Type消息體的類型:application/VIID+JSON;charset=UTF-8

Date請求端的當(dāng)前本地時間，例如:Sat,12Dec201412:00:00GMT

Server響應(yīng)該請求的服務(wù)器的域名或IP地址

B.3HTTP常見響應(yīng)狀態(tài)碼

HTTP常見響應(yīng)狀態(tài)代碼應(yīng)符合表B.3的要求。

表B.3HTTP常見響應(yīng)狀態(tài)代碼

Status-CodeDescription

200OK請求成功

201Created創(chuàng)建成功

302Found請求的資源臨時具有不同URI（重定向）

400BadRequest請求的語法不對，報文格式錯誤

401Unauthorized無權(quán)訪問該資源，請求需要用戶授權(quán)

403Forbidden服務(wù)器拒絕該請求，一般為賬號異常

404NotFound:服務(wù)器沒有找到與請求URI相符的資源

500InternalServerError服務(wù)器發(fā)生了不可預(yù)期的錯誤

503ServerUnavailable服務(wù)器請求暫時不可用

B.4數(shù)據(jù)編碼規(guī)范

數(shù)據(jù)包默認格式為JSON格式，輸出內(nèi)容使用UTF-8編碼。

B.5目標(biāo)檔案庫增加、查詢、更新、刪除接口

10

T/CSPIA008-2022

批量目標(biāo)檔案庫增加、查詢、更新、刪除接口消息應(yīng)符合表B.4的要求。

表B.4批量目標(biāo)檔案庫增加、查詢、更新、刪除消息

URI/VIID/ProfileLibrarys

功能增加、查詢、更新、刪除目標(biāo)檔案庫，支持批量操作

方法查詢字符串請求消息體返回消息體

POST無<ProfileLibraryList><ResponseStatusList>

GETProfileLibrary屬性鍵/值對無<ProfileLibraryList>

PUT無<ProfileLibraryList><ResponseStatusList>

DELETE鍵為IDList，值為用英文半角逗號”,”無<ResponseStatusList>

分隔的ProfileLibraryID字符串

注釋ProfileLibrary、ProfileLibraryList的定義應(yīng)符合附錄C中C.1相關(guān)定義

B.6聚類任務(wù)增加、查詢、更新、刪除接口

批量聚類任務(wù)增加、查詢、更新、刪除接口消息應(yīng)符合表B.5的要求。

表B.5批量聚類任務(wù)增加、查詢、更新、刪除消息

URI/VIAS/Tasks

功能增加、查詢、更新、刪除聚類任務(wù)，支持批量操作

方法查詢字符串請求消息體返回消息體

POST無<TaskList><ResponseStatusList>

GETTask屬性鍵/值對無<TaskList>

PUT無<TaskList><ResponseStatusList>

DELETE鍵為IDList，值為用英文半角逗號”,”無<ResponseStatusList>

分隔的TaskID的字符串

注釋1.Task、TaskList的定義應(yīng)符合GA/T1399-2017（所有部分）中的規(guī)定；

2.Task中EventType新增目標(biāo)聚類任務(wù)類型，見附錄D中表D.1；

3.Task中AnalysisRule中新增目標(biāo)檔案庫字段：ProfileLibraryID

B.7檔案和軌跡訂閱接口

檔案和軌跡訂閱接口消息應(yīng)符合表B.6的要求。

表B.6檔案和軌跡訂閱消息

URI/VIID/Subscribes

功能增加訂閱對象，實現(xiàn)對視頻圖像信息對象等的訂閱，支持批量操作

方法查詢字符串請求消息體返回消息體

POST無<SubscribeList><ResponseStatusList>

1.Subscribe、SubscribeList的定義應(yīng)符合GA/T1400.3-2017中的規(guī)定；

注釋

2.SubscribeDetailType字段新增2個枚舉，見附錄D中表D.2

B.8檔案和軌跡通知接口

檔案和軌跡通知接口消息應(yīng)符合表B.7的要求。

表B.7檔案和軌跡通知消息

URI/VIID/SubscribeNotifications

功能增加通知對象，實現(xiàn)向訂閱發(fā)出方上報通知信息

方法查詢字符串請求消息體返回消息體

11

T/CSPIA008-2022

POST無<SubscribeNotificationList><ResponseStatusList>

1.SubscribeNotification、SubscribeNotificationList的定義應(yīng)符合GA/T1400.3-2017中的規(guī)定；

注釋2.SubscribeNotification中新增加"ProfileObjectList"、"ProfileSubjectInfoList"（檔案對象列

表、檔案明細對象列表）

B.9檔案查詢接口

檔案查詢接口消息應(yīng)符合表B.8的要求。

表B.8檔案查詢消息

URI/VIID/ProfilesQuerySync

功能查詢檔案對象信息，用于上級向下級發(fā)送檔案查詢請求操作

方法查詢字符串請求消息體返回消息體

POST無<ProfileQuery><ProfileQueryResult>

1.ProfileQuery的定義應(yīng)符合附錄C中C.4相關(guān)定義；

注釋

2.ProfileQueryResult的定義應(yīng)符合附錄C中C.6相關(guān)定義

B.10檔案增加、更新、刪除接口

批量檔案的增加、更新、刪除接口消息應(yīng)符合表B.9的要求。

表B.9批量檔案的增加、更新、刪除消息

URI/VIID/Profiles

功能增加、更新、刪除檔案對象，支持批量操作

方法查詢字符串請求消息體返回消息體

POST無<ProfileList><ResponseStatusList>

PUT無<ProfileList><ResponseStatusList>

鍵為IDList，值為英文半角逗號“,”

DELETE無<ResponseStatusList>

分隔的ProfileID字符串

注釋Profile、ProfileList的定義應(yīng)符合附錄C中C.2相關(guān)定義

B.11檔案明細查詢接口

檔案明細查詢接口消息應(yīng)符合表B.10的要求。

表B.10檔案明細查詢消息

URI/VIID/ProfileSubjectQuerySync

功能查詢檔案明細信息，用于上級向下級發(fā)送檔案明細查詢請求操作

方法查詢字符串請求消息體返回消息體

POST無<ProfileSubjectQuery><ProfileSubjectQueryResults>

1.ProfileSubjectQuery的定義應(yīng)符合附錄C中C.7相關(guān)要求；

注釋

2.ProfileSubjectQueryResults的定義應(yīng)符合附錄C中C.8相關(guān)要求

B.12檔案明細增加、更新、刪除接口

批量檔案明細增加、更新、刪除接口消息應(yīng)符合表B.11的要求。

表B.11批量檔案明細增加、更新、刪除消息

URI/VIID/ProfileSubjects

功能增加、更新、刪除檔案明細對象，支持批量操作

方法查詢字符串請求消息體返回消息體

POST無<ProfileSubjectList><ResponseStatusList>

PUT無<ProfileSubjectList><ResponseStatusList>

12

T/CSPIA008-2022

鍵為ProfileID、FaceIDList、

DELETEPersonIDList，值為英文半角逗號無<ResponseStatusList>

“,”分隔的字符串

注釋ProfileSubject、ProfileSubjectList的定義應(yīng)符合附錄C中C.3相關(guān)要求

13

T/CSPIA008-2022

附錄C

（規(guī)范性）

消息體定義

下列表中必選/可選字符說明：R=requirement表示必選字段；O=Option表示可選字段；R/O表示

特定條件下必選,其他可選。

C.1目標(biāo)檔案庫對象ProfileLibrary

目標(biāo)檔案庫對象特征屬性見表C.1。

表C.1目標(biāo)檔案庫對象特征屬性

序必選/

名稱標(biāo)識符類型XML/JSON長度備注

號可選

目標(biāo)檔案ProfileObjectIdType類型的目標(biāo)

1ProfileLibraryIDProfileObjectIdTypeR

庫標(biāo)識檔案庫ID

2名稱Namestring32R目標(biāo)檔案庫的名稱

3創(chuàng)建時間CreateTimedatetimeR創(chuàng)建時間

4備注Memostring1024O目標(biāo)檔案庫的備注信息

C.2檔案對象Profile

檔案對象特征屬性見表C.2。

表C.2檔案對象特征屬性

序必選/

名稱標(biāo)識符類型XML/JSON長度備注

號可選

ProfileObjectIdType類型的檔案

1檔案標(biāo)識ProfileIDProfileObjectIdTypeR

ID

所屬目標(biāo)

2ProfileLibraryIDProfileObjectIdTypeR檔案所屬的目標(biāo)檔案庫ID

檔案庫

實名檔案必填；

檔案查詢結(jié)果返回時，此字段不填；

3證件類型IDTypeIDType3R/O

IDType類型應(yīng)符合GA/T1400.3-

2017中表B.2相關(guān)描述

實名檔案的必填；

檔案查詢結(jié)果返回時，此字段不填；

4證件編號IDNumberIDNumberTypeR/O

IDNumberType類型應(yīng)符合GA/T

1400.3-2017中表B.2相關(guān)描述

人員的中文姓名全稱；

5姓名NameNameTypeONameType類型應(yīng)符合GA/T

1400.3-2017中表B.2相關(guān)描述

6出生日期BirthTimedateTimeO

GenderType類型應(yīng)符合GA/T

7性別代碼GenderCodeGenderTypeO

1400.3-2017中附錄表B.2相關(guān)描述

檔案查詢結(jié)果返回時，此字段不填；

8民族代碼EthicCodeEthicCodeTypeOEthicCodeType類型應(yīng)符合GA/T

1400.3-2017中表B.2相關(guān)描述

14

T/CSPIA008-2022

NationalityCodeType類型應(yīng)符合

9國籍代碼NationalityCodeNationalityCodeTypeOGA/T1400.3-2017中表B.2相關(guān)描

述

籍貫省市

PlaceCodeType類型應(yīng)符合GA/T

10縣NativeCityCodePlaceCodeTypeO

1400.3-2017中表B.2相關(guān)描述

代碼

居住地ResidenceAdminDiPlaceCodeType類型應(yīng)符合GA/T

11PlaceCodeTypeO

行政區(qū)劃vision1400.3-2017中表B.2相關(guān)描述

檔案創(chuàng)建

12CreateTimedateTimeO

時間

標(biāo)識檔案合并關(guān)系；

當(dāng)發(fā)生檔案合并時，由此字段給出

檔案數(shù)據(jù)ProfileObjectIdType

13SourceIDListO被合并的檔案的ProfileID；

來源List

如果沒有發(fā)生檔案合并，則指向本

檔案的ProfileID

檔案類中CenterFeatureLis

14FeatureInfoListO最能表征檔案的一組特征向量

心特征t

標(biāo)識檔案對象的標(biāo)簽列表，例如吸

15標(biāo)簽TagsstringListO

毒人員、販毒人員、前科人員等

詳細居住地址；

PlaceFullAddressTypPlaceFullAddressType類型應(yīng)符合

16居住地址PlaceFullAddressO

eGA/T1400.3-2017中表B.2相關(guān)描

述

圖片與檔案的比對相似度，取值

17相似度SimilaritydegreedoubleR/O[0-1]，值越高說明結(jié)果越可信；

以圖像搜檔案返回結(jié)果中必選

檔案置信的比對相似度，取值[0-

18置信度ConfidencedoubleR/O1]，值越高說明結(jié)果越可信；檔

案置信后必選。

能代表檔案的人臉/人員/其他圖片

信息列表；

圖像對象中的Type枚舉取值：10為