接口服务能力说明

用户可通过上传数据点的方式,向$OneNET_LBS这个数据流上传规定格式的基站信息数据点,平台收到数据点后,会将数据点转化为对应的经纬度信息,方便用户通过API接口查询。

数据点上传

数据流名称 $OneNET_LBS

单基站定位

字段名称数据类型字段是否必填
移动网号intmnc选填、目前仅支持0
移动国家号码intmcc选填、中国默认460
地区区域码intlac必填
基站码intcid必填
网络制式intnetworkType选填
1 GSM
2 CDMA
3 WCDMA
4 TD_CDMA
5 LTE

数据流名称 $OneNET_LBS

多基站定位

字段名称数据类型字段是否必填
移动网号intmnc选填、目前仅支持0
移动国家号码intmcc选填、中国默认460
地区区域码intlac必填
基站码intcid必填
网络制式intnetworkType必填
1 GSM
2 CDMA
3 WCDMA
4 TD_CDMA
5 LTE
信号强度intss选填
当前基站广播信号强度intsignalLength选填
移动台距以确定其发往基站的定时超前量intta选填
基站信息数字进制intflag选/必填
基站信息是10进制flag写10,默认不填为10进制
基站信息是16进制,flag必须填写16

注:
1.当flag为10时,所有上报的数据均为10进制,当flag为16时,所有上报的数据均为16进制,且按照JSON规定,十六进制数当成字符串传。
2.在使用数据点上报时,TYPE类型必须为3。

单基站定位数据上报格式

{
    "$OneNET_LBS": {
        "cid": 30183,
        "lac": 13112,
        "mcc": 460,
        "mnc": 0,
        "networktype": 5,
        "ss": -12,
        "ta": 1
    }
}

多基站定位数据上报格式

{
    "$OneNET_LBS": [{
        "cid": 21089,
        "lac": 6334,
        "mcc": 460,
        "mnc": 0,
        "networktype": 5,
        "ss": -12,
        "ta": 1
    }, {
        "cid": 40673,
        "lac": 6334,
        "mcc": 460,
        "mnc": 0,
        "networktype": 5,
        "ss": -11,
        "ta": 1
    }]
}

API说明

类别功能详细内容
API最新位置查询可返回最后一次基站定位结果
API历史轨迹查询根据输入的时间区间范围实现时间区间内轨迹查询

API接口

{API_ADDRESS}为:api.heclouds.com

最新位置查询

HTTP方法 GET
URL http://API_ADDRESS/devices/device_id/lbs/latestLocation
HTTP头部 api-key:xxxx-ffff-zzzzz
url参数
请求返回 { "errno": 0,
"error":“succ”,
"data":
{ "at": "2018-06-13 15:15:22", //时间
"accuracy": 20, //准确度
"lon": 106.48881, //经度
"lat": 29.62518 //纬度 } }

历史轨迹查询

HTTP方法 GET
URL http://API_ADDRESS/devices/device_id/lbs/getTrail
URL参数 start= 2018-01-10T08:00:35.012 //表示查询轨迹的开始时间, 默认起始时间为本周一零点,可选,精确到毫秒级别
end= 2018-01-10T08:00:35.230 //表示查询轨迹的结束时间,默认结束时间为当前时间,可选 ,精确到毫秒级别
page = 1 //指定页码, 可选
per_page = 30 //指定每页输出设备个数,可选,默认10, 可选
maxLon=130.308 //最大经度, 可选
minLon=100.308 //最小经度, 可选
maxLat=30.0944 //最大纬度, 可选
minLat=10.0944 //最小纬度, 可选
sort = DESC\ASC //可选,默认为ASC(升序)
备注:最大、最小经纬度如果不传,查询所有轨迹。 如果四个参数都传入,则查询范围内轨迹。
HTTP头部 api-key:xxxx-ffff-zzzzz
请求返回 { "errno": 0,
"error":“succ”,
"data": { "page": 1,,
"per_page": 10,
"total_count": 39,
"trail": [
{ "at": "2018-06-13 15:15:22.012", //时间
"accuracy": 20, //精确度
"lon": 106.48881, //经度
"lat": 29.62518 //纬度 },
{ "at": "2018-06-13 18:22:58.234", //时间
"accuracy": 20, //精确度
"lon": 106.48886999999999, //经度
"lat": 29.62514 //纬度 },
{ "at": "2018-06-13 18:25:19.210", //时间
"accuracy": 20, //精确度
"lon": 106.48885, //经度
"lat": 29.62516 //纬度 } ] }
注:
1.最大、最小经纬度如果不传,查询所有轨迹。 如果四个参数都传入,则查询范围内轨迹。
2.基站定位的坐标系为WGS-84坐标系。

个搜索结果,搜索内容 “

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