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

threshold

int

認識の閾値

[65,100]から選択、初期値は80

Yes

enable

int

イネーブルスイッチ

1：有効

0：無効

Yes

レスポンスパラメーター

パラメーター

型

説明

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

qry_len

int

Queryのアイテム数 [1,50］デフォルト値：10

channels

string

チャンネル番号をカンマで区切ったリストで、空の場合はすべてのチャンネルをQueryします。

1,3,6

start_time

string

開始時刻

時間の形式：YYYY-MM-DD HH:MM:SS

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

qry_len

int

Queryのアイテム数 [1,50］

デフォルト値：10

channels

string

チャンネル番号をカンマで区切ったリストで、空の場合はすべてのチャンネルをQueryします。

1,3,6

start_time

string

開始時刻の形式：YYYY-MM-DD HH:MM:SS

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

現在の発生件数予約済み、現在は未使用

channels

string

チャンネル番号をカンマで区切ったリストで、空の場合はすべてのチャンネルをQueryします。

1,2,3

start_no

int

開始位置

デフォルト値：1

qry_len

int

Queryのアイテム数 [1,50］

デフォルト値：10

start_time

string

開始時刻

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

現在の発生件数予約済み、現在は未使用

channels

string

チャンネル番号をカンマで区切ったリストで、空の場合はすべてのチャンネルをQueryします。

1,2,3

start_no

int

開始位置

Yes

デフォルト値：1

qry_len

int

エクスポートする項目数

最大値：500

Yes

start_time

string

開始時刻

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]

start_time

string

開始時刻

stop_time

string

終了時刻

No、start_timeが指定されている場合は、stop_timeも指定する必要があります。

start_no

int

開始位置

デフォルト値：1

qry_len

int

Query項目の数

最大値：50

デフォルト値：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

開始位置

デフォルト値：1

qry_len

int

エクスポートする項目数

最大値：500

デフォルト値：10

channel

int

チャンネル

値の範囲：SenseNebula Basicでは[1,12]、SenseNebula Professionalでは[1,24]

start_time

string

開始時刻

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": ""
}

Previous6. 顔検出・比較機能関連インターフェース Next8. システム構成インターフェース

Last updated 3 years ago