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

应用场景

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

前提条件

已获取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开始，结果不包含该帧

pollutant

string

可选

污染物名称，多个用逗号隔开

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": "H4sIAAAAAAAA/+3UwQ2AMAwDwIUAlf2XAzEBQlRpkuNzfiJiM45xP9sAgtnPyAAUxrgAUwOSYEe+JxCIyQB2BFgHsAgmAxgCYB2AzgMPFoDCqDfaoOxITmyFdRmzUGikw+8YmVBTJEBNsRYaibXQSCgfGqF10CwkRMGgRIhHiaA2mIWiQDXwEp1ojfP3xN2b4eBdcOlKuGYJnDEpDpcNF+v55QXh+2AXeRtBEARBEARBEARBEARBEIQ/wgUXxlJXL34AAA==",
        "u": "H4sIAAAAAAAA/+3FMQ0AAAgDMEOEzL+6IYOjfZrNmUiSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEl6XAHoOHuYiXQAAA==",
        "v": "H4sIAAAAAAAA/+3FMQ0AAAgDMEOEzL+6IYOjfZrNmUiSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEl6XAHoOHuYiXQAAA==",
        "h": "H4sIAAAAAAAA/+3FMQ0AAAgDMEOEzL+6IYOjfZrNmUiSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEl6XAHoOHuYiXQAAA==",
        "vmag": "H4sIAAAAAAAA/+3FMQ0AAAgDMEOEzL+6IYOjfZrNmUiSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEl6XAHoOHuYiXQAAA==",
        "dir": "H4sIAAAAAAAA/+3FMQ0AAAgDMEOE8M6/MVCAgvZppudUbNu2bdu2bdu2bdu2bdu2bdu2bdu2bdu2bdu2bdu2bdu2bdu2bdu2bdu2bdu2bdu2bft/Ae5kSJwvhQAA",
        "time(hr)": "H4sIAAAAAAAA/zPQMwAAAgX09gMAAAA=",
        "pollutant": "H4sIAAAAAAAA/+3FsQ0AEBAAwF3UIq9V6w0gJhG7M4birrmd+qipzSjxZEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEmSJEk/t84FxL6EBpN0AAA="
    }
]

🟠400400参数错误

🟠401401签名无效

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

应用场景#

前提条件#

解码解压说明#

请求参数

示例代码

返回响应

应用场景

前提条件

解码解压说明