GA/T 1326-2017
标准分类号
关联标准
出版信息
相关单位信息
标准简介
GA/T 1326-2017.Security protection-Face recognition applications-API specifications.
1范围
GA/T 1326规定了安全防范系统人脸识别应用程序接口方面的人脸采集、人脸识别算法、应用服务接口的文件格式与接口规范,规范了安防人脸识别应用系统人脸采集接口、人脸识别算法接口以及人脸识别服务接口。
GA/T 1326适用于安全防范系统人脸识别应用中的图像采集、数据处理、网络服务等接口的技术方案设计及系统的研发与应用等方面。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。
GA/T893-2010安防生物特征识别应用术语
3术语和定义
3.1术语和定义
GA/T 893一2010 界定的以及下列术语和定义适用于本文件。
3.1.1人脸采集设备face capture device
用于采集人脸图像或视频的设备。
3.1.2名单型人脸识别watch list based face recognition
判别一个未知身份的待测人脸样本是否在监视名单上。如果判断待测人脸样本在监视名单上,则将确定该待测人脸样本的身份。
4基本数据类型
4.1基本数据类型描述;
基本数据类型用于规范接口传递数据过程中的数据形式,采用8字节对齐方式,当可无效成员"无效时,整型类、浮点数类赋值为一1.指针类赋值为NULL。
标准内容
ICS13.310
中华人民共和国公共安全行业标准GA/T1326—2017
安全防范
人脸识别应用
程序接口规范
Security protectionFace recognition applications-API specifications
2017-10-08发布
中华人民共和国公安部
2017-12-01实施
GA/T1326—2017
规范性引用文件
术语和定义
基本数据类型
应用程序接口
6接口安全策略要求
接口返回值代码
附录A(规范性附录)
附录B(规范性附录)
附录C(规范性附录)
动态链接库文件名称
人脸识别应用服务结构
附录D(资料性附录)示例代码
参考文献
本标准按照GB/T1.12009给出的规则起草GA/T1326—2017
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本标准由全国安全防范报警系统标准化技术委员会人体生物特征识别应用分技术委员会(SAC/TC100/SC2)提出并归口。
本标准起草单位:清华大学、公安部第一研究所,杭州海康威视数字技术股份有限公司,中国科学院自动化研究所、国防科技大学、中国科学院计算技术研究所、北京海鑫科金高科技股份有限公司、广州像素数据技术股份有限公司,上海银晨智能识别科技有限公司,浙江天华技术股份有限公司,四川川大智胜软件股份有限公司,山西省公安厅,深圳市中控生物识别有限公司广东铂亚信息技术有限公司,江苏省公安厅、武汉市公安局、深圳市飞瑞斯科技有限公司本标准主要起草人:苏楠、陈健生、王生进、苏光大、侯鸿川、田青、刘君平、毛芳党、叶挺群、李子青、雷震、谢剑斌,山世光,王贤良、姚若光、张杰、汪海洋,曾文斌、赵军,陈书楷、简伟明、胡雷地、刘军,李璐HiiKAoNiKAca
1范围
安全防范
人脸识别应用
程序接口规范
GA/T1326—2017
本标准规定了安全防范系统人脸识别应用程序接口方面的人脸采集、人脸识别算法、应用服务接口的文件格式与接口规范,规范了安防人脸识别应用系统人脸采集接口、人脸识别算法接口以及人脸识别服务接口。
本标准适用于安全防范系统人脸识别应用中的图像采集、数据处理、网络服务等接口的技术方案设计及系统的研发与应用等方面。2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GA/T893—2010安防生物特征识别应用术语3术语和定义
3.1术语和定义
GA/T893一2010界定的以及下列术语和定义适用于本文件3.1.1
人脸采集设备facecapturedevice用于采集人脸图像或视频的设备。3.1.2
名单型人脸识别watchlistbasedfacerecognition判别一个未知身份的待测人脸样本是否在监视名单上。如果判断待测人脸样本在监视名单上,则将确定该待测人脸样本的身份。4基本数据类型
基本数据类型描述
基本数据类型用于规范接口传递数据过程中的数据形式,采用8字节对齐方式,当可无效成员1无效时,整型类、浮点数类赋值为一1,指针类赋值为NULL。4.2图像数据
用于传递单张图像相关信息,采用结构体形式。1)在接口传递数据过程中,可以不生效的数据结构成员。当可无效成员无效时,该成员所赋值无实际意义。1
-iiKAoNniKAca
GA/T1326—2017
C语言描述:
typedef structtagONEIMAGE
long long id;
int image_width;
int image_height;
int image_depth;
int image_width;
int image_height;
int image_depth;
int image_widthstep;
char format[20] :
unsigned char * data;
int data_len;
int custom_len;
void * custom;
)ONEIMAGE;
图像数据结构体成员说明见表1。表1
成员名
image_width
image_height
image_depth
image_widthstep
format
data_len
custom_len
custom
多图像数据免费标准下载网bzxz
图像数据类型结构体成员
数据类型
64位整型
32位整型
32位整型
32位整型
32位整型
字符型数组
无符号字符型指针
32位整型
32位整型
无类型指针
用于传递多个图像数据,采用结构体形式。C语言描述:
typedef struct tagMULTIIMAGEint img_num;
ONEIMAGE
MULTIIMAGE;
多图像数据结构体成员说明见表2。说
图像编号,可无效
图像水平像素数
图像垂直像素数
图像深度
存储一行像素需要的字节数
图像格式
图像数据段
图像数据段长度
自定义数据长度,可无效
自定义数据,可无效
-iKAoNniKAca
成员名
img_num
人脸位置数据
多图像数据类型结构体成员
数据类型
32位整型
图像数据类型指针
用于传递一个人脸位置信息,采用结构体形式。C语言描述:
typedef struct tagFACEROI(
long long id;
int xleft;
intyleft;
int xright;
int yright:
float qualitys
/FACEROI;
人脸位置数据结构成员说明见表3。说
图像数据数量
多个图像数据
表3人脸位置数据类型结构体成员成员名
xright
yright
quality
多人脸位置数据
64位整型
32位整型
32位整型
32位整型
32位整型
32位浮点数
数据类型
用于传递多个人脸位置数据,采用结构体形式。C语言描述:
typedef struct tagMULTIROI
introi_num;
FACEROI*roi;
IMULTIROI;
多人脸位置数据结构成员说明见表4。GA/T1326—2017
人脸位置数据编号,可无效
人脸所在区域左上角横坐标数值(以观测者视角为标准)
人脸所在区域左上角纵坐标数值人脸所在区域右下角横坐标数值人脸所在区域右下角纵坐标数值人脸质量,分值越高人脸质量越好[0.1].可无效
-iiKAoNni KAca
GA/T1326—2017
成员名
roi_num
人脸关键点数据
多人脸位置数据类型结构体成员数据类型
32位整型
人脸位置数据类型指针
用于传递一个人脸关键点位置信息,采用结构体形式。C语言描述:
typedef struct tagORGANPOSt
long long id;
intxleft;
int yleft;
int xright;
int yright:
int xchin;
int ychin;
intpoint_len;
int *point;
int custom_len;
void * custom;
ORGANPOS;
人脸关键点数据结构成员说明见表5。说
人脸位置数据数量
多个人脸位置数据
人脸关键点数据类型结构体成员表5
成员名
xright
yright
point_len
custom_len
custom
64位整型
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型
32位整型指针
32位整型
无类型指针
数据类型
人脸关键点编号,可无效
左眼睛中心横坐标数值
左眼睛中心纵坐标数值
右眼睛中心横坐标数值
右眼睛中心纵坐标数值
下颌横坐标数值,可无效
下颌纵坐标数值,可无效
其他人脸关键点数据长度
其他人脸关键点数据,按每个点先横坐标后纵坐标形式顺序排列
自定义数据长度,可无效
自定义数据,可无效
iiKANiKAca
4.7多人脸关键点数据
用于传递多个人脸关键点数据,采用结构体形式。C语言描述:
typedef struct tagMULTIPOS
int pos_num;
ORGANPOS *pOs;
MULTIPOS:
多人脸关键点数据结构成员说明见表6。多人脸关键点数据类型结构体成员表6
成员名
pos_num
4.8人脸模板数据
32位整型
数据类型
GA/T1326—2017
人脸关键点数据数量
人脸关键点数据指针
多个人脸关键点数据
人脸模板数据类型用于传递一个人脸模板信息,采用结构体形式。C语言描述:
typedef structtagFACETEMPLATE(longlong id;
int homology_id;
int feature_len;
void * feature;
int custom_len;
void * custom;
IFACETEMPLATE
人脸模板数据结构成员说明见表7。人脸模板数据类型结构体成员
成员名
homology_id
feature len
feature
custom_len
custom
4.9人脸相似度数据
64位整型
32位整型
32位整型
无类型指针
32位整型
无类型指针
数据类型
用于传递一个人脸相似度信息,采用结构体形式。说
人员编号,用于区分不同人,可无效同一身份的人对应不同模板的编号,可无效
人脸特征长度
人脸特征数据
自定义数据长度,可无效
自定义数据,可无效
GA/T1326—2017
C语言描述:
typedef structtagFACESIM(
longlong probe_id;
int probe_homology_id;
long longgallery_id;
intgallery_homology_id;
long long rank;
float result;
float probability;
int custom_len;
void *custom;
)FACESIM;
人脸相似度数据结构成员说明见表8。表8
成员名
probe_id
probe_homology_id
gallery_id
gallery_homology_id
result
probability
custom_len
custom
多人脸相似度数据
人脸相似度数据类型结构体成员数据类型
64位整型
32位整型
64位整型
32位整型
64位整型
32位浮点数
32位浮点数
32位整型
无类型指针
用于传递多个人脸相似度数据,采用结构体形式,C语言描述:
typedef struct tagMULTISIMt
long long id;
FACESIM * sim;
long long sim_num;
I MULTISIM;
多人脸相似度数据结构成员说明见表9。6
探针模板编号,可无效
同一身份的人对应不同模板的编号,可无效已知人员编号,可无效
同一已知人对应不同模板的编号,可无效相似度排名(在同一多人脸相似度数据中按相似度降序排序的位置),可无效人脸相似度,取值范围:[0~1]
同一人可能性,数值越高为同一人的可能性越大,取值范围:[0~1],可无效
自定义数据长度,可无效
自定义数据,可无效
sim_num
成员名
4.11算法模块版本信息数据
表9多人脸相似度数据类型结构体成员数据类型
64位整型
人脸相似度数据指针
64位整型
GA/T1326—2017
多人脸相似度数据编号,可无效多个人脸相似度数据
人脸相似度数据数量
用于传递人脸识别算法模块版本信息数据,采用结构体形式。C语言描述:
typedef structtagSDKINFO
int module_type;
intapi_type;
char developer_info[255];
char version_info[255];
SDKINFO;
算法模块版本信息数据结构成员说明见表10。算法模块版本信息数据类型结构体成员表10
成员名
module_type
api_type
developer_info
version_info
数据类型
32位整型
32位整型
字符型数组
字符型数组
4.12网络地址信息数据
人脸识别算法模块支持的功能,采用标志位形式,1为有效,0为无效。从右向左依次为人脸检测接口标志位:独立人脸关键点定位接口标志位:集成人脸关键点定位接口标志位,独立人脸归一化接口标志位,集成人脸归一化接口标志位;独立人脸模板提取接口标志位;集成人脸模板提取接口标志位;独立人脸相似度计算接口标志位;集成人脸相似度计算接口标志位,用户可据此规则自行扩展
人脸识别应用类型,采用标志位形式,1为有效,0为无效。从右向左依次为辨认型人脸识别标志位、确认型人脸识别标志位、名单型人脸识别标志位每种类型占用一位,用户可据此规则自行扩展
开发商信息(无则赋零)
版本信息(无则赋零)
用于传递网络地址信息数据,采用结构体形式。C语言描述:
typedef structtagADDRINFO
GA/T1326—2017
intip_type;
charip[64];
shortport;
ADDRINFO:
网络地址信息数据结构成员说明见表11。表11
成员名
ip_type
人脸采集设备信息数据
网络地址信息数据类型结构体成员数据类型
32位整型
字符型数组
16位整型
用于传递人脸采集设备的信息数据,采用结构体形式。C语言描述:
typedef struct tagDEVICEINFOchar device_name[128];
unsigned char serial_number[48];ADDRINFOaddr_info;
short device_type;
intwork_mode;
long long chan_num;
char description[256];
DEVICEINFO;
人脸采集设备信息数据结构成员说明见表12。说
IP协议类型,0:ipv4;1:ipv6
IP地址(无则赋零)
端口号
2人脸采集设备信息数据类型结构体成员成员名
device_name
serial_number
addr_info
device_type
work_mode
channel_num
description
数据类型
字符型数组
无符号字符型数组
网络地址信息数据类型
无符号字符型
32位整型
64位整型
字符型数组
设备名称(节点路径,无则赋零)序列号(无则赋零)
接人设备网络地址信息,可无效设备类型,0:usb摄像头;1网络摄像头;2:模拟摄像头,其余用户可据此规则自行扩展,可无效
人脸采集设备工作模式,人脸采集设备采集人脸信息的方式,1:静态采集模式;2:动态采集模式
设备通道个数,可无效
设备描述(无则赋零)
小提示:此标准内容仅展示完整标准里的部分截取内容,若需要完整标准请到上方自行免费下载完整标准文档。