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の顔属性 詳細は付録B参照
body_attr	json	Obj_label=2の全身属性 詳細は付録C参照
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	車両属性，付録D を参照

アラートの展開結果を受け取る前に、対応する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
    }
}