查询视图数据详情--慢直播-火山引擎

文档中心

立即注册

导航

查询视图数据详情

最近更新时间：2024.03.14 20:00:47首次发布时间：2022.11.01 17:47:38

调用 GetStructuredViewDataInfo 接口，查询指定视图数据的详细信息。

请求说明

请求方式：GET
请求地址：https://open.volcengineapi.com?Action=GetStructuredViewDataInfo&Version=2021-01-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`GetStructuredViewDataInfo`	接口名称。当前 API 的名称为 `GetStructuredViewDataInfo`。
Version	String	是	`2021-01-01`	接口版本。当前 API 的版本为 `2021-01-01`。
ViewID	String	是	`v_rznll23mtuxxxxxx`	筛选条件，视图接入 ID，可通过调用 ListStructuredViews 接口获取。
DataID	String	是	`dfl3muxxxxxx23`	筛选条件，视图数据 ID，可通过调用 ListStructuredViewData 接口获取。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
PhotoID	String	`abcxxx`	图片 ID。
InfoKind	String	`1`	图片采集方式，取值及含义如下所示。 1：设备自动采集； 2：人工采集。
ImageSource	String	`8`	视频图像数据来源，取值及含义如下所示。 1：政府机关监控； 2：社会面治安监控； 3：交通监控（含轨道交通监控）； 4：出入境监控； 5：港口监控； 6：金融系统监控； 7：旅馆监控； 8：互联网营业场所监控； 9：娱乐服务场所监控； 10：其他企业/事业单位监控； 11：居民自建监控； 12：公安内部； 13：监所； 14：讯问室； 15：车（船、直升机等）载终端拍摄； 16：移动执法； 17：手机、平板电脑拍摄； 18：DV 拍摄； 19：相机拍摄； 20：网络获取； 21：声像资料片。
StoragePath	String	`http://localhost:8080/xxx.jpg`	图片存储路径。
Type	String	`11`	图片类型，取值及含义如下所示。 11：人脸小图； 14：场景大图。
Title	String	`测试`	图片标题。
FileFormat	String	`Jpeg`	图片文件的类型。
ShotTime	String	`20170925032455`	图片抓拍时间，格式为 `YYYYMMDDhhmmss`。
ShotPlaceFullAdress	String	`xx区xx小区`	图片拍摄地点区划内的详细地址。
SecurityLevel	String	`5`	图片安全等级，取值及含义如下所示。 1：绝密； 2：机密； 3：秘密； 4：内部； 5：公开。
Width	Float	`1920`	图片宽度，单位为 px。
Height	Float	`1080`	图片高度，单位为 px。
CreateTime	String	`20170925032455`	数据创建时间，格式为 `YYYYMMDDhhmmss`。
DownloadUrl	String	`http://127.0.0.1:8080/xxx/xxx.jpg`	图片下载地址。
DeviceID	String	`123456`	采集设备的设备 ID。
ContentDescription	String	`测试内容`	对图像内容的简要描述。

请求示例

GET https://open.volcengineapi.com?Action=GetStructuredViewDataInfo&Version=2021-01-01&ViewID=v_rznll23mtuxxxxxx&DataID=123456

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202210211535210101742491480305D847",
        "Action": "GetStructuredViewDataInfo",
        "Version": "2021-01-01",
        "Service": "aiotvideo",
        "Region": "cn-north-1"
    },
    "Result": {
        "PhotoID":"abcxxx",
        "InfoKind":"1",
        "ImageSource":"1",
        "StoragePath":"http://localhost:8080/xxx.jpg",
        "Type":"11",
        "Title":"测试",
        "FileFormat":"Jpeg",
        "ShotTime":"20170925032455",
        "ContentDescription":"测试内容",
        "ShotPlaceFullAdress":"xx区xx小区",
        "SecurityLevel":"5",
        "Width":1920,
        "Height":1080,
        "CreateTime":"20170925032455",
        "DownloadUrl":"http://127.0.0.1:8080/xxx/xxx.jpg",
        "DeviceID":"123456",
    }
}

错误码

您可访问公共错误码，获取更多错误码信息。