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