设备位置订阅 - 平台接口

websocket连接，连接时可以在头中包含token或者在路径参数中包含token。token无效将无法建立websocket连接。
该连接上行数据为发送消息，下行数据为服务器分发的信息。
默认1分钟没有数据传输会关闭连接，订阅端可以每20秒发送一个空的消息，用来保持连接！！！

js代码示例

var ws = new WebSocket("ws://localhost/bvcsp/v1/ws/gpsdata",[token]);

go后台

var upgrader = websocket.Upgrader{
        Subprotocols: []string{r.Header.Get("Sec-WebSocket-Protocol")},
}

all 为true时，订阅当前token有权限的所有设备实时位置，就不用添加/删除设备ID号了。

请求参数

Query 参数

token

string

必需

登录后token信息，如果headers中没有，这里需要有。

示例值:

xxxxxx

Header 参数

Content-Type

string

必需

示例值:

application/json

Sec-WebSocket-Protocol

string

token

必需

示例值:

string

Body 参数application/json

修改订阅列表

all

boolean

可选

是否订阅全部在线设备位置

badd

boolean

是否添加订阅设备

可选

puid

array[string]

设备ID列表

可选

示例

{
    "all": true,
    "badd": true,
    "puid": [
        "string"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

位置

lng

number

经度（WGS84）

必需

lat

number

维度（WGS84）

必需

time

number

定位时间（UTC）

必需

height

number

可选

高度，单位1/100米

angle

number

可选

方向角(正北方向为原点，顺时针为正),单位1/1000度

speed

number

速度(米/小时)

可选

starCount

number

可选

定位星数, <= 0时非卫星定位。

state

number

必需

定位状态(1-定位，0-未定位)

satellite

enum<number>

信号来源

必需

枚举值:

1248163264128

devId

string

设备ID

必需

示例

{
    "lng": 0,
    "lat": 0,
    "time": 0,
    "height": 0,
    "angle": 0,
    "speed": 0,
    "starCount": 0,
    "state": 0,
    "satellite": 1,
    "devId": "string"
}