startLocation

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

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

params

accuracy：

• 类型：字符串
• 默认值：100m
• 描述：（可选项）定位精度
• 取值范围

10m      //精度在10米范围内
100m     //精度在100米范围内
1km      //精度在1千米范围内
3km      //精度在3千米范围内

filter：

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

autoStop：

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

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

{
    longitude:116.213,                   //经度
    latitude:39.213,                     //纬度
    timestamp:1396068155591,             //时间戳
    status: true                         //定位成功
}

err：

• 类型：JSON 对象
• 内部字段：

{
    msg:""    //错误描述
}

示例代码

api.startLocation({
    accuracy: '100m',
    filter: 1,
    autoStop: true
}, function(ret, err){
    if(ret && ret.status){
         //获取位置信息成功
    }else{
        api.alert({
            msg:JSON.stringify(err)
        });
    }
});

补充说明

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

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本