startLocation

调用系统自带定位功能，开始定位

startLocation({params}, callback(ret, err))

params

accuracy：

  • 类型：字符串
  • 默认值：100m
  • 描述：（可选项）定位精度
  • 取值范围
  1. 10m      //精度在10米范围内
  2. 100m     //精度在100米范围内
  3. 1km      //精度在1千米范围内
  4. 3km      //精度在3千米范围内

filter：

  • 类型：数字
  • 默认值：1.0
  • 描述：（可选项）位置更新所需最小距离（单位米）

autoStop：

  • 类型：布尔
  • 默认值：true
  • 描述：（可选项）获取到位置信息后是否自动停止定位

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     longitude:116.213,                   //经度
  3.     latitude:39.213,                     //纬度
  4.     timestamp:1396068155591,             //时间戳
  5.     status: true                         //定位成功
  6. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     msg:""    //错误描述
  3. }

示例代码

  1. api.startLocation({
  2.     accuracy: '100m',
  3.     filter: 1,
  4.     autoStop: true
  5. }, function(ret, err){
  6.     if(ret && ret.status){
  7.          //获取位置信息成功
  8.     }else{
  9.          alert(JSON.stringify(err));
  10.     }
  11. });

补充说明

本API使用系统自身定位能力进行定位。 Android 上使用的是 Google 的定位服务，因法规政策的原因，在中国基本无法提供服务，因此建议国内开发者使用百度定位模块（baiduLocation）进行定位操作。 iOS上使用的是苹果的定位服务，不受影响。

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本