9. http設定用インターフェース

9.1 http設定のQuery

インターフェースの説明

インターフェースのURL

https://${ip}:${port}/api/json

リクエストメソッド

POST

リクエストパラメーター形式

JSON

インターフェースの説明

http設定をQueryします。

リクエストパラメーター

パラメーター

型

説明

必須

例

msg_id

string

“1299”

Yes

レスポンスパラメーター

パラメーター

型

説明

code

int

結果コード（0：成功）

data

json

戻りデータ

msg

string

結果の説明

フィールド情報(データ)

パラメーター

型

説明

key

string

httpキー

url

string

httpのURL

リクエストの例

{
    "msg_id":"1299"
}

レスポンスの例

{
    "code": 0,
    "data": {
        "key": "db504129-85e0-49ca-8626-f639b8d09846",
        "url": "https://sgdzpic.3322.org:8088/agbox/device/snap"
    },
    "msg": ""
}

9.2 http設定の変更

インターフェースの説明

インターフェースのURL

https://${ip}:${port}/api/json

リクエストメソッド

POST

リクエストパラメーター形式

JSON

インターフェースの説明

http設定を変更します。

リクエストパラメーター

パラメーター

型

説明

必須

例

msg_id

string

“1298”

Yes

url

string

http url

Yes

google.com

key

string

http key

Yes

google-key

レスポンスパラメーター

パラメーター

型

説明

code

int

結果コード（0：成功）

data

json

Null

msg

string

結果の説明

リクエストの例

{
    "msg_id":"1298",
    "url":"google.com",
    "key":"google-key"
}

レスポンスの例

{
    "code": 0,
    "data": "",
    "msg": ""
}

9.3 httpハートビート情報のプッシュ

インターフェースの説明

インターフェースのURL

プッシュされたハートビート情報を受信するHTTPサーバーのURL

インターフェースの説明

指定したIPアドレスのサーバーにハートビート情報をプッシュします。

レスポンスパラメーター

パラメーター

型

説明

msg_id

string

“775”

data

json

戻りデータ

フィールド情報(データ)

パラメーター

型

説明

trigger

string

ハートビート情報の時刻

device_id

string

ハートビート情報をマッピングするデバイスID

レスポンスの例

{
   "data" : {
      "device_id" : "test_device",
      "trigger" : "2019-01-24 15:05:05"
   },
   "msg_id" : 775
}

9.4 httpアラートのデプロイ結果のプッシュ

インターフェースの説明

インターフェースのURL

プッシュされた結果を受信するHTTPサーバーのURL

インターフェースの説明

指定したIPアドレスのサーバーにアラートのデプロイ結果をプッシュします。

レスポンスパラメーター

パラメーター

型

説明

key

string

ドッキング装置の検証に使用

json

json

戻りデータ

snap

file

顔／全身のキャプチャ画像

img

file

顔データベースでマッチした画像

snap_frame

file

顔／全身の画像に対応した大きなシーン

フィールド情報(json)

パラメーター

型

説明

msg_id

string

“774”

data

json

戻りデータ

フィールド情報(データ)

パラメーター

型

説明

camera_name

string

カメラ名

device_id

string

デバイスID

channel

int

チャンネル

値の範囲：SenseNebula Basicでは[1,16]、SenseNebula Professionalでは[1,32]

position

string

カメラ位置

threshold

int

比較の閾値（カメラバウンド）

値の範囲：[0,100］

img_id

string

顔データベースで一致した顔画像のID

img_path

string

顔データベース内の画像のパス （このパラメータは予約されており、画像名を示す） 画像をダウンロードする際には、以下のようにURLを連結してください: https://${ip}:${port}/ws/img_path

lib_id

int

データベースID

lib_name

string

データベース名

lib_type

int

データベースの種類

1：要注意リストデータベース

2：登録者リストデータベース

person_addr

string

住所

person_age

string

年齢

person_gender

string

性別

0：女性

1：男性

person_idcard

string

属性コード

person_name

string

氏名

snap_id

string

キャプチャーID

similarity

int

ソースデータベースに登録されている画像との一致度を示すスコア

値の範囲：[0,100]

デフォルト値は-1。

quality

int

品質スコア

値の範囲：[0,100］

pos_top

int

左上に位置する顔情報のY座標

pos_bottom

int

右下に位置する顔情報のY座標

pos_left

int

左上に位置する顔情報のX座標

pos_right

int

右下に位置する顔情報のX座標

snap_feat

string

キャプチャーの特徴

snap_path

string

キャプチャーのパス（このパラメーターは予約されており、画像名を示す） 画像をダウンロードする際には、以下のようにURLを連結してください： https://${ip}:${port}/ws/snap_path

trigger

string

トリガー（キャプチャー時間）

obj_label

int

ラベル

1:顔情報

2:全身

alive_type

int

Aliveタイプ

0：不明

1：非Alive

2：Alive

biometric_attr

json

Obj_label=1の顔属性

body_attr

json

Obj_label=2の全身属性

ranking

int

ランキングをマッピングした顔画像の一致度係数

値の範囲：[0,100]

alarm_type

int

顔認識アラートの種類

0：アラートなし

1：要注意リスト/登録者リストアラート

2：未登録者アラート

3：未登録者DBヒットアラート

appear_count

int

現在の発生件数

event_type

int

イベントアラートの種類

0：アラートなし

1：ワンダリングアラート

2：ステイイングアラート

wander_channels

string

ワンダリングアラート用に設定されたワンダリングの場所

wander_thresHold

int

発生数の閾値

wander_deviceID

string

ワンダリングアラートのトリガー箇所

wander_trigger

string

ワンダリングアラートのワンダリング時間

stranger_appear_channel

int

キャプチャーされたワンダリング未登録者のカメラチャンネル

アラートの展開結果を受け取る前に、対応するHTTPサーバーを設定してください。

プッシュ結果では、img、snap、snap_frameはファイルです。ソースデータベースの画像をダウンロードするには、img_pathに基づいてダウンロードURLを連結します。キャプチャーをダウンロードするには、snap_pathに基づいてダウンロードURLを連結します。

レスポンスの例

{
    "key":"",
    "snap":"",
    "img":"",
    "snap_frame":"",
    "json": {
        "data": {
            "biometric_attr": {
                "cap_style": "hat_style_type_none", "gender_code": "male",
                "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_helmet_style": "st_helmet_style_type_none",
                "st_age_value": "24.000000", "st_expression": "st_calm",
                "st_expression": "st_calm"
            },
            "camera_name": "test", "device_id": "13",
            "channel": 19,
            "img_id": "fa48b56f-9aed-43bc-ad20-9ee164873473",
            "img_path": "img_pic",
            "lib_id": 3,
            "lib_name": "Facelib",
            "lib_type": 2,
            "obj_label":1,
            "person_addr": "SH",
            "person_age": "",
            "person_gender": "",
            "person_idcard": "123",
            "person_name": "lousongya_000000000000000000_1",
            "position": "",
            "similarity": 96,
            "quality":1,
            "pos_top":1000,
            "pos_bottom":100,
            "pos_left":100,
            "pos_right":1000,
            "snap_feat": "124.000000,391.000000,280.000000,327.000000,239.000000,239.000000,242.000000,244.000000,",
            "snap_id": "92ed1a18-2aaf-4362-b5b4-1fd6750e1dd9",
            "snap_path": "snap_pic",
            "threshold": 30,
            "trigger": "2019-01-24 13:43:32",
            "alive_type": 2
        },
        "msg_id": 774
    }
}

9.5 HTTPで車両メッセージを送信するインターフェース

インターフェースの説明

インターフェースのURL

メッセージを受信するhttpサーバーのアドレス

インターフェースの説明

HTTPで車両メッセージを送信するインターフェース

レスポンスパラメーター

パラメーター

型

説明

key

string

キー

json

json

結果データ

snap

file

キャプチャ画像

img

file

予約済み

snap_frame

file

フレーム

vehicle_num_img

file

ナンバープレートの画像

フィールド情報(json)

パラメーター

型

説明

msg_id

string

“774”

data

json

戻りデータ

フィールド情報(データ)

パラメーター

型

説明

camera_name

string

カメラ名

device_id

string

デバイスID

channel

int

チャンネル SenseNebula Basic：[1,16], SenseNebula Professional：[1,32]

position

string

カメラ位置

threshold

int

予約済み 類似度の閾値：[0,100]

notify

int

アラートメッセージか？

0：No

1：Yes

img_id

string

データベースに登録されているナンバープレートのうち、キャプチャされたナンバープレートと同じ番号を持つナンバープレートのUUID

img_path

string

予約済み

lib_id

int

データベースID

lib_name

string

データベース名

owner_age

string

オーナーの年齢

owner_gender

string

オーナーの性別

0：女性

1：男性

owner_idcard

string

オーナーのIDカード

owner_name

string

オーナー名

quality

int

品質スコア

値の範囲：[0,100］

pos_top

int

境界ボックスの上部

pos_bottom

int

境界ボックスの下部

pos_left

int

境界ボックスの左側

pos_right

int

境界ボックスの右側

vehicle_num_left

int

車両画像内のナンバープレートの座標

vehicle_num_top

int

車両画像内のナンバープレートの座標

vehicle_num_right

int

車両画像内のナンバープレートの座標

vehicle_num_bottom

int

車両画像内のナンバープレートの座標

snap_id

string

キャプチャーID

snap_path

string

キャプチャ画像のパス

vehicle_number

string

ライセンス番号

trigger

string

キャプチャのトリガー時間

obj_label

int

3：自動車以外の車両

4：自動車

vehicle_attr

json

アラートの展開結果を受け取る前に、対応するHTTPサーバーを設定してください。

このメッセージにおいて，img，snap，snap_frameはファイルであり，img，snapはimg_path，snap_pathに従ってダウンロードすることができます。

レスポンスの例

{
    "key":"",
    "snap":"",
    "img":"",
    "snap_frame":"",
    "json": {
        "data": {
            "vehicle_attr": {
                "Brand":"Toyota",
                "CarDirection":"Front",
                "CarFilter":"Easy",
                "SubType":" Toyota-Camry",
                "Type":"Car",
                "vehicle_class": "suv",
                "vehicle_color": "black"
            },
            "camera_name": "test",
            "device_id": "13",
            "channel": 19,
            "img_id": "fa48b56f-9aed-43bc-ad20-9ee164873473",
            "img_path": "img_pic",
            "lib_id": 3,
            "lib_name": "Vehiclelib",
            "obj_label":3,
            "owner_age": "",
            "owner_gender": "",
            "owner_idcard": "",
            "owner_name": "lousongya_000000000000000000_1",
            "position": "",
            "quality":85,
            "pos_top":1000,
            "pos_bottom":100,
            "pos_left":100,
            "pos_right":1000,"snap_id": "92ed1a18-2aaf-4362-b5b4-1fd6750e1dd9",
            "snap_path": "snap_pic",
            "verhicle_number":"YNLV880",
            "threshold": 80,
            "trigger": "2020-01-24 13:43:32"
        },
        "msg_id": 774
    }
}

Previous8. システム構成インターフェースNext10. https設定用インターフェース

Last updated