aMapLocation

来自于：高德立即使用

概述

aMapLocation 封装了高德定位SDK。高德定位SDK是为移动端应用提供的一套简单易用的定位服务接口，通过使用高德定位SDK，开发者可以轻松为应用程序实现智能、精准、高效的定位功能。该SDK接口使用无次数限制。在使用前，您需先申请Key才可使用。在您使用高德定位SDK之前，请先阅读高德地图API使用条款。

不能同时添加的模块：aMap

开发者使用本模块之前需先去高德地图开放平台申请开发者账号，创建自己的 APP获取Key。Android和iOS平台请分别申请Key进行配置。

使用此模块之前必须先配置 config 文件，配置方法如下：

名称：aMapLocation

参数：

android_api_key

ios_api_key

配置示例:

<feature name="aMapLocation">
  <param name="android_api_key" value="请配置android key"></param>
  <param name="ios_api_key" value="请配置iOS key" ></param>
</feature>

字段描述:

android_api_key：在高德地图开放平台申请的android key。

ios_api_key：在高德地图开放平台申请的iOS key。

用户在使用本模块之前需要获取高德地图API Key，Key 申请的具体流程请参照申请Key。本模块需要的 key 可以和 aMap、aMapLBS 、aMapNavigation 、aMapReportLocation 模块的 key 共用。

模块接口

startLocation

开始定位

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

params

accuracy：

类型：字符串
默认值：100
描述：定位精度（单位米），不能为空，定位时只返回精度范围内的坐标，整型。取值范围10 ，100 ，1000 ，3000

filter：

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

autoStop：

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

callback(ret, err)

ret：

类型：JSON对象
内部字段：

{
    status:true                //操作成功状态值  
    longitude:116.213          //经度
    latitude:39.213            //纬度
    timestamp:1396068155591    //时间戳
}

err：

类型：JSON对象
内部字段：

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

示例代码

var amapLocation = api.require('aMapLocation');
var param = { accuracy: 100, filter: 1, autoStop: true };
var resultCallback = function(ret, err) {
    if (ret.status) {
        alert("经度：" + ret.longitude + "\n纬度：" + ret.latitude + "\n时间：" + ret.timestamp);
    } else {
        alert(err.code + ',' + err.msg);
    }
}
amapLocation.startLocation(param, resultCallback);

可用性

Android系统, iOS系統

可提供的1.0.0及更高版本

stopLocation

停止定位

stopLocation()

示例代码

var amapLocation = api.require('aMapLocation');
amapLocation.stopLocation();

可用性

Android系统, iOS系統

可提供的1.0.0及更高版本