7. 未登録者クラスタリング関連のインターフェース
7.1 未登録者クラスタリング関連の設定変更
インターフェースの説明
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
未登録者クラスタリング関連の設定を変更します。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
“1333”
Yes
interval
int
重複排除期間（単位：分） 重複排除期間のオプションは、0、1、3、5、10、30、60分で、デフォルト値は1分です。
Yes
10
threshold
int
認識の閾値
[65,100]から選択、初期値は80
Yes
70
enable
int
イネーブルスイッチ
1：有効
0：無効
Yes
1
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
json
戻りデータ
msg
string
結果の説明
リクエストの例
{
"msg_id":"1333",
"interval":10,
"threshold":80,
"enable":1
}レスポンスの例
{
"code": 0,
"data": "",
"msg": ""
}7.2 未登録者クラスタリングの設定のQuery
インターフェースの説明
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
未登録者クラスタリングの設定をQueryします。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
“1334”
Yes
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
json
戻りデータ
msg
string
結果の説明
フィールド情報(データ)
パラメーター
型
説明
enable
int
イネーブルスイッチ 1：有効
0：無効
interval
int
重複排除期間（単位：分） 重複排除期間のオプションは、0、1、3、5、10、30、60分で、デフォルト値は1分です。
threshold
int
認識の閾値
[65,100]から選択、初期値は80
リクエストの例
{
"msg_id":"1334"
}レスポンスの例
{
"code": 0,
"data": {
"enable":1,
"interval":10,
"threshold":80
},
"msg": ""
}7.3 未登録者アーカイブの詳細のページングQuery
インターフェースの説明
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
未登録者データベースに登録されている未登録者のIDをもとに、ページごとにアーカイブの詳細をQueryします。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
“1065”
Yes
person_id
string
未登録者データベースの未登録者ID
Yes
start_no
int
開始位置
デフォルト値：1
No
1
qry_len
int
Queryのアイテム数 [1,50］ デフォルト値：10
No
10
channels
string
チャンネル番号をカンマで区切ったリストで、空の場合はすべてのチャンネルをQueryします。
No
1,3,6
start_time
string
開始時刻
時間の形式：YYYY-MM-DD HH:MM:SS
No
2019-09-02 10:10:10
stop_time
string
終了時刻
時間の形式：YYYY-MM-DD HH:MM:SS
No、start_timeが指定されている場合は、stop_timeも指定する必要があります。
2019-09-02 20:20:20
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
json
戻りデータ
msg
string
結果の説明
フィールド情報(データ)
パラメーター
型
説明
record
json list
戻りデータ
result_num
int
Query結果の数
total_num
int
総レコード数
フィールド情報(レコード)
パラメーター
型
説明
camera_name
string
カメラ名
channel
int
チャンネル
値の範囲：SenseNebula Basicでは[1,16]、SenseNebula Professionalでは[1,32]
biometric_attr
json
顔属性
付録B参照
img_id
string
未登録者データベースの未登録者ID
lib_id
int
未登録者データベースID
lib_name
string
Null
lib_type
int
Null
alive_type
int
Aliveタイプ
0：不明
1：非Alive
2：Alive
appear_count
int
現在の発生件数
img_path
string
未登録者データベースの画像パス
alarm_type
int
顔認識アラートの種類
0：アラートなし
1：要注意リスト/登録者リストアラート
2：未登録者アラート
3：未登録者DBヒットアラート
event_type
int
イベントアラートの種類
0：アラートなし
1：徘徊アラート
2：ステイイングアラート
stranger_appear_channel
int
未登録者データベース画像のキャプチャーチャンネル
wander_channels
string
徘徊アラート用に設定された徘徊ワンダリングの場所
wander_deviceID
int
徘徊アラートが発生したカメラ名
wander_trigger
int
徘徊アラートのトリガー時間
position
string
カメラ位置
ranking
int
1は比較結果の中で最も高い順位を示します。
similarity
int
ランキングをマッピングした顔画像の一致度係数
値の範囲：[0,100]
snap_id
string
キャプチャーID
snap_path
string
キャプチャーパス
threshold
int
閾値
値の範囲：[0,100］
trigger
string
キャプチャー時間
リクエストの例
{
"msg_id": "1065",
"person_id": "78e0f17b-4fc4-4b22-993b-8669b9a44ce5",
"qry_len": 50,
"start_no": 1
}レスポンスの例
{
"code": 0,
"data": {
"record": [
{
"camera_name": "121",
"channel": 4,
"biometric_attr": {"cap_style": "hat_style_type_none", "gender_code": "male", "glasses_style": "glasses_style_type_none", "mustache_style": "mustache_style_none", "respirator_color": "color_type_none", "st_age": "st_adult", "st_age_value": "30.000000", "st_expression": "st_calm"},
"img_id": "78e0f17b-4fc4-4b22-993b-8669b9a44ce5",
"lib_id": 2147483647,
"lib_name": "",
"lib_type": 0,
"position": "",
"ranking": 1,
"similarity": 0,
"snap_id": "78e0f17b-4fc4-4b22-993b-8669b9a44ce5",
"snap_path": "record/channel4/biometric/78e0f17b-4fc4-4b22-993b-8669b9a44ce5.jpg",
"threshold": 85,
"trigger": "2020-03-31 13:52:49"
}
],
"result_num": 1
"total_num": 1
},
"msg": ""
}7.4 ページネーションモードで未登録者アーカイブの詳細をエクスポート
インターフェースの説明
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
ページネーションモードで未登録者アーカイブの詳細をエクスポートします。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
“2051”
Yes
person_id
string
未登録者データベースの未登録者ID
Yes
start_no
int
開始位置
デフォルト値：1
No
1
qry_len
int
Queryのアイテム数 [1,50］
デフォルト値：10
No
10
channels
string
チャンネル番号をカンマで区切ったリストで、空の場合はすべてのチャンネルをQueryします。
No
1,3,6
start_time
string
開始時刻の形式：YYYY-MM-DD HH:MM:SS
No
2019-09-02 10:10:10
stop_time
string
終了時刻の形式：YYYY-MM-DD HH:MM:SS
No、start_timeが指定されている場合は、stop_timeも指定する必要があります。
2019-09-02 20:20:20
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
json
戻りデータ
msg
string
結果の説明
フィールド情報（データ）
パラメーター
型
説明
export_url
string
エクスポートされるファイルのパス
result_num
int
Query結果の数
total_num
int
総レコード数
zippasswd
string
圧縮されたパスワード
リクエストの例
{
"msg_id": "2051",
"person_id": "78e0f17b-4fc4-4b22-993b-8669b9a44ce5",
"start_no": 1,
"qry_len": 50,
"channels": "1,3,6",
"start_time":"2019-10-16 13:20:00",
"stop_time":"2019-10-16 18:00:00"
}レスポンスの例
{
"code": 0,
"data": {
"export_url": "tmp/greylist_detail_2019-01-23-12-09-42.zip",
"result_num": 10,
"total_num": 108,
“zippasswd”:”xxxx”"
},
"msg": ""
}7.5 選択した未登録者アーカイブの詳細をエクスポート
インターフェースの説明
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
選択した未登録者アーカイブの詳細をエクスポートします。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
“2052”
Yes
person_id
string
未登録者データベースの未登録者ID
Yes
snap_ids
string
Queryで得られるキャプチャー画像のIDの集合
画像IDはカンマ[,]で区切る。画像の数は1～50個
Yes
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
json
戻りデータ
msg
string
結果の説明
フィールド情報（データ）
パラメーター
型
説明
export_url
string
エクスポートされるファイルのパス
failed_img_ids
string
エクスポートできない画像のID
result_num
int
Query結果の数
total_num
int
エクスポートされた画像の合計数
zippasswd
string
圧縮されたパスワード
リクエストの例
{
"msg_id":"2052",
"snap_ids":"74a199aa-dad7-4d3a-95f0-f74dbb818974,f12ed623-87d6-49e0-939a-97262a0407e9",
"preson_id":"74a199aa-dad7-4d3a-95f0-f74dbb818974"
}レスポンスの例
{
"code": 0,
"data": {
"export_url": "tmp/catch_2019-01-23-12-44-37.zip",
"failed_img_ids": "",
"result_num": 5,
"total_num": 5,
“zippasswd”:”xxxx”"
},
"msg": ""
}7.6 単一の未登録者データベースの画像をQuery
インターフェースの説明
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
単一の未登録者データベースの画像をQueryします。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
“2057”
Yes
person_id
string
未登録者データベースの未登録者ID
Yes
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
json
戻りデータ
msg
string
結果の説明
フィールド情報（データ）
パラメーター
型
説明
record
json list
戻りデータ
result_num
int
Query結果の数
total_num
int
総レコード数
フィールド情報（レコード）
パラメーター
型
説明
person_id
string
未登録者データベースの未登録者ID
camera_name
string
カメラ名
channel
int
チャンネル
値の範囲：SenseNebula Basicでは[1,16]、SenseNebula Professionalでは[1,32]
position
string
カメラ位置
trigger
string
キャプチャー時間
count
int
予約フィールド
similarity
int
一致度スコア
値の範囲：[0,100］
threshold
int
閾値
値の範囲：[0,100］
snap_path
string
キャプチャー画像の保存パス
quality
double
顔認識品質スコア 値の範囲：[0,100]
feature
string
画像の特徴
lib_id
int
未登録者データベースID
img_id
string
未登録者データベースの未登録者ID
img_path
string
未登録者データベースの画像パス
biometric_attr
json
顔情報の属性
wander_thresHold
int
発生数の閾値
appear_count
int
現在の発生件数
wander_channels
string
徘徊アラート用に設定された徘徊の場所
リクエストの例
{
"msg_id":"2057",
"person_id":"74a199aa-dad7-4d3a-95f0-f74dbb818974"
}レスポンスの例
{
"code": 0,
"data": {
"record": [
{
"appear_count": 617,
"camera_name": "2222",
"channel": 1,
"count": 0,
"biometric_attr": {
"cap_style": "hat_style_type_none",
"gender_code": "male",
"glass_style": "transparent_glasses",
"mustache_style": "mustache_style_type_none",
"respirator_color": "color_type_none",
"st_age": "st_adult",
"st_age_value": "34.000000",
"st_expression": "st_calm",
"st_respirator": "st_respirator_mouth"
},
"feature": "-0.104127,0.002276,0.024537,-0.033187,0.030285,-0.072717,0.019915,0.024345,-0.044331,0.049733,-0.035291,0.059003,-0.037726,0.007244,-0.072045,0.037151,0.039421,-0.070434,-0.061541,-0.097024,-0.126349,0.075204,0.006515,-0.009571,-0.031487,0.038014,-0.065441,0.119259,0.076393,0.026436,-0.031877,0.016795,-0.009321,0.026091,-0.046108,0.011354,-0.010204,0.040885,0.062935,0.029434,0.078745,0.017767,-0.015069,0.022536,-0.017032,0.086200,-0.026295,-0.028654,0.037675,-0.044829,-0.018687,-0.078848,-0.027031,-0.019416,0.004731,0.000032,-0.036339,-0.083483,0.017351,0.065678,0.000914,-0.097164,-0.008561,0.016648,0.034728,-0.068145,-0.021820,0.061823,-0.087133,0.013586,-0.055781,0.038379,0.131119,-0.005952,0.006476,-0.076553,0.096455,0.017044,0.081987,0.060761,-0.031640,-0.062999,-0.043806,0.084327,0.050123,0.015222,-0.018393,0.027325,0.011661,-0.032823,0.092382,-0.052642,0.085183,-0.071866,0.043570,-0.046830,0.075638,0.058057,-0.051325,-0.001055,-0.043557,-0.047252,0.079871,0.032689,0.032209,-0.043519,0.029665,0.081827,-0.022376,-0.018227,-0.093412,0.044292,-0.008605,-0.025573,-0.012838,0.005268,-0.033475,-0.015778,-0.001937,0.047540,0.144391,0.046389,0.047483,0.068101,0.115001,0.029729,-0.022760,-0.079314,0.008100,0.020663,-0.003158,0.051261,-0.046869,0.051095,0.088540,-0.130428,-0.043711,-0.007544,-0.137595,0.060365,0.100227,-0.009078,-0.076617,-0.049388,0.166211,0.087785,0.033366,0.044970,-0.080261,0.059016,-0.095253,-0.009456,-0.033149,-0.045405,0.002692,0.070632,0.007301,0.015203,-0.136112,-0.014628,-0.035668,-0.041288,-0.032030,-0.005895,-0.001279,0.015612,-0.030636,0.065767,0.027069,0.076898,-0.126541,0.056970,0.024870,-0.071534,-0.048723,-0.048205,-0.043423,0.069501,0.031384,-0.005242,0.046313,0.063133,-0.019480,0.018758,0.051721,-0.022255,0.069942,-0.002007,0.077761,-0.055775,-0.127181,0.048390,0.099645,0.014321,0.031103,-0.046453,0.085196,-0.032407,0.070198,0.016354,-0.077038,0.052725,0.000173,0.034798,0.067052,-0.008190,0.104932,0.081501,-0.105322,-0.082914,0.023751,0.046402,-0.128050,-0.036224,0.020746,0.032580,0.028603,-0.147907,-0.033891,0.107099,0.108218,0.030483,0.010408,-0.170111,-0.069021,0.088303,-0.080043,-0.068459,-0.079340,0.094466,-0.113902,-0.049835,0.041236,0.062973,0.013637,0.062961,0.024588,0.159089,0.108877,0.126343,-0.057526,0.041761,0.106236,-0.038487,0.015644,-0.005179,-0.044414,0.000652,0.004399,-0.009162,-0.042643,0.203688,-0.051139,0.042477,0.016853,0.033053,",
"img_id": "9297df3e-7fbd-4c9f-a856-1c394b2fad94",
"img_path": "",
"lib_id": 2147483647,
"position": "",
"quality": 0.9495999813079834,
"similarity": 0,
"person_id": "9297df3e-7fbd-4c9f-a856-1c394b2fad94",
"snap_path": "record/channel1/biometric/9297df3e-7fbd-4c9f-a856-1c394b2fad94.jpg",
"threshold": 85,
"trigger": "2020-12-22 14:40:02",
"wander_channels": "",
"wander_threshold": 0
}
],
"result_num": 1,
"total_num": 1
},
"msg": ""
}7.7 未登録者データベースの画像を基準に基づいてQuery
インターフェースの説明
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
未登録者データベースの画像を基準に基づいてQueryします。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
“2053”
Yes
appear_time
int
現在の発生件数 予約済み、現在は未使用
No
6
channels
string
チャンネル番号をカンマで区切ったリストで、空の場合はすべてのチャンネルをQueryします。
No
1,2,3
start_no
int
開始位置
デフォルト値：1
No
1
qry_len
int
Queryのアイテム数 [1,50］
デフォルト値：10
No
10
start_time
string
開始時刻
No
2020-12-09 00:00:00
stop_time
string
終了時刻
No、start_timeが指定されている場合は、stop_timeも指定する必要があります
2020-12-09 00:00:00
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
json
戻りデータ
msg
string
結果の説明
フィールド情報（データ）
パラメーター
型
説明
record
json list
戻りデータ
result_num
int
Query結果の数
total_num
int
総レコード数
フィールド情報(レコード)
パラメーター
型
説明
img_id
string
未登録者データベースの未登録者ID
person_id
string
未登録者データベースの未登録者ID
camera_name
string
カメラ名
channel
int
チャンネル
値の範囲：SenseNebula Basicでは[1,16]、SenseNebula Professionalでは[1,32]
position
string
カメラ位置
trigger
string
キャプチャー時間
count
int
予約フィールド
similarity
int
一致度スコア
値の範囲：[0,100］
threshold
int
閾値
値の範囲：[0,100］
snap_path
string
キャプチャー画像の保存パス
lib_id
int
未登録者データベースID
quality
int
品質スコア
値の範囲：[0,100］
feature
string
画像の特徴
img_path
string
未登録者データベースの画像パス
biometric_attr
json
顔情報の属性
wander_thresHold
int
発生数の閾値
appear_count
int
現在の発生件数
wander_channels
string
徘徊アラート用に設定された徘徊の場所
リクエストの例
{
"appear_time": 170,
"channels": "1,2,3",
"start_no": 1,
"qry_len": 5,
"start_time": "2020-12-09 00:00:00",
"stop_time": "2020-12-25 23:59:59",
"msg_id": "2053"
}レスポンスの例
{
"code": 0,
"data": {
"record": [
{
"appear_count": 4,
"camera_name": "2222",
"channel": 1,
"count": 0,
"biometric_attr": {
"cap_style": "hat_style_type_none",
"gender_code": "female",
"glass_style": "transparent_glasses",
"mustache_style": "mustache_style_type_none",
"respirator_color": "color_type_none",
"st_age": "st_adult",
"st_age_value": "25.000000",
"st_expression": "st_calm",
"st_respirator": "st_respirator_mouth"
},
"feature": "-0.026478,0.065735,-0.006256,-0.086443,-0.050911,-0.048465,0.010536,0.000436,0.096051,0.099756,-0.080074,-0.030513,0.029515,0.039651,0.026401,0.132975,0.010522,0.116246,0.060077,-0.007500,0.042533,0.056197,-0.002587,-0.027385,0.006628,-0.250936,0.012139,-0.050103,0.036270,0.017565,-0.117694,0.014557,0.056977,-0.009651,0.002137,0.068392,-0.065546,-0.073523,-0.049962,-0.017537,-0.092938,-0.073812,0.031167,0.025311,-0.036445,0.021284,-0.087750,-0.020813,0.073959,0.003894,0.196398,0.046645,0.040543,0.020757,0.018493,-0.065046,0.011753,-0.064238,0.017235,0.102595,-0.022872,-0.050686,0.062516,-0.012462,-0.121988,-0.076012,-0.024257,-0.105815,0.054974,0.130866,-0.029993,0.003866,-0.116464,0.009327,0.058256,-0.016975,-0.026823,-0.069650,0.023554,-0.080053,-0.046082,-0.058355,-0.116140,-0.120337,0.004977,0.049625,0.047122,0.056541,0.009602,0.075393,-0.028699,0.032959,-0.002495,-0.051157,0.033599,-0.029655,0.037444,0.025649,0.049027,-0.005764,-0.035771,0.069594,-0.006207,0.021684,-0.019491,-0.018128,0.014100,-0.014944,-0.012961,0.014761,0.044409,-0.059613,-0.049006,0.027990,0.003058,0.027736,0.043798,0.120337,-0.039777,-0.020574,-0.088249,-0.020377,0.057750,0.050834,0.048142,0.063423,0.026190,-0.084770,-0.013995,0.021762,-0.000415,-0.024960,0.054004,0.101843,-0.056893,-0.078662,0.038097,0.074655,-0.004787,0.123436,0.086155,-0.014199,-0.101499,-0.004702,0.011176,-0.067872,-0.017284,-0.031385,0.038083,0.054580,0.059023,0.008625,-0.012469,0.054369,-0.060246,-0.138971,0.100487,-0.004681,-0.037415,-0.117174,0.020574,-0.075646,-0.027582,-0.045028,0.106419,0.012491,-0.017038,-0.067450,0.081621,0.030815,-0.024580,-0.008491,-0.081361,0.024763,0.039306,-0.037008,-0.039552,-0.099390,-0.198879,0.010382,0.096494,-0.059972,0.001153,0.027343,-0.017741,-0.007395,0.076904,-0.005349,-0.001799,-0.031216,0.037507,-0.084510,0.052760,0.027104,0.075787,0.078352,-0.030710,0.127323,-0.024489,-0.020890,0.013454,0.041499,-0.028770,-0.197051,0.006902,0.063458,0.024932,0.046223,-0.032818,-0.103094,-0.007486,0.047073,-0.052704,-0.019491,0.006214,-0.011654,-0.009131,-0.056232,-0.050384,0.051621,0.032629,-0.016054,0.016525,0.042455,-0.065046,-0.054046,0.062333,0.022901,0.012779,0.074564,-0.093387,0.152656,-0.049189,-0.079871,0.023414,-0.105829,-0.007416,-0.021263,-0.004344,0.028538,-0.149809,-0.001638,-0.039967,0.055909,0.015787,0.048226,0.089395,0.025895,-0.109350,0.037458,0.002074,0.017355,-0.020476,-0.024602,-0.119022,0.006087,",
"img_id": "687fc7d7-eea7-4ba0-b4f8-d153002f7720",
"img_path": "",
"lib_id": 2147483647,
"position": "",
"quality": 0.91949999332427979,
"similarity": 0,
"person_id": "687fc7d7-eea7-4ba0-b4f8-d153002f7720",
"snap_path": "record/channel1/biometric/687fc7d7-eea7-4ba0-b4f8-d153002f7720.jpg",
"threshold": 85,
"trigger": "2020-12-24 15:44:10",
"wander_channels": "1",
"wander_threshold": 5
}
],
"result_num": 1,
"total_num": 24
},
"msg": ""
}7.8 ページネーションモードでの未登録者データベースの画像のエクスポート
インターフェースの説明
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
ページネーションモードで未登録者データベースの画像をエクスポートします。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
“2049”
Yes
appear_time
int
現在の発生件数 予約済み、現在は未使用
No
6
channels
string
チャンネル番号をカンマで区切ったリストで、空の場合はすべてのチャンネルをQueryします。
No
1,2,3
start_no
int
開始位置
Yes
デフォルト値：1
qry_len
int
エクスポートする項目数
最大値：500
Yes
10
start_time
string
開始時刻
No
2020-12-09 00:00:00
stop_time
string
終了時刻
No、start_timeが指定されている場合は、stop_timeも指定する必要があります。
2020-12-09 00:00:00
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
json
戻りデータ
msg
string
結果の説明
フィールド情報(データ)
パラメーター
型
説明
export_url
string
エクスポートされるファイルのパス
result_num
int
Query結果の数
total_num
int
総レコード数
zippasswd
string
圧縮されたパスワード
リクエストの例
{
"appear_time": 6,
"channels": "1,2,3",
"start_no": 1,
"qry_len": 10,
"start_time": "2020-12-09 00:00:00",
"stop_time": "2020-12-25 23:59:59",
"msg_id": "2049"
}レスポンスの例
{
"code": 0,
"data": {
"export_url": "tmp/grey_2020-12-24-17-21-52.zip",
"result_num": 10,
"total_num": 22,
“zippasswd”:”xxxx”"
},
"msg": ""
}7.9 選択した未登録者データベースの画像のエクスポート
インターフェース
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
選択した未登録者データベースの画像をエクスポートします。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
2050
Yes
person_ids
string
Queryで取得できる、未登録者データベースに登録されているトレンジャー画像IDの集合
車両IDはカンマ[,]で区切り、数量は1～50
Yes
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
json
戻りデータ
msg
string
結果の説明
フィールド情報(データ)
パラメーター
型
説明
export_url
string
エクスポートされるファイルのパス
failed_img_ids
string
エクスポートできない画像のID
result_num
int
Query結果の数
total_num
int
エクスポートされた画像の合計数
zippasswd
string
圧縮されたパスワード
リクエストの例
{
"msg_id":"2050",
"person_ids":"74a199aa-dad7-4d3a-95f0-f74dbb818974,f12ed623-87d6-49e0-939a-97262a0407e9"
}レスポンスの例
{
"code": 0,
"data": {
"export_url": "tmp/catch_2019-01-23-12-44-37.zip",
"failed_img_ids": "",
"result_num": 5,
"total_num": 5,
“zippasswd”:”xxxx”"
},
"msg": ""
}7.10 ワンダリングアラートのレコードを基準に基づいてQuery
インターフェースの説明
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
徘徊アラートのレコードを、基準に基づいてQueryします。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
2054
Yes
channel
int
チャンネル
値の範囲：SenseNebula Basicでは[1,16]、SenseNebula Professionalでは[1,32]
No
start_time
string
開始時刻
No
stop_time
string
終了時刻
No、start_timeが指定されている場合は、stop_timeも指定する必要があります。
start_no
int
開始位置
No
デフォルト値：1
qry_len
int
Query項目の数
最大値：50
No
デフォルト値：10
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
json
戻りデータ
msg
string
結果の説明
フィールド情報(データ)
パラメーター
型
説明
record
json list
戻りデータ
result_num
int
Query結果の数
total_num
int
総レコード数
フィールド情報(レコード)
パラメーター
型
説明
camera_name
string
カメラ名
channel
int
チャンネル
値の範囲：SenseNebula Basicでは[1,16]、SenseNebula Professionalでは[1,32]
create_time
string
作成日時
img_id
string
未登録者データベースの未登録者ID
img_path
string
未登録者データベースの画像パス
lib_id
int
未登録者データベースID
lib_name
string
データベース名
lib_type
int
データベースの種類
1：要注意リストデータベース、2：登録者リストデータベース
position
string
カメラ位置
ranking
int
1は比較結果の中で最も高い順位を示します。
similarity
int
一致度スコア
値の範囲：[0,100］
snap_id
string
キャプチャーID
snap_path
string
キャプチャーパス
threshold
int
閾値
値の範囲：[0,100］
trigger
string
キャプチャー時間
alive_type
int
Aliveタイプ
0：不明
1：非Alive
2：Alive
biometric_attr
json
顔キャプチャーの属性
詳細は付録Bを参照
alarm_type
int
顔認識アラートの種類
0：アラートなし
1：要注意リスト/登録者リストアラート
2：未登録者アラート
3：未登録者DBヒットアラート
appear_count
int
現在の発生件数
event_type
int
イベントアラートの種類
0：アラートなし
1：徘徊アラート
2：ステイイングアラート
wander_channels
string
徘徊アラート用に設定された徘徊の場所
wander_deviceID
string
徘徊アラートのトリガー箇所
wander_trigger
string
徘徊アラートのトリガー時間
stranger_appear_channel
int
未登録者データベース画像のキャプチャーチャンネル
デフォルトでは、顔データベースは作成日時順に並べられます。
リクエストの例
{
"msg_id":"2054",
"start_no":1,
"qry_len":1
}レスポンスの例
{
"code": 0,
"data": {
"record": [
{
"camera_name": "no2",
"channel": 2,
"biometric_attr": {
"cap_style": "hat_style_type_none",
"gender_code": "female",
"glass_style": "glasses_style_type_none",
"mustache_style": "mustache_style_type_none",
"st_respirator": "st_respirator_mouth",
"respirator_color": "color_type_none",
"st_age": "st_adult",
"st_age_value": "26.000000",
"st_helmet_style": "st_helmet_style_type_none",
"st_expression": "st_angry"
},
"create_time": "2019-01-23 11:37:26",
"img_id": "71f11a77-94c0-43c9-ab23-6e9076f6127a",
"img_path": "img/1_71f11a77-94c0-43c9-ab23-6e9076f6127a.jpg",
"lib_id": 1,
"lib_name": "test",
"lib_type": 1,
"position": "aaa",
"ranking": 1,
"similarity": 35,
"snap_id": "1d9abf3d-09e1-4ef2-8832-f3d025ae0f91",
"snap_path": "record/1d9abf3d-09e1-4ef2-8832-f3d025ae0f91.jpg",
"threshold": 10,
"trigger": "2019-01-23 14:29:22",
"alive_type": 2
}
],
"result_num": 1,
"total_num": 297
},
"msg": ""
}7.11 ページネーションモードでのワンダリングアラートのエキスポート
インターフェースの説明
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
ページネーションモードでワンダリングアラートをエキスポートします。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
2055
Yes
start_no
int
開始位置
No
デフォルト値：1
qry_len
int
エクスポートする項目数
最大値：500
No
デフォルト値：10
channel
int
チャンネル
値の範囲：SenseNebula Basicでは[1,12]、SenseNebula Professionalでは[1,24]
No
start_time
string
開始時刻
No
stop_time
string
終了時刻
No、start_timeが指定されている場合は、stop_timeも指定する必要があります。
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
json
戻りデータ
msg
string
結果の説明
フィールド情報(データ)
パラメーター
型
説明
export_url
string
エクスポートされるファイルのパス
result_num
int
Query結果の数
total_num
int
エクスポートされた画像の合計数
zippasswd
string
圧縮されたパスワード
リクエストの例
{
"msg_id": "2055"
}レスポンスの例
{
"code": 0,
"data": {
"export_url": "tmp/alarm_2019-01-23-14-31-51.zip",
"result_num": 10,
"total_num": 298,
“zippasswd”:”xxxx”"
},
"msg": ""
}7.12 選択したワンダリングアラートのエクスポート
インターフェースの説明
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
選択したワンダリングアラートをエクスポートします。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
2056
Yes
snap_ids
string
Queryで得られるキャプチャー画像のIDの集合
画像IDはカンマ[,]で区切る。画像の数は1～50個
Yes
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
json
戻りデータ
msg
string
結果の説明
フィールド情報(データ)
パラメーター
型
説明
export_url
string
エクスポートされるファイルのパス
failed_img_ids
string
エクスポートできない画像のID
result_num
int
Query結果の数
total_num
int
エクスポートされた画像の合計数
zippasswd
string
圧縮されたパスワード
リクエストの例
{
"msg_id":"2056",
"snap_ids":"91f3705f-539b-4474-8f8b-fffb86d8ffa7"
}レスポンスの例
{
"code": 0,
"data": {
"export_url": "tmp/alarm_2019-01-23-14-35-29.zip",
"failed_img_ids": "",
"result_num": 1,
"total_num": 1,
“zippasswd”:”xxxx”"
},
"msg": ""
}7.13 キャプチャレコードに基づいて未登録者データベースの画像をQuery
インターフェースの説明
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
キャプチャレコードに基づいて未登録者データベースの画像をQueryします。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
“1066”
Yes
snap_id
string
キャプチャーID
Yes
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
json
戻りデータ
msg
string
結果の説明
フィールド情報(データ)
パラメーター
型
説明
record
json list
戻りデータ
result_num
int
Query結果の数、ここでは1。
total_num
int
総レコード数、ここでは1。
フィールド情報(レコード)
パラメーター
型
説明
camera_name
string
カメラ名
channel
int
チャンネル 値の範囲：SenseNebula Basicでは[1,16]、SenseNebula Professionalでは[1,32]
alarm_type
int
顔認識アラートの種類
0：アラートなし
1：要注意リスト/登録者リストアラート
2：未登録者アラート
3：未登録者DBヒットアラート
event_type
int
イベントアラートの種類 0：アラートなし
1：ワンダリングアラート
2：ステイイングアラート
img_id
string
未登録者データベースの未登録者ID
biometric_attr
json
生体キャプチャーの属性
詳細は付録Bを参照
lib_id
int
未登録者データベースID
lib_name
string
Null
lib_type
int
Null
position
string
カメラ位置
ranking
int
1は、比較結果の中で最も高い順位を示します。
similarity
int
一致度スコア
値の範囲：[0,100］
snap_id
string
キャプチャーID
snap_path
string
キャプチャー画像の保存パス
threshold
int
閾値
値の範囲：[0,100］
trigger
string
キャプチャー時間
リクエストの例
{
"msg_id": "1066",
"snap_id": "78e0f17b-4fc4-4b22-993b-8669b9a44ce5"
}レスポンスの例
{
"code": 0,
"data": {
"record": [
{
"camera_name": "121",
"channel": 4,
"biometric_attr": {"cap_style": "hat_style_type_none", "gender_code": "male", "glasses_style": "glasses_style_type_none", "mustache_style": "mustache_style_none", "respirator_color": "color_type_none", "st_age": "st_adult", "st_age_value": "30.000000", "st_expression": "st_calm"},
"lib_id": 2147483647,
"lib_name": "",
"lib_type": 0,
"position": "",
"ranking": 1,
"similarity": 0,
"snap_id": "78e0f17b-4fc4-4b22-993b-8669b9a44ce5",
"snap_path": "record/channel4/biometric/78e0f17b-4fc4-4b22-993b-8669b9a44ce5.jpg",
"threshold": 85,
"trigger": "2020-04-20 08:51:52"
}
],
"result_num": 1
"total_num": 1
},
"msg": ""
}7.14 徘徊アラートの閾値の設定
インターフェースの説明
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
徘徊アラートの閾値を設定します。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
“1335”
Yes
channels
string
徘徊アラート用に設定されたワンダリングの場所。有効なチャンネルのみ設定可能。
Yes
appeared_times
int
徘徊の回数、選択された徘徊箇所での未登録者の出現数の閾値。0よりも大きくする必要があります。
Yes
enable
int
イネーブルスイッチ
1：有効
0：無効
Yes
interval
int
設定された徘徊時間
未登録者の徘徊期間。 オプションは3、5、7、15で、それぞれ「3日」、「5日」、「7日」、「15日」を意味する
デフォルト値は3。
Yes
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
string
検証コード文字列
msg
string
結果の説明
リクエストの例
{
"msg_id":"1335",
"channels":"1,2,3,4,5",
"appeared_times":1,
"enable":0,
"interval":3
}レスポンスの例
{
"code": 0,
"data": "",
"msg": ""
}7.15 徘徊アラートの閾値のQuery
インターフェースの説明
インターフェースのURL
https://${ip}:${port}/api/json
リクエストメソッド
POST
リクエストパラメーター形式
JSON
インターフェースの説明
徘徊アラートの閾値をQueryします。
リクエストパラメーター
パラメーター
型
説明
必須
例
msg_id
string
“1336”
Yes
レスポンスパラメーター
パラメーター
型
説明
code
int
結果コード（0：成功）
data
string
検証コード文字列
msg
string
結果の説明
フィールド情報(データ)
パラメーター
型
説明
enable
int
イネーブルスイッチ
1：有効
0：無効
interval
int
設定された徘徊時間、未登録者の徘徊期間
オプションは3、5、7、15で、それぞれ「3日」、「5日」、「7日」、「15日」を意味する
デフォルト値は3。
channels
string
徘徊アラート用に設定された徘徊の場所
appeared_times
int
徘徊の数、選択された徘徊箇所での未登録者の出現数の閾値。0よりも大きくする必要があります。
リクエストの例
{
"msg_id":"1336"
}レスポンスの例
{
"code": 0,
"data": {
"channels":"1,2,3,4,5",
"appeared_times":1,
"enable":0,
"interval":1
},
"msg": ""
}Last updated