startLocation

調(diào)用系統(tǒng)自帶定位功能，開始定位

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

params

accuracy：

• 類型：字符串
• 默認(rèn)值：100m
• 描述：（可選項(xiàng)）定位精度
• 取值范圍

10m      //精度在10米范圍內(nèi)
100m     //精度在100米范圍內(nèi)
1km      //精度在1千米范圍內(nèi)
3km      //精度在3千米范圍內(nèi)

filter：

• 類型：數(shù)字
• 默認(rèn)值：1.0
• 描述：（可選項(xiàng)）位置更新所需最小距離（單位米）

autoStop：

• 類型：布爾
• 默認(rèn)值：true
• 描述：（可選項(xiàng)）獲取到位置信息后是否自動(dòng)停止定位

callback(ret, err)

ret：

• 類型：JSON 對(duì)象
• 內(nèi)部字段：

{
    longitude:116.213,                   //經(jīng)度
    latitude:39.213,                     //緯度
    timestamp:1396068155591,             //時(shí)間戳
    status: true                         //定位成功
}

err：

• 類型：JSON 對(duì)象
• 內(nèi)部字段：

{
    msg:""    //錯(cuò)誤描述
}

示例代碼

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

補(bǔ)充說明

本API使用系統(tǒng)自身定位能力進(jìn)行定位。 Android 上使用的是 Google 的定位服務(wù)，因法規(guī)政策的原因，在中國基本無法提供服務(wù)，因此建議國內(nèi)開發(fā)者使用百度定位模塊（baiduLocation）進(jìn)行定位操作。 iOS上使用的是蘋果的定位服務(wù)，不受影響。

可用性

iOS系統(tǒng)，Android系統(tǒng)

可提供的1.0.0及更高版本