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 可以和 aMapaMapLBSaMapNavigationaMapReportLocation 模块的 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及更高版本