moveTrack

startLocation stopLocation

moveTrack实现了固定时间间隔上报定位信息的功能（安卓），iOS是以最小更新距离上报的。你可以配置请求地址和请求格式，目前支持移动端的json格式和标准的form(表单)格式提交。插件是以服务在形式挂在后台运行。

特别提醒：iOS在打包的时候，需要添加定位权限，要不然没效果。

安卓配置

需要在config.xml里面填上meta-data，可以和百度地图共用一个value值，但一定要有 
iOS配置：
```js
  <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){
    api.alert({msg: 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系统

是否仍需要帮助？ 请保持联络！
最后更新于 2025/09/15