OneNET Studio 简介 产品介绍 快速入门 设备接入与管理 应用开发
应用开发流程 新建项目 添加设备 设备分组 场景联动 应用数据流转 应用API 应用长连接 规则引擎(新)
运维监控 数据可视化 边缘计算 人工智能AI 位置定位 语音通话 工业互联网标识 权限管理 服务协议 更新日志

基站定位API文档

本页目录


1. 基站定位-设备最新位置查询

接口名称

latestLocation

请求方法

GET

URL

http://openapi.heclouds.com/lbs

HTTP头部

key : authorization

value : 查看鉴权参数计算方法

URL参数

参数名称 类型 是否必选 描述
action string 接口名称
该值为latestLocation
version string 版本信息
该值为1
product_id string 产品ID
device_name string 设备名称

返回数据

参数名称 类型 描述
code string 调用失败时,返回的错误码,为0表示调用成功
msg string 调用失败时,返回的错误信息,为"success"表示调用成功
data - 调用成功时,返回的业务数据
data. at string 时间
data.accuracy string 准确度
data.lon string 经度
data.lat string 纬度

示例

请求示例

GET http://openapi.heclouds.com/lbs?action=latestLocation&version=1&product_id=lqIY8PNO38a2Ce4o&device_name=linglong-Test

Content-type: application/json

响应示例
{
"code": "0",
"msg":"success",
"data": {
         "at": "2020-06-13 15:15:22",  //时间
         "accuracy": 20,   //准确度
         "lon": 106.48881,   //经度
         "lat": 29.62518   //纬度
      }
}

2. 基站定位-设备历史轨迹查询

接口名称

getTrail

请求方法

GET

URL

http://openapi.heclouds.com/lbs

HTTP头部

key : authorization

value : 查看鉴权参数计算方法

URL参数

参数名称 类型 是否必选 描述
action string 接口名称
该值为getTrail
version string 版本信息
该值为1
product_id string 产品ID
device_name string 设备名称
start string 查询轨迹的开始时间, 默认起始时间为本周一零点,精确到毫秒级别
end string 查询轨迹的结束时间,默认结束时间为当前时间,精确到毫秒级别
page int 指定页码
per_page int 指定每页输出个数,默认10
maxLon string 最大经度
minLon string 最小经度
maxLat string 最大纬度
minLat string 最小纬度
sort string 排序规则
DESC或ASC,默认为ASC(升序)

备注:最大、最小经纬度如果不传,查询所有轨迹。如果四个参数都传入,则查询范围内轨迹。

返回数据

参数名称 类型 描述
code string 调用失败时,返回的错误码,为0表示调用成功
msg string 调用失败时,返回的错误信息,为"success"表示调用成功
data - 调用成功时,返回的业务数据
data.page int 指定页码
data.perPage int 每页输出个数
data.total_count int 位置记录总数
data.items 数组 设备的位置记录数据

items数据结构

参数名称 类型 描述
at string 时间
accuracy string 准确度
lon string 经度
lat string 纬度

示例

请求示例

GET http://openapi.heclouds.com/lbs?action=getTrail&version=1&product_id=lqIY8PNO38a2Ce4o&device_name=linglong-Test&start=2020-04-16T08:00:35.012&end=2020-06-30T18:40:35.012&page=1&per_page=2

Content-type: application/json

响应示例
{
"code":"0",
"msg":"successess",
"data": {
        "page": 1,
        "perPage": 10,
        "total_count": 3,
        "items": [
            {
                "at": "2020-04-16T08:00:35.012",  //时间
                "accuracy": 20,  //精确度
                "lon": 106.48881, //经度
                "lat": 29.62518  //纬度
            },
            {
                "at": "2020-05-13 18:22:58.234",  //时间
                "accuracy": 20,  //精确度
                "lon": 106.48886999999999, //经度
                "lat": 29.62514  //纬度
            },
            {
                "at": "2020-06-30T18:40:35.012",  //时间
                "accuracy": 20,  //精确度
                "lon": 106.48885,  //经度
                "lat": 29.62516  //纬度
            }       
]
}

个搜索结果,搜索内容 “

    0 个搜索结果,搜索内容 “