getLocation

获取位置信息,获取成功后自动停止获取。

若之前已通过 startLocation() 方法进行定位,则直接返回上次定位的数据,否则使用默认设置进行定位

getLocation(callback(ret, err))

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.getLocation(function(ret, err) {
  2. if (ret && ret.status) {
  3. //获取位置信息成功
  4. } else {
  5. alert(JSON.stringify(err));
  6. }
  7. });

补充说明

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

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本