获取二维指定帧范围内所有节点的信息

应用场景

获取指定帧范围内所有节点的信息。虽然本接口支持按帧范围查询，但是请根据实际模型的规模大小进行确定拉取的范围大小。若对规模不是特别清晰，请一帧一帧获取数据。

前提条件

已获取AK和SK，获取方法参见《安全规范.MD》

解码解压说明

1、因二维结果数值较大，因此对每个指标进行了单独的压缩，压缩方式为：Gzip + Base64编码，即获取结果后，客户端需要对数据进行Base64解码并解压；
2、因二维结果数据较大，因此在调用本接口时，建议去除filter字段中不需要的字段；
3、二维数据以一帧帧的形式进行获取，具体一次获取多少帧，需要根据具体的方案而定；
4、返回的字段中，数值均通过","连接成字符串。先后顺序即为点坐标的顺序，与Summary中的x、y坐标中的顺序对应。
例如x经过解码并解压后的内容为：x1,x2,x3,x4...
例如y经过解码并解压后的内容为：y1,y2,y3,y4...
例如vmag经过解码并解压后的内容为：vmag1,vmag2,vmag3,vmag4...即可得到如下表内容

字段	值1	值2	值3	值4
x	x1	x2	x3	x4
y	y1	y2	y3	y4
vmag	vmag1	vmag2	vmag3	vmag4

即第一个点坐标为 (x1,y1) 的vmag值为 vmag1即第二个点坐标为 (x2,y2) 的vmag值为 vmag2即第三个点坐标为 (x3,y3) 的vmag值为 vmag3依次类推...

请求参数

Query 参数

taskId

integer

任务ID

必需

示例值:

357

filter

string

必需

字段过滤器,当前支持dir(流速方向),eta(水位),u(流速横坐标分量),h(水深),vmag(流速大小),v(流速纵坐标分量)

示例值:

dir,eta,u,h,vmag,v

beginFrame

integer

必需

开始帧序号，从0开始，结果包含该帧

endFrame

integer

必需

结束帧序号，从1开始，结果不包含该帧

Header 参数

apiKey

string

apiKey

必需

默认值:

timestamp

string

时间戳

必需

默认值:

sign

string

签名

必需

默认值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

1、因二维结果数值较大，因此对每个指标进行了单独的压缩，压缩方式为：Gzip + Base64编码，即获取结果后，客户端需要对数据进行Base64解码并解压；

array of:

eta

string

水位

必需

单位 m

string

流速横坐标分量

必需

单位 m/s

string

流速纵坐标分量

必需

单位 m/s

string

水深

必需

单位 m

vmag

string

流速大小

必需

单位 m/s

dir

string

流速方向(度数)

必需

PHY

string

污染物名称

可选

自定义污染物名称

示例

成功示例异常示例异常示例

[
    {
        "eta": "H4sIAAAAAAAAAO3EMQ0AAAgDMEMc48C/NT5M0DRpZ1ItSZIkSZIkSZIkSZIkSZIkSZJedxb6ZoUAajAAAA==",
        "u": "H4sIAAAAAAAAAO3CMQ0AAAACoEIe9k9nB28GTQEAAACA3wDzeJSGYxMAAA==",
        "v": "H4sIAAAAAAAAAO3CMQ0AAAACoEIe9k9nB28GTQEAAACA3wDzeJSGYxMAAA==",
        "vmag": "H4sIAAAAAAAAAO3CMQ0AAAACoEIe9k9nB28GTQEAAACA3wDzeJSGYxMAAA==",
        "dir": "H4sIAAAAAAAAAO3CMQ0AAAwDIEM9+ta/sflYIKyZqqqqqqqq6tsHKWAM4BUdAAA=",
        "PHY": "H4sIAAAAAAAAAO3DQQkAAAgAsUIi1z+dNXxssLZJVVVVVVVVVVVVVVVV/fQAL7DN/PczAAA="
    }
]

🟠400400参数错误

🟠401401签名无效

获取二维指定帧范围内所有节点的信息

应用场景#

前提条件#

解码解压说明#

请求参数

示例代码

返回响应

应用场景

前提条件

解码解压说明