moveTrack
来自于:开发者立即使用
moveTrack实现了固定时间间隔上报定位信息的功能(安卓),iOS是以最小更新距离上报的。你可以配置请求地址和请求格式,目前支持移动端的json格式和标准的form(表单)格式提交。模块是以服务在形式挂在后台运行。
特别提醒:iOS在打包的时候,需要添加定位权限,要不然没效果。
安卓配置
需要在config.xml里面填上meta-data,可以和百度地图共用一个value值,但一定要有<meta-data这个配置
<meta-data name="com.baidu.lbsapi.API_KEY" value="百度ak" />
iOS配置:
<preference name="backgroundMode" value="location"/>
<feature name="moveTrack">
<param name="com.baidu.lbsapi.API_KEY" value="d709mnb5O5QghzTbuw8ZHMCWDRqqDTrG"/>
</feature>
startLocation
开启定位服务,定时上报用户定位信息。
startLocation({params}, callback(ret))
params
url:
- 类型:字符串
- 描述:(必填)上报服务器的请求地址。
dataType:
- 类型:字符串
- 描述:(可选项)post数据的格式,json表示以json字符串作为body提交,后台需要解析body获取数据,格式灵活,移动开发最爱。key-value是以标准的form(表单)格式提交,默认是json。
coorType:
- 类型:字符串
- 描述:(可选项)gcj02=国测局经纬度坐标系, bd09=百度墨卡托坐标系, bd09ll=百度经纬度坐标系, 默认是bd09ll, 建议不传值用默认的就好。
headers:
- 类型:JSON 对象
- 描述:(可选项)自定义上传header数据格式,根必须是对象{}, 不能是数组[], 一层键值对。{“key”:”value”,”key2”:”value2”}。可以通过这个参数上传数据到apicloud云 -> moveTrack如何上传数据到apicloud云?
data:
- 类型:JSON 对象
- 描述:(可选项)自定义上传数据格式,根必须是对象{}, 不能是数组[], 如果dataType=key-value, 则只支持一级对象(不支持对象套对象),dataType=json没有这个限制。
openGPS:
- 类型:布尔
- 描述:(可选项)是否开启GPS, 默认为true。(仅安卓有效)
scanSpan:
- 类型:数字
- 描述:(可选项)上报的时间间隔,单位为毫秒(ms),默认为3000ms。(仅安卓有效)
distanceFilter:
- 类型:数字
- 描述:(可选项)上报的最小距离,单位米(m),默认为1米,就是移动距离超过1米就提交一次。(仅iOS有效)
isNeedAddress:
- 类型:布尔
- 描述:(可选项)是否需要地址信息,默认为false。
prodName:
- 类型:字符串
- 描述:(可选项)产品名称,默认为apicloud,可以修改为自己APP的名称。(仅安卓有效)
prefix:
- 类型:字符串
- 描述:(可选项)字段名的前辍。
dataType=json
prefix=user_loc的情况
{
"id": "123",
"user_loc": {
"time": "2017-06-08 10:22:27",
"latitude": "0.0000",
"lontitude": "0.0000"
}
}
dataType=key-value
prefix=user_loc. (注,user_loc后面带一个点) 的情况
id=123&user_loc.latitude=0.0000&user_loc.lontitude=0.0000
一个前辍加一个点就能变成对象,后台开发人员懂的啦。
callback(ret)
ret:
- 类型:JSON对象
- 内部字段:
{
code: -1 , //失败=-1,未启动或已断开=0,启动中=1,启动成功或已启动=2
msg : "" //提示信息
}
示例代码
var moveTrack = api.require('moveTrack');
moveTrack.startLocation({
"url": "http://www.xxx_for_test.com"
}, function(ret){
alert(JSON.stringify(ret));
});
提交的定位信息
{
"id": "123",
"name": "ken",
"location": {
"time": "2017-06-08 11:03:40",
"locType": 161,
"operationers": 2,
"city": "广州市",
"addr": "中国广东省广州市越秀区人民北路000号大院",
"street": "人民北路",
"speed": 0,
"country": "中国",
"countryCode": "0",
"radius": 40,
"description": "NetWork location successful!",
"locationDescribe": null,
"district": "越秀区",
"latitude": "1.1375",
"citycode": "257",
"lontitude": "2.2583"
}
}
iOS版本格式:
{
"userid" : "测试人员1号",
"location" : {
"province" : "广东省",
"locationDescribe" : "在广轻大厦附近",
"street" : "医国后街",
"countryCode" : "0",
"cityCode" : "257",
"latitude" : 23.14186878251656,
"city" : "广州市",
"district" : "越秀区",
"streetNumber" : "1号",
"country" : "中国",
"adCode" : "440104",
"lontitude" : 113.2643918942876
}
}
如果出现只提交了经纬度信息,其它信息为空可能原因有:
百度ak不对,或者配置错了(包名和签名都要对应)
因为在室内,gps定位不到具体位置。
网络不通或网络不好。(要借助网络去查询地址信息,比如你在哪个省,哪个市,哪条街)
上报的坐标位置偏僻,百度数据库解析不了。
可用性
Android系统、iOS系统
stopLocation
关闭定时上报定位信息的服务。
stopLocation();
示例代码
var moveTrack = api.require('moveTrack');
moveTrack.stopLocation();
可用性
Android系统、iOS系统