接口名称

人员定位数据信息推送接口

地址

http://(服务部署的ip):8888/location/sendLocationData

请求方式

POST

参数

参数

名称

类型

是否必填

sceneId

场景ID

String

是

tokenId

用户tokenId

String

是

locationData

定位数据

String

是

返回值

成功

失败

{

    "code": 200,

    "message": "操作成功",

    "result": true

}

{

    "code": 500,

    "message": "xxxxxx",

    "result": null

}

说明

流程示例：

（注意：在推送之前，请确保要推送的场景开启相关配置，所有推送的数据时效性在15分钟，超过15分钟失效，如图所示，相关配置可自定义）

1. 选取要推送的模型，可以访问http://localhost:9001/models.html地址查看您想在场景中要展示的推送模型，滑动鼠标并获取相关模型id

2. 向接口推送请求http://(服务部署的ip):8888/location/sendLocationData

1. sceneId参数格式：

15718869989M3022388056

如何获取您的sceneId？

2. tokenId参数格式

tokenId:152816683990t9588274423

如何获取您的tokenId？

进入到系统后台管理，在登录用户管理模块选择要编辑的用户名，弹出编辑面板，打开”可远程调用”，此时会生成tokenId，并展示在相关列表

3. locationData参数格式：

locationData:{"locationData":[

{

"objectId":"1",

"objectName":"张三",

"modelId":"66b7f5979ff043afa4e79f7299853a4b",

"locationDataTime":"2019-11-08 13:05:00",

"location":"[207.18262815475464,150.42277832647168e-24,-91.54146695137024]"

}

]}

参数说明：

objectId: 推送对象ID (可自定义生成规则)

objectName: 对象名称(可自定义)

modelId: 模型ID(将第一步骤获取的模型id写入此处)

locationDataTime: 数据推送时间(年月日时分秒)

location: 定位坐标（x,y,z格式）

(4)整体推送效果如下
 {
"locationData":"{
\"locationData\":[{\"objectId\":\"1\",\"objectName\":\"张三\",\"modelId\":\"66b7f5979ff043afa4e79f7299853a4b\",\"locationDataTime\":\"2019-11-14 17:18:00\",\"location\":\"[207.18262815475464,150.42277832647168e-24,-91.54146695137024]\"}]}",
 "sceneId": "1573441513828t3541232245",
 "tokenId": "f63f3ff56de948cf8b680473b3359e81"
}
（注意：工具推送需要加入转义字符“\”,代码推送不需要加入转义字符，locationDataTime为当前推送的时）

3.推送成功后会在场景中展示如下

当不改变其他参数，只改locationData中的locationDataTime与location，再次进行推送，会出现位置移动效果