moveTrack

来自于:开发者立即使用

概述

注意:本模块会与百度地图/定位类相关模块冲突,注意编译时不要同时勾选。

moveTrack实现了固定时间间隔上报定位信息的功能,你可以配置请求地址和请求格式,目前支持移动端的json格式和标准的form(表单)格式提交。模块是以服务在形式挂在后台运行。

安卓配置

需要在config.xml里面填上meta-data,可以和百度地图共用一个value值,但一定要有<meta-data这个配置


<meta-data name="com.baidu.lbsapi.API_KEY" value="百度ak" />

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。

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,启动中=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"
    }
}

如果出现只提交了经纬度信息,其它信息为空可能原因有:

  • 百度ak不对,或者配置错了(包名和签名都要对应)

  • 因为在室内,gps定位不到具体位置。

  • 网络不通或网络不好。(要借助网络去查询地址信息,比如你在哪个省,哪个市,哪条街)

  • 上报的坐标位置偏僻,百度数据库解析不了。

可用性

Android系统

stopLocation

关闭定时上报定位信息的服务。

stopLocation();

示例代码

var moveTrack = api.require('moveTrack');
moveTrack.stopLocation();

可用性

Android系统