mtlMap

来自于:官方立即使用

mtlMap 封装了高德地图的 SDK。高德地图 SDK 是为移动端应用提供的一套简单易用的LBS定位服务接口,专注于为广大开发者提供最好的综合定位服务,通过使用高德地图SDK,开发者可以轻松为应用程序实现智能、精准、高效的定位功能。

申请 API Key

用户在使用本模块之前需要获取高德地图API Key,Key 申请的具体流程请参照 申请Key

配置 config 文件

申请到 高德地图 API Key 后,需要配置在 config.xml 文件内。

IOS配置如下:

  • 名称:aMapLBS
  • 参数:apiKey
  • 配置示例:
  <feature name="mtlMap">
    <param name="ios_api_key" value="dd5343be258aa304698e42cd0fc761cd" />
  </feature>
  • 字段描述:
  • ios_api_key:在高德地图开放平台申请的 iOS 版 ak

安卓配置如下:

Android 需要将以下代码拷贝到config.xml中,其中的value值替换成你的appKey即可

<meta-data name="com.amap.api.v2.apikey" value="your app key"/>

注意:

在 iOS 平台上,若要支持后台定位需配置 config.xml 文件的 location 字段

iOS 端 SDK 更新为高德最新版本SDK,最新版本的SDK包含 IDFA 相关功能。所以 iOS 端提交 AppStore 时必须认真阅读 提交AppStore必读,以及如何解决因获取 IDFA 被 AppStore 拒绝的问题?

在 iOS 端,打开高德、百度、腾讯、 苹果地图导航的相关接口,需配置 config.xml 文件 配置可被检测的URL Scheme

百度地图:baidumap
高德地图:iosamap 
腾讯地图:qqmap

注意:应工信部要求,App 安装到设备上首次调用本模块前必须先弹出隐私协议,详情参考SDK合规使用方案。之后需先调用 var mtlMap = api.require('mtlMap'); mtlMap.updateLocationPrivacy(); mtlMap.updateSearchPrivacy(); mtlMap.updateMapViewPrivacy(); 否则地图和定位及搜索接口都无效。

模块接口

getLocation

获取当前坐标

getLocation(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:true,  //布尔类型;操作成功状态值
    latitude:'',  //string;定位纬度信息                 
    longitude:'', //string;定位经度信息
    address:'',   //string;定位地址信息,可能为空
    codeType:'',  //string;定位坐标系,高德地图国内定位返回"GCJ02"坐标系经纬度,国外返回"WGS84"坐标系坐标。iOS不支持
    message:''   //string 错误信息,status为false时返回
}

示例代码

var mtlMap = api.require('mtlMap');
mtlMap.getLocation(function(ret) {
    if (ret.status) {
        alert(JSON.stringify(ret));
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

openLocation

打开地图查看指定坐标位置

openLocation({params}, callback(ret))

params

latitude:

  • 类型:数字类型
  • 描述:(必填)高德地图"GCJ02"坐标系纬度信息

longitude:

  • 类型:数字类型
  • 描述:(必填)高德地图"GCJ02"坐标系经度信息

searchRaidus:

  • 类型:数字类型
  • 描述:(可选)查询半径(单位:米)

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:true,//布尔类型;操作成功状态值
    latitude:'',//string;定位纬度信息                 
    longitude:'',//string;定位经度信息
    address:'',//string;定位地址信息,可能为空
    codeType:'',//string;定位坐标系,高德地图国内定位返回"GCJ02"坐标系经纬度,国外返回"WGS84"坐标系坐标
    message:''//string 错误信息,status为false时返回
}

示例代码

var mtlMap = api.require('mtlMap');
mtlMap.openLocation(function(ret) {
    if (ret.status) {
        alert(JSON.stringify(ret));
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

markAndNavigationDestination

在地图中展示目标点以及跳转第三方地图进行导航

markAndNavigationDestination({params}, callback(ret))

params

address:

  • 类型:string
  • 描述:(可选)目标地区地址

subAddress:

  • 类型:string
  • 描述:(可选)目标地区详细地址

latitude:

  • 类型:数字类型
  • 描述:(可选)高德地图"GCJ02"坐标系纬度信息

longitude:

  • 类型:数字类型
  • 描述:(可选)高德地图"GCJ02"坐标系经度信息

infomation:

  • 类型:JSON对象
  • 描述:(可选)客户信息

userInfo:

  • 类型:数字类型
  • 描述:(可选)用户信息
  • 内部字段:
{
    header:'', //string类型;(可选)目标头像(如果为空则根据名称自动生成)
    userId:'', //string类型;(可选)目标userId
    userName:''//string类型;(可选)    目标名称
}

navigation:

  • 类型:布尔类型
  • 描述:(选填)是否需要导航

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:true,//布尔类型;操作成功状态值
    message:''//字符串类型;操作失败时返回错误信息
}

示例代码

var mtlMap = api.require('mtlMap');
mtlMap.markAndNavigationDestination({
    address:'北京市海淀区颐和园路5号',
    subAddress:'北京大学',
    latitude:39.992806,
    longitude:116.310905,
    userInfo:{
        header:'https://iconfont.alicdn.com/t/74604bac-ec13-488a-9e27-daa17be39db8.png',
        userId:'10001',
        userName:'王先生'
    },
    infomation:'重要合作伙伴',
    navigation:true
},function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

openMapToNavi

打开第三方地图导航

openMapToNavi({params})

params

type:

  • 类型:string
  • 描述:(必选)导航类型
  • 可选值:GAODE:高德地图; BAIDU:百度地图; TENCENT:腾讯地图

latitude:

  • 类型:数字类型
  • 描述:(必选)目的地纬度,高德地图"GCJ02"坐标系

longitude:

  • 类型:数字类型
  • 描述:(必选)目的地精度,高德地图"GCJ02"坐标系

示例代码

var mtlMap = api.require('mtlMap');
mtlMap.openMapToNavi(function(ret) {
    if (ret.status) {
        alert(JSON.stringify(ret));
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

continuousLocationStart

开启持续定位

continuousLocationStart(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:true,//布尔类型;操作成功状态值
    message:''//字符串类型;操作失败时返回错误信息
}

示例代码

var mtlMap = api.require('mtlMap');
mtlMap.continuousLocationStart(function(ret) {
    if (ret.status) {
        alert(JSON.stringify(ret));
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

continuousLocationGet

获取持续定位信息

continuousLocationGet(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    latitude:'',   //string;定位纬度              
    longitude:'',  //string;定位经度
    address:'',    //string;定位地址描述信息
    accuracy:'',   //string;定位精度
    city:'',       //string;城市名称
    cityCode:'',   //string;城市编码
    speed:'',      //string;速度
    province:'',   //string;省信息
    time:'',       //string;定位时间
}

示例代码

var mtlMap = api.require('mtlMap');
mtlMap.continuousLocationGet(function(ret) {
    if (ret) {
        alert(JSON.stringify(ret));
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

continuousLocationStop

关闭持续定位

continuousLocationStop(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:true,//布尔类型;操作成功状态值
    message:''//字符串类型;操作失败时返回错误信息
}

示例代码

var mtlMap = api.require('mtlMap');
mtlMap.continuousLocationStop(function(ret) {
    if (ret.status) {
        alert(JSON.stringify(ret));
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本