QueryDevicePositions - 查询设备GPS数据列表--智能视联-火山引擎

文档中心

智能视联

设备管理

QueryDevicePositions - 查询设备GPS数据列表

查询设备上报的GPS数据信息

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	QueryDevicePositions	要执行的操作，取值：QueryDevicePositions。
Version	String	是	2023-10-01	API的版本，取值：2023-10-01。
DeviceID	String	否	b3d9d0c7-xxxx-xxxx-xxxx-a06bac4f8xxx	设备ID。与DeviceNSID参数二选一填写
DeviceNSID	String	否	314000000xxxx101011	设备国标ID。与DeviceID参数二选一填写
StartTime	Integer	是	1749201386	开始时间，Unix时间戳（秒）
EndTime	Integer	是	1749201396	结束时间，Unix时间戳（秒）
SpaceID	String	否	60268982-xxxx-xxxx-xxxx-bd811b2f2xxx	设备所属空间ID
PageNumber	Integer	是	1	分页页码，默认为1
PageSize	Double	是	20	每页条数，默认20，最大1000

返回参数

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

参数	类型	示例值	描述
PageNumber	Integer	1	当前页码
PageSize	Integer	100	当前页显示条数
TotalCount	Integer	2000	数据总数
DeviceID	String	b3d9d0c7-b619-41fe-98ef-a06bac4f8b4b	设备ID
DeviceNSID	String	54020084991180608010	设备国标ID
DeviceName	String	测试设备	设备名称
SpaceID	String	60268982-1a6a-4c0f-9dbf-bd811b2f29b2	设备所在空间ID
Positions	Array of Object	`[ { "CollectTime": "2026-04-16T23:34:45+08:00", "Longitude": -80.19152884095045, "Latitude": 87.8176840892674, "Speed": 0, "Direction": 0, "Altitude": 0 }, { "CollectTime": "2026-04-16T23:34:55+08:00", "Longitude": -1.9253296885950655, "Latitude": -48.11437260548402, "Speed": 0, "Direction": 0, "Altitude": 0 } ]`	GPS坐标信息列表

请求示例

GET /?Action=QueryDevicePositions&Version=2023-10-01&DeviceID=b3d9d0c7-b619-41fe-98ef-a06bac4f8b4b&StartTime=1749201386&EndTime=1749201396 HTTP/1.1
Host: open.volcengineapi.com
X-Date: 20260417T104612Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260417/cn-beijing/aiotvideo/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202604171848281311322510736F8974",
    "Action": "QueryDevicePositions",
    "Version": "2023-10-01",
    "Service": "aiotvideo",
    "Region": "cn-beijing"
  },
  "Result": {
    "PageNumber": 1,
    "PageSize": 100,
    "TotalCount": 2000,
    "DeviceID": "b3d9d0c7-b619-41fe-98ef-a06bac4f8b4b",
    "DeviceNSID": "54020084991180608010",
    "DeviceName": "测试设备",
    "SpaceID": "60268982-1a6a-4c0f-9dbf-bd811b2f29b2",
    "Positions": [
      {
        "CollectTime": "2026-04-16T17:34:45+08:00",
        "Longitude": 121.58587,
        "Latitude": 38.987999,
        "Speed": 25.5,
        "Direction": 25.4,
        "Altitude": 125.2
      }
    ]
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidParameter.QueryDevicePositions	StartTime and EndTime are required	StartTime 或 EndTime 无效

最近更新时间：2026.04.21 12:19:58

这个页面对您有帮助吗？

有用

无用

智能视联

调试 #

请求参数 #

返回参数 #

请求示例 #

返回示例 #

错误码 #

调试

请求参数

返回参数

请求示例

返回示例

错误码