aMap

来自于:官方立即使用

基础类

open close show hide setRect getLocation stopLocation getCoordsFromName getNameFromCoords getDistance showUserLocation setTrackingMode setCenter getCenter setZoomLevel getZoomLevel setMapAttr setRotation getRotation setOverlook getOverlook setRegion getRegion setScaleBar setCompass setLogo takeSnapshotInRect isPolygonContainsPoint isCircleContainsPoint interconvertCoords addEventListener removeEventListener setMapLanguage

室内地图

isShowsIndoorMap showsIndoorMap isShowsIndoorMapControl showsIndoorMapControl indoorMapControlSize setIndoorMapControlOrigin setCurrentIndoorMapFloorIndex clearIndoorMapCache

标注、气泡类

addAnnotations cancelAnnotationSelected getAnnotationCoords setAnnotationCoords annotationExist setBubble popupBubble closeBubble addBillboard addWebBoard addWebBoardListener removeWebBoardListener addMobileAnnotations moveAnnotation removeAnnotations setWebBubble addWebBubbleListener removeWebBubbleListener addMoveAnimation cancelMoveAnimation showAnnotations

覆盖物类

addHeatMap refreshHeatMap addMultiPoint addLine addCircle addPolygon addImg addLocus removeOverlay

搜索类

searchRoute drawRoute removeRoute searchBusRoute drawBusRoute removeBusRoute searchInCity searchNearby searchInPolygon
autocomplete
districtSearch
weatherSearch

离线地图类

getProvinces getCitiesByProvince getMunicipalities getNationWide getAllCities getVersion downloadRegion isDownloading pauseDownload cancelAllDownload
clearDisk checkNewestVersion reloadMap

经纬度坐标转换、轨迹纠偏

convertCoordinate processedTrace cancelProcessedTrace

论坛示例

为帮助用户更好更快的使用模块,论坛维护了一个示例,示例中包含示例代码、知识点讲解、注意事项等,供您参考。

概述

高德地图简介

高德地图 是国内一流的免费地图导航产品,也是基于位置的生活服务功能最全面、信息最丰富的手机地图,由国内最大的电子地图、导航和LBS服务解决方案提供商高德软件(纳斯达克AaMap)提供。高德地图采用领先的技术为用户打造了最好用的“活地图”,不管在哪、去哪、找哪、怎么去、想干什么一图在手,统统搞定,省电省流量更省钱,堪称最完美的生活出行软件。地图数据覆盖中国大陆及香港澳门,遍及337个地级2857个县级以上行政区划单位;导航支持GPS、基站、网络等多种方式一键定位。美食、酒店、演出、商场等各种深度POI点达2600多万条,衣食住行吃喝玩乐全方位海量生活信息可供搜索查询。自动生成“最短”“最快”“最省钱”等多种路线规划以供选择,可根据实时路况选择最优公交/驾车出行路线。

高德地图特色功能

动态导航

交通路况实时播报,智能计算到达目的地所需的时间,避堵路线方案规划

离线下载

3D离线地图,分地区下载地图包,全国地图包、全国概要图

地图搜索

热门地点、线路搜索,公交、自驾出行线路规划,公交、火车、天气查询服务

全新引擎

最新3D版本,360度旋转视角,矢量数据传送,观看更流畅、更清晰。

兴趣点

餐饮、住宿、优惠、演出、团购全覆盖,海量兴趣点随意搜

模块概述

aMap 模块封装了高德地图的原生 SDK,集成了高德地图常用基本接口;手机版原生地图,不同于 js 地图,相对于js地图而言,本模块封装的原生手机地图更加流畅迅速、动画效果更加逼真。使用此模块可轻松把高德地图集成到自己的app内,实现高德地图常用的定位、关键字搜索、周边搜索、自定义标注及气泡、查公交路线等各种功能;另外本模块已支持高德地图离线版本。

若某些带UI的接口不能满足开发设计需求,开发者(借助于原生开发者)可在本模块基础上修改少量原生代码,随心所欲的自定义高德地图所具有的原生功能,简单、轻松、快捷、高效、迅速集成高德地图,将自己的 app 和高德地图实现无缝链接。模块原生代码开源地址为:https://github.com/apicloudcom/moduleCode/aMap

模块使用攻略

注意事项

本模块内带动画效果的接口不可同时调用(两个以上),需要设置延迟(setTimeout)处理。

需要在APICloud 网站控制台编译界面选择定位权限。凡是需要使用定位功能的模块,请先选择定位权限

不能同时添加的模块:aMapLocation, baiduLocation

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

  • 名称:aMap
  • 参数:android_api_key、ios_api_key
  • 备注:同一个 App 需要同时支持 iOS 和 Android 平台,必须单独申请各自的 apiKey,并同时配置在 config 文件中
  • 配置示例:
  1. <feature name="aMap">
  2. <param name="android_api_key" value="f7Is0dWLom2q6rV3ZfFPZ1aa" />
  3. <param name="ios_api_key" value="81qz3dBYB5q2nGji4IYrawr1" />
  4. </feature>
  • 字段描述:

    android_api_key:在高德地图开放平台申请的 Android 端 AK

    ios_api_key:在高德地图开放平台申请的 iOS 端 AK

用户在使用本模块之前需要获取高德地图API Key,Key 申请的具体流程请参照 申请Key。本模块需要的 key 可以和 aMapLBSaMapLocationaMapNavigationaMapReportLocation 模块的 key 共用(即相关key配置一个即可)。

注意:在 iOS 上版本使用定位功能,需要在云编译时勾选 定位(使用期间)定位服务(始终)

模块接口

open

打开高德地图

open({params}, callback(ret))

params

rect:

  • 类型:JSON 对象
  • 描述:(可选项)模块的位置及尺寸
  • 内部字段:
  1. {
  2. x: 0, //(可选项)数字类型;地图左上角的 x 坐标(相对于所属的 Window 或 Frame);默认:0
  3. y: 0, //(可选项)数字类型;地图左上角的 y 坐标(相对于所属的 Window 或 Frame);默认:0
  4. w: 320, //(可选项)数字类型;地图的宽度;默认:'auto'
  5. h: 480 //(可选项)数字类型;地图的高度;默认:'auto'
  6. }

center:

  • 类型:数字
  • 描述:(可选项)打开地图时设置的中心点经纬度,若不传则默认打开北京市为中心的地图
  • 内部字段:
  1. {
  2. lon: 116.213, //数字类型;打开地图时设置的中心点经度
  3. lat: 39.213 //数字类型;打开地图时设置的中心点纬度
  4. }

zoomLevel:

  • 类型:数字
  • 描述:(可选项)设置高德地图缩放等级,取值范围:3-18级
  • 默认值:10

showUserLocation:

  • 类型:布尔
  • 描述:(可选项)是否在地图上显示用户位置
  • 默认值:true

userLocationCanShowCallout:

  • 类型:布尔
  • 描述:(可选项)地图上显示用户位置时,是否支持点击位置弹出提示,只支持iOS端
  • 默认值:true

showsAccuracyRing:

  • 类型:布尔
  • 描述:(可选项)是否在地图上显示用户位置的精度圈儿
  • 默认值:true
  • 注意:若open时本参数为false 则 showUserLocation 接口传 true 也无法显示精度圈儿

isGestureScaleByMapCenter:

  • 类型:布尔
  • 描述:(可选项) 设置是否以地图中心点缩放 (ios不支持)
  • 默认值:false

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:模块依附于当前 window

fixed:

  • 类型:布尔
  • 描述:(可选项)模块是否随所属 window 或 frame 滚动
  • 默认值:true(不随之滚动)

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.open({
  3. rect: {
  4. x: 0,
  5. y: 0,
  6. w: 320,
  7. h: 300
  8. },
  9. showUserLocation: true,
  10. zoomLevel: 11,
  11. center: {
  12. lon: 116.4021310000,
  13. lat: 39.9994480000
  14. },
  15. fixedOn: api.frameName,
  16. fixed: true
  17. }, function(ret, err) {
  18. if (ret.status) {
  19. alert(JSON.stringify(ret));
  20. } else {
  21. alert(JSON.stringify(err));
  22. }
  23. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭高德地图

close()

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.close();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

show

显示高德地图

show()

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.show();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

hide

隐藏高德地图

hide()

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.hide();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setRect

重设地图的显示区域

setRect({params})

params

rect:

  • 类型:JSON 对象
  • 描述:(可选项)模块的位置及尺寸
  • 内部字段:
  1. {
  2. x: 0, //(可选项)数字类型;地图左上角的 x 坐标(相对于所属的 Window 或 Frame);默认:原值
  3. y: 0, //(可选项)数字类型;地图左上角的 y 坐标(相对于所属的 Window 或 Frame);默认:原值
  4. w: 320, //(可选项)数字类型;地图的宽度;默认:原值
  5. h: 480 //(可选项)数字类型;地图的高度;默认:原值
  6. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setRect({
  3. rect: {
  4. x: 0,
  5. y: 0,
  6. w: 320,
  7. h: 300
  8. }
  9. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getLocation

获取当前位置信息,若要支持后台定位需配置 config.xml 文件 location 字段。iOS上调用本接口需先 open,在iOS 平台上 showUserLocation 为 false 时此接口不可用

注:根据高德地图技术回复,在有的手机上及时拒绝手机定位权限,依然可以获取到位置信息

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

params

autoStop:

  • 类型:布尔
  • 描述:(可选项)获取到位置信息后是否自动停止定位
  • 默认值:true

enableLocInForeground:

  • 类型:布尔类型
  • 描述:(可选项) 开发者应用如果有后台定位需求,在退到后台的时候,为了保证定位可以在后台一直运行,可以设置为true,适配android 8后台无法定位问题;注:单次定位(autoStop为true时)无效(ios不支持)
  • 默认值:false

notification:

  • 类型:JSON对象
  • 描述:(必选项) 通知栏的提示,此字段只有在enableLocInForeground设置为true时有效。(ios不支持)

内部字段:

  1. {
  2. title : //(可选项) 字符串类型;标题; 默认值:应用名称
  3. content: //(可选项) 字符串类型;内容; 默认值:正在后台运行
  4. }

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. lon: 116.213, //数字类型;经度
  4. lat: 39.213, //数字类型;纬度
  5. accuracy: 65, //数字类型;本次定位的精度
  6. timestamp: 1396068155591, //数字类型;时间戳
  7. heading:200, //数字类型;设备方向,取值范围:0.0(正北) - 359.9
  8. altitude: 200 //数字类型;当前设备所处的海拔信息
  9. verticalAccuracy: 10 //数字类型;垂直位置精度,无效时为负数 (android不支持)
  10. horizontalAccuracy: 20 //数字类型;平面位置精度,无效时为负数(android不支持)
  11. course: 200 //数字类型;偏离正北方向的角度,无效时为负数,范围 0.0 - 359.9
  12. speed: 200 //数字类型;速度,无效时为负数,单位:m/s
  13. floor: 2 //数字类型;在建筑物的第几层,无效时不返回
  14. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getLocation(function(ret, err) {
  3. if (ret.status) {
  4. alert(JSON.stringify(ret));
  5. } else {
  6. alert(JSON.stringify(err));
  7. }
  8. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

stopLocation

停止定位

stopLocation()

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.stopLocation();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getCoordsFromName

根据地址查找经纬度,无需调用 open 接口即可使用

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

params

city:

  • 类型:字符串
  • 描述:(可选项)所要搜索的地址所在的城市,cityname(中文或中文全拼)、citycode、adcode
  • 注意:如果address是完整的地址,本参数可不传。若传必须传城市,不可带省,如:济南;不能传山东济南

address:

  • 类型:字符串
  • 描述:完整的地址信息

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. lon: 116.351, //数字类型;地址所在经度
  4. lat: 39.283 //数字类型;地址所在纬度
  5. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: 1 //数字类型;错误码
  3. msg: //字符串类型;错误描述
  4. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getCoordsFromName({
  3. city: '济南',
  4. address: '济南市市中区趵突泉南路1号趵突泉公园内'
  5. }, function(ret, err) {
  6. if (ret.status) {
  7. alert(JSON.stringify(ret));
  8. } else {
  9. alert(JSON.stringify(err));
  10. }
  11. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getNameFromCoords

根据经纬度查找地址信息,无需调用 open 接口即可使用

getNameFromCoords({params}, callback(ret))

params

lon:

  • 类型:数字
  • 描述:经度

lat:

  • 类型:数字
  • 描述:纬度

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. address: '', //字符串类型;地址信息
  4. state: '', //字符串类型;省份
  5. city: '', //字符串类型;城市
  6. district: '', //字符串类型;县区
  7. street: '', //字符串类型;街道名
  8. number: '', //字符串类型;门牌号
  9. thoroughfare: '', //字符串类型;社区
  10. township: '', //字符串类型;乡镇
  11. building: '', //字符串类型;建筑
  12. adcode: '', //字符串类型;地址编号
  13. citycode: '' //字符串类型;城市编号
  14. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getNameFromCoords({
  3. lon: 116.384767,
  4. lat: 39.989539
  5. }, function(ret, err) {
  6. if (ret.status) {
  7. alert(JSON.stringify(ret));
  8. } else {
  9. alert(JSON.stringify(err));
  10. }
  11. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getDistance

获取地图两点之间的距离,无需调用 open 接口即可使用

getDistance({params}, callback(ret))

params

start:

  • 类型:JSON 对象
  • 描述:起点经纬度
  • 内部字段:
  1. {
  2. lon: 106.486654, //数字类型;起点的经度
  3. lat: 29.490295 //数字类型;起点的纬度
  4. }

end:

  • 类型:JSON 对象
  • 描述:终点经纬度
  • 内部字段:
  1. {
  2. lon: 106.581515, //数字类型;终点的经度
  3. lat: 29.615467 //数字类型;终点的纬度
  4. }

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. distance: 16670.90 //数字类型;两点之间的距离,单位:米
  4. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getDistance({
  3. start: {
  4. lon: 106.486654,
  5. lat: 29.490295
  6. },
  7. end: {
  8. lon: 106.581515,
  9. lat: 29.615467
  10. }
  11. }, function(ret, err) {
  12. if (ret.status) {
  13. alert(JSON.stringify(ret));
  14. } else {
  15. alert(JSON.stringify(err));
  16. }
  17. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showUserLocation

是否在地图上显示用户位置

showUserLocation({params})

params

isShow:

  • 类型:布尔
  • 描述:(可选项)是否显示用户位置
  • 默认值:true

imagePath:

  • 类型:字符串
  • 描述:(可选项)当前位置显示图标的图片,要求本地路径支持fs,widget
  • 默认值:高德地图默认当前位置图标

imageSize:

  • 类型:JSON 对象
  • 描述:(可选项)设置的当前位置显示图标的大小,当imagePath 为空时,本参数无意义。
  • 默认值:原图宽高的一半
  • 内部字段:
  1. {
  2. w:, //(可选项)数字类型;图标宽度;默认:原图宽的一半
  3. h: //(可选项)数字类型;图标高度度;默认:原图高的一半
  4. }

showsAccuracyRing:

  • 类型:布尔
  • 描述:(可选项)精度圈是否显示
  • 默认值:true
  • 注意:若 open 时 showsAccuracyRing 为false 则本接口的此参数传 true 也无法显示精度圈儿

showsHeadingIndicator:

  • 类型:布尔
  • 描述:(可选项)是否显示方向指示(setTrackingMode接口heading模式开启)
  • 默认值:true

enablePulseAnnimation:

  • 类型:布尔
  • 描述:(可选项)内部蓝色圆点是否使用律动效果(android不支持)
  • 默认值:true

fillColor:

  • 类型:字符串
  • 描述:(可选项)精度圈 填充颜色
  • 默认值:系统默认色

strokeColor:

  • 类型:字符串
  • 描述:(可选项)精度圈 边线颜色
  • 默认值:系统默认色

dotBgColor:

  • 类型:字符串
  • 描述:(可选项)定位点背景色(android不支持)
  • 默认值:白色

dotFillColor:

  • 类型:字符串
  • 描述:(可选项)定位点蓝色圆点颜色(android不支持)
  • 默认值:蓝色

lineWidth:

  • 类型:数字
  • 描述:(可选项)精度圈 边线宽度
  • 默认值:0

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.showUserLocation({
  3. isShow: true
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setTrackingMode

设置跟踪类型

setTrackingMode({params})

params

trackingMode:

  • 类型:字符串
  • 描述:(可选项)用户当前位置显示形式
  • 默认值:none
  • 取值范围:
    • none(不追踪用户的 location 更新)
    • follow(追踪用户的 location 更新)
    • heading(追踪用户的 location 与 heading 更新)

animation:

  • 类型:布尔类型
  • 描述:(可选项)设置地图的当前位置标记的追踪状态时,是否带动画效果,暂仅支持 iOS 平台
  • 默认:true

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setTrackingMode({
  3. animation: false,
  4. trackingMode: 'none'
  5. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setCenter

根据经纬度设置高德地图中心点

setCenter({params})

params

coords:

  • 类型:JSON 对象
  • 描述:(可选项)中心点的经纬度
  • 内部字段:
  1. {
  2. lon: 116.404, //(可选项)数字类型;设置中心点的经度
  3. lat: 39.915 //(可选项)数字类型;设置中心点的纬度
  4. }

animation:

  • 类型:布尔类型
  • 描述:(可选项)设置地图的中心点时,是否带动画效果
  • 默认:true

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setCenter({
  3. coords: {
  4. lon: 116.404,
  5. lat: 39.915
  6. },
  7. animation: false
  8. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getCenter

获取高德地图中心点坐标

getCenter(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. lon: 116.404, //数字类型;地图中心点的经度
  3. lat: 39.915 //数字类型;地图中心点的纬度
  4. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getCenter(function(ret, err) {
  3. if (ret) {
  4. alert(JSON.stringify(ret));
  5. } else {
  6. alert(JSON.stringify(err));
  7. }
  8. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setZoomLevel

设置高德地图缩放等级

setZoomLevel({params})

params

level:

  • 类型:数字
  • 描述:(可选项)地图比例尺级别,取值范围:0.01-20
  • 默认值:10

animation:

  • 类型:布尔类型
  • 描述:(可选项)地图缩放时,是否带动画效果
  • 默认:true

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setZoomLevel({
  3. level: 10,
  4. animation: true
  5. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getZoomLevel

获取地图缩放级别(0.01-20)

getZoomLevel(callback(ret, err))

callback

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. level: 11 //数字类型;地图当前缩放级别
  3. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getZoomLevel(function(ret, err) {
  3. if (ret) {
  4. alert(JSON.stringify(ret));
  5. } else {
  6. alert(JSON.stringify(err));
  7. }
  8. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setMapAttr

设置高德地图相关属性

setMapAttr({params})

params

type:

  • 类型:字符串
  • 描述:(可选项)设置地图类型
  • 默认值:’standard’
  • 取值范围:
    • standard(标准地图)
    • satellite(卫星地图)
    • night(夜间模式)

trafficOn:

  • 类型:布尔
  • 描述:(可选项)是否打开实时路况
  • 默认值:false

zoomEnable:

  • 类型:布尔
  • 描述:(可选项)捏合手势是否可以缩放地图
  • 默认值:true

scrollEnable:

  • 类型:布尔
  • 描述:(可选项)拖动手势是否可以移动地图
  • 默认值:ture

overlookEnabled:

  • 类型:布尔
  • 描述:(可选项)是否支持俯视旋转
  • 默认值:ture

rotateEnabled:

  • 类型:布尔
  • 描述:(可选项)是否支持平面旋转
  • 默认值:ture

building:

  • 类型:布尔
  • 描述:(可选项)是否隐藏楼块,俯视角度不为零时的楼快效果,Android 平台上默认打开状态,且不可改变
  • 默认值:false

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setMapAttr({
  3. type: 'standard',
  4. trafficOn: true,
  5. zoomEnable: false,
  6. scrollEnable: false,
  7. building: true,
  8. overlookEnabled: false,
  9. rotateEnabled: false
  10. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setRotation

设置高德地图旋转角度(逆时针为正向)

setRotation({params})

params

degree:

  • 类型:数字
  • 描述:(可选项)地图旋转角度,取值范围:-180° - 180°
  • 默认值:0

animation:

  • 类型:布尔
  • 描述:(可选项)地图旋转时,是否带动画效果
  • 默认:true

duration:

  • 类型:数字
  • 描述:(可选项)地图旋转动画时长,单位秒(s)
  • 默认:0.3

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setRotation({
  3. degree: 30,
  4. animation: true,
  5. duration: 0.3
  6. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getRotation

获取地图当前旋转角度

getRotation(callback(ret, err))

callback

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. rotation: 11 //数字类型;地图当前旋转角度
  3. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getRotation(function(ret) {
  3. alert(JSON.stringify(ret.level));
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setOverlook

设置地图俯视角度(范围为[0.f, 60.f])

setOverlook({params})

params

degree:

  • 类型:数字
  • 描述:(可选项)地图俯视角度,取值范围:0° - 60°
  • 默认值:0

animation:

  • 类型:布尔
  • 描述:(可选项)地图俯视角度转动时,是否带动画效果
  • 默认:true

duration:

  • 类型:数字
  • 描述:(可选项)地图俯视角度转动动画时长,单位秒(s)
  • 默认:0.3

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setOverlook({
  3. degree: 30,
  4. animation: true,
  5. duration: 0.3
  6. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getOverlook

获取地图当前俯视角度

getOverlook(callback(ret, err))

callback

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. overlook: 11 //数字类型;地图当前俯视角度
  3. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getOverlook(function(ret) {
  3. alert(JSON.stringify(ret.level));
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setRegion

设置地图显示范围(矩形区域)

setRegion({params})

params

lbLon:

  • 类型:数字
  • 描述:矩形区域左下角的经度

lbLat:

  • 类型:数字
  • 描述:矩形区域左下角的纬度

rtLon:

  • 类型:数字
  • 描述:矩形区域右上角的经度

rtLat:

  • 类型:数字
  • 描述:矩形区域右上角的纬度

animation:

  • 类型:布尔类型
  • 描述:(可选项)设置地图的区域时,是否带动画效果
  • 默认:true

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setRegion({
  3. lbLon: 116.027143,
  4. lbLat: 39.772348,
  5. rtLon: 116.832025,
  6. rtLat: 40.126349,
  7. animation: true
  8. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getRegion

获取地图显示范围(矩形区域)

getRegion(callback(ret, err))

callback

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. lbLon: 116.027143, //数字类型;矩形区域左下角的经度
  4. lbLat: 39.772348, //数字类型;矩形区域左下角的纬度
  5. rtLon: 116.832025, //数字类型;矩形区域右上角的经度
  6. rtLat: 40.126349 //数字类型;矩形区域右上角的纬度
  7. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getRegion(function(ret) {
  3. if (ret.status) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setScaleBar

设置高德地图比例尺

setScaleBar({params})

params

show:

  • 类型:布尔
  • 描述:(可选项)是否显示比例尺
  • 默认值:false

position:

  • 类型:JSON 对象
  • 描述:(可选项)比例尺的位置,设定坐标以地图左上角为原点,在 Android 平台上为固定位置,本参数无效
  • 内部字段:

    1. {
    2. x: 0, //(可选项)数字类型;比例尺左上角的 x 坐标(相对于地图);默认:0
    3. y: 0 //(可选项)数字类型;比例尺左上角的 y 坐标(相对于地图);默认:0
    4. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setScaleBar({
  3. show: true,
  4. position: {
  5. x:100,
  6. y:100
  7. }
  8. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setCompass

设置高德地图指南针

setCompass({params})

params

show:

  • 类型:布尔
  • 描述:(可选项)是否显示指南针
  • 默认值:false

position:

  • 类型:JSON 对象
  • 描述:(可选项)指南针的位置,设定坐标以地图左上角为原点,在 Android 平台上为固定位置,本参数无效
  • 内部字段:

    1. {
    2. x: 0, //(可选项)数字类型;指南针左上角的 x 坐标(相对于地图);默认:0
    3. y: 0 //(可选项)数字类型;指南针左上角的 y 坐标(相对于地图);默认:0
    4. }

img:

  • 类型:布尔
  • 描述:(可选项)自定义指南针图标图片路径,要求本地路径(fs://、widget://),Android 平台上忽略本参数
  • 默认值:高德地图默认图标

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setCompass({
  3. show: true,
  4. img: 'widget://res/compass.png',
  5. position: {
  6. x:100,
  7. y:100
  8. }
  9. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setLogo

设置高德地图 logo 的位置

setLogo({params})

params

position:

  • 类型:字符串
  • 默认:right
  • 描述:(可选项)高德地图 logo 的位置,取值范围如下:
    • left:地图左下角
    • center:地图底部居中
    • right:地图右下角

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setLogo({
  3. position: 'right'
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

isPolygonContainsPoint

判断已知点是否在指定的多边形区域内

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

params

point:

  • 类型:JSON 对象
  • 描述:已知点的地理坐标
  • 内部字段:
  1. {
  2. lon: 116.297, //数字类型;经度
  3. lat: 40.109 //数字类型;纬度
  4. }

points:

  • 类型:数组
  • 描述:多边形的各个点组成的数组
  • 内部字段:
  1. [{
  2. lon: 116.297, //数字类型;经度
  3. lat: 40.109 //数字类型;纬度
  4. }]

params

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔类型;目标点是否在指定区域内,true || false
  3. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.isPolygonContainsPoint({
  3. point: {
  4. lon: 116.39432327,
  5. lat: 39.98963192
  6. },
  7. points: [{
  8. lon: 116.39432327,
  9. lat: 39.98963192
  10. }, {
  11. lon: 116.49432328,
  12. lat: 39.98963192
  13. }, {
  14. lon: 116.39432327,
  15. lat: 39.88933191
  16. }]
  17. }, function(ret) {
  18. alert(ret.status);
  19. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

isCircleContainsPoint

判断已知点是否在指定的圆形区域内

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

params

point:

  • 类型:JSON 对象
  • 描述:已知点的地理坐标
  • 内部字段:
  1. {
  2. lon: 116.297, //数字类型;经度
  3. lat: 40.109 //数字类型;纬度
  4. }

circle:

  • 类型:JSON
  • 描述:圆形信息
  • 内部字段:
  1. {
  2. center: { //JSON对象;圆心信息
  3. lon: 116.297, //数字类型;经度
  4. lat: 40.109 //数字类型;纬度
  5. },
  6. radius: 100 //(可选项)数字类型;半径,单位米(m);默认:100
  7. }

params

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔类型;目标点是否在指定区域内,true || false
  3. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.isCircleContainsPoint({
  3. point: {
  4. lon: 116.39432327,
  5. lat: 39.98963192
  6. },
  7. circle: {
  8. center: {
  9. lon: 116.297,
  10. lat: 40.109
  11. },
  12. radius: 100
  13. }
  14. }, function(ret) {
  15. alert(ret.status);
  16. });

可用性

iOS系统,Android系统

可提供的1.1.9及更高版本

interconvertCoords

经纬度坐标与地图容器像素坐标相互转换,经纬度和x,y值传一种即可。

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

params

lon:

  • 类型:数字
  • 描述:(可选项)原始地理坐标经度

lat:

  • 类型:数字
  • 描述:(可选项)原始地理坐标纬度

x:

  • 类型:数字
  • 描述:(可选项)地图容器的 x 坐标

y:

  • 类型:数字
  • 描述:(可选项)地图容器的 y 坐标

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. x: 334.00004622221184, //数字类型;传经纬度时,返回转换后的地图容器x坐标
  4. y: 207.00000925440887, //数字类型;传经纬度时,返回转换后的地图容器y坐标
  5. lon: 116.213, //数字类型;传x,y值时,返回转换后的地理坐标经度
  6. lat: 39.213 //数字类型;传x,y值时,返回转换后的地理坐标纬度
  7. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.interconvertCoords({
  3. lon: 116.351,
  4. lat: 39.283
  5. }, function(ret, err) {
  6. if (ret.status) {
  7. alert(JSON.stringify(ret));
  8. }
  9. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

takeSnapshotInRect

在指定区域内截图(默认会包含该区域内的标注)

takeSnapshotInRect({params}, callback(ret))

params

rect:

  • 类型:JSON 对象
  • 描述:(可选项)所截取区域的位置和大小(相对于地图区域)
  • 内部字段:
  1. {
  2. x: 0, //(可选项)数字类型;地图左上角的 x 坐标(相对于地图所在的区域);默认:0
  3. y: 0, //(可选项)数字类型;地图左上角的 y 坐标(相对于地图所在的区域);默认:0
  4. w: 320, //(可选项)数字类型;地图的宽度;默认:地图的宽
  5. h: 480 //(可选项)数字类型;地图的高度;默认:地图的高
  6. }

path:

  • 类型:字符串
  • 描述:截图保存路径,要求本地路径(fs://),如:fs://aMap/Snapshot.png

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔类型;是否截图成功
  3. realPath: '' //字符串类型;截图的绝对路径
  4. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.takeSnapshotInRect({
  3. rect: {
  4. x: 0,
  5. y: 0,
  6. w: 320,
  7. h: 300
  8. },
  9. path: 'fs://aMap/123.png'
  10. }, function(ret) {
  11. alert(JSON.stringify(ret));
  12. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

addEventListener

监听地图相关事件

addEventListener({params}, callback(ret))

params

name:

  • 类型:字符串
  • 描述:地图相关事件名称
  • 取值范围:
    • longPress(长按事件)
    • viewChange(视角改变事件)
    • click(单击事件)
    • trackingMode(userTrackingMode 改变事件,暂仅支持 iOS 平台)
    • zoom(放大缩小事件)

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. lon: 116.351, //数字类型;触发事件的地点的经度(longPress,click),地图中心的经度(viewChange,trackingMode,zoom)
  4. lat: 39.283, //数字类型;触发事件的地点的纬度(longPress,click),地图中心的纬度(viewChange,trackingMode,zoom)
  5. zoom: 11, //数字类型;地图缩放角度
  6. rotate: 30, //数字类型;地图旋转角度
  7. overlook: 30, //数字类型;视角倾斜度
  8. trackingMode:follow //字符串类型;当前位置标注图标显示的跟踪类型(trackingMode)
  9. - 取值范围:
  10. none(不追踪用户的 location 更新)
  11. follow(追踪用户的 location 更新)
  12. heading(追踪用户的 location heading 更新)
  13. zoomType: 'zoomIn' //字符串类型;zoomIn 放大,zoomOut缩小;name为zoom时有值,iOS平台无此参数
  14. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.addEventListener({
  3. name: 'longPress'
  4. }, function(ret) {
  5. if (ret.status) {
  6. alert(JSON.stringify(ret));
  7. }
  8. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

removeEventListener

停止监听地图相关事件

removeEventListener({params})

params

name:

  • 类型:字符串
  • 描述:地图相关事件名称
  • 取值范围:
    • longPress(长按事件)
    • viewChange(视角改变事件)
    • click(单击事件)
    • trackingMode(userTrackingMode 改变事件)
    • zoom(放大缩小事件)

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.removeEventListener({
  3. name: 'longPress'
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

isShowsIndoorMap

是否为显示室内地图状态

isShowsIndoorMap(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: false //布尔类型;是否为显示室内地图状态
  3. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.isShowsIndoorMap(function(ret){
  3. alert(JSON.stringify(ret));
  4. });

可用性

iOS系统,Android系统

可提供的1.1.3及更高版本

showsIndoorMap

设置是否显示室内地图

showsIndoorMap({params})

params

isShows:

  • 类型:布尔
  • 描述:(可选项)是否显示室内地图
  • 默认:false

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.showsIndoorMap({
  3. isShows: true
  4. });

可用性

iOS系统,Android系统

可提供的1.1.3及更高版本

isShowsIndoorMapControl

是否为显示室内地图默认控件

isShowsIndoorMapControl(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: false //布尔类型;是否为显示室内地图默认控件状态
  3. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.isShowsIndoorMapControl(function(ret){
  3. alert(JSON.stringify(ret));
  4. });

可用性

iOS系统

可提供的1.1.3及更高版本

showsIndoorMapControl

设置是否显示室内地图默认控件

showsIndoorMapControl({params})

params

isShows:

  • 类型:布尔
  • 描述:(可选项)是否显示室内地图默认控件
  • 默认:false

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.showsIndoorMapControl({
  3. isShows: true
  4. });

可用性

iOS系统

可提供的1.1.3及更高版本

indoorMapControlSize

获取默认室内地图控件的最大宽高

indoorMapControlSize(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. size:{ //JSON对象;默认室内地图控件的最大宽高
  3. width:, //数字类型;默认室内地图控件的最大宽
  4. height: //数字类型;默认室内地图控件的最大高
  5. }
  6. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.indoorMapControlSize(function(ret){
  3. alert(JSON.stringify(ret));
  4. });

可用性

iOS系统

可提供的1.1.3及更高版本

setIndoorMapControlOrigin

设置默认室内地图控件位置

setIndoorMapControlOrigin({params})

params

point:

  • 类型:JSON对象
  • 描述:(可选项)左上角点位置
  • 内部字段:
  1. {
  2. x:0, //数字类型;
  3. y:0 //数字类型;
  4. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setIndoorMapControlOrigin({
  3. point: {
  4. x:10,
  5. y:10
  6. }
  7. });

可用性

iOS系统

可提供的1.1.3及更高版本

setCurrentIndoorMapFloorIndex

设置当前室内地图楼层数

setCurrentIndoorMapFloorIndex({params})

params

floorIndex:

  • 类型:数字
  • 描述:(可选项)要设置的楼层数
  • 默认:0

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setCurrentIndoorMapFloorIndex({
  3. floorIndex: 2
  4. });

可用性

iOS系统

可提供的1.1.3及更高版本

clearIndoorMapCache

清空室内地图缓存

clearIndoorMapCache()

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.clearIndoorMapCache();

可用性

iOS系统

可提供的1.1.3及更高版本

addAnnotations

在地图上添加标注信息,标注大小默认为 icons 内第一张图片大小的二分之一。图标中轴线的下边缘点为坐标基准点

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

params

annotations:

  • 类型:数组
  • 描述:图标标注信息组成的数组
  • 内部字段:
  1. [{
  2. id: 1, //数字类型;图标标注的唯一标识
  3. lon: 116.233, //数字类型;图标标注所在位置的经度
  4. lat: 39.134, //数字类型;图标标注所在位置的纬度
  5. icons: 'widget://', //(可选项)数组类型;指定的标注图标路径组成的数组,若包含多张图片,则此标注显示为多图联动的 gif 动画效果,要求本地路径(fs://、widget://),若不传则显示公用的 icons 图标
  6. selectedIcons: // (可选项) 数组类型;点击标注后的图标路径,若包含多张图片,则此标注显示为多图联动的 gif 动画效果,要求本地路径(fs://、widget://),若不传则显示公用的selectedIcons,如果公用的selectedIcons也不传,则点击时不切换图标
  7. draggable: true //(可选项)布尔类型;所添加的标注是否可被拖动,若不传则以公用的 draggable 为准
  8. w: 30, //数字类型;图标标注宽度;默认值:icons或selectedIcons内第一张图片宽度的二分之一 (android不根据图片大小,传多少是多少)
  9. h: 30, //数字类型;图标标注高度;默认值:icons或selectedIcons内第一张图片高度的二分之一 (android不根据图片大小,传多少是多少)
  10. locked: false, //(可选项)布尔类型;是否固定在屏幕一点, 注意,拖动或者手动改变经纬度,都会导致设置失效。如果为true,设置lon和lat会失效,需要设置lockedX和lockedY;默认:false
  11. lockedX: 100, //数字类型;固定屏幕点的X坐标,locked为true时设置;默认值:地图视图中间
  12. lockedY: 100, //数字类型;固定屏幕点的Y坐标,locked为true时设置;默认值:地图视图中间
  13. }]

icons:

  • 类型:数组
  • 描述:(可选项)指定的标注图标路径组成的数组,若包含多张图片,则此标注显示为多图联动的 gif ,要求本地路径(fs://、widget://)
  • 默认值:红色大头针
  • 注:android上如果填写此选项,并有多张图片时,请尽量保证图片的大小是一致的;

selectedIcons:

  • 类型:数组
  • 描述:(可选项) 指定的标注图标路径组成的数组,若包含多张图片,则此标注显示为多图联动的 gif ,要求本地路径(fs://、widget://),

draggable:

  • 类型:布尔
  • 描述:(可选项)所添加的标注是否可被拖动
  • 默认值:false

timeInterval:

  • 类型:数字
  • 描述:(可选项)若添加的标注为动态图,则本参数表示动态图循环播放一次的时间,单位为秒(s),否则本参数无效
  • 默认值:3.0

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. id: 10 //数字类型;相应事件的标注的
  3. eventType: 'click', //字符串类型;交互事件类型
  4. //取值范围:
  5. //click(用户点击标注事件)
  6. //drag(用户拖动标注事件)
  7. dragState: 'starting' //字符串类型;标注被拖动的状态,当 eventType 为 drag 时本字段有值,
  8. //取值范围:
  9. //starting(开始拖动)
  10. //dragging (拖动中)
  11. //ending (拖动结束)
  12. //none (静止状态),Android平台不支持
  13. //canceling (取消拖动),Android平台不支持
  14. longitude:, //小数类型;经度 dragState 为ending时返回
  15. latitude:, //小数类型;纬度 dragState 为ending时返回
  16. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.addAnnotations({
  3. annotations: [{
  4. id: 1,
  5. lon: 116.297,
  6. lat: 40.109
  7. }, {
  8. id: 2,
  9. lon: 116.29,
  10. lat: 40.109
  11. }, {
  12. id: 3,
  13. lon: 116.298,
  14. lat: 40.11
  15. }],
  16. icons: ['widget://'],
  17. draggable: true,
  18. timeInterval: 2.0
  19. }, function(ret) {
  20. if (ret.eventType == 'click') {
  21. alert(ret.id);
  22. }
  23. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

cancelAnnotationSelected

取消标注选中状态

cancelAnnotationSelected({params})

params

id:

  • 类型:数字
  • 描述:指定的标注 id(仅iOS支持,android仅一个为选中状态 调用此接口取消当前选中标注选中状态)

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.cancelAnnotationSelected({
  3. id: 1
  4. });

可用性

iOS系统,Android系统

可提供的1.2.7及更高版本

getAnnotationCoords

获取指定标注的经纬度

getAnnotationCoords({params}, callback(ret))

params

id:

  • 类型:数字
  • 描述:指定的标注 id

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. lon: 116.213, //数字类型;标注的经度
  3. lat: 39.213 //数字类型;标注的纬度
  4. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getAnnotationCoords({
  3. id: 2
  4. }, function(ret) {
  5. if (ret) {
  6. api.alert({ msg: JSON.stringify(ret) });
  7. }
  8. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setAnnotationCoords

设置某个已添加标注的经纬度

setAnnotationCoords(callback(ret, err))

params

id:

  • 类型:数字
  • 描述:指定的标注 id

lon:

  • 类型:数字
  • 描述:设置的经度

lat:

  • 类型:数字
  • 描述:设置的纬度

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setAnnotationCoords({
  3. id: 2,
  4. lon: 116.39,
  5. lat: 40.209
  6. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

annotationExist

判断标注是否存在

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

params

id:

  • 类型:数字
  • 描述:指定的标注 id

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔类型;标注是否存在,true || false
  3. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.annotationExist({
  3. id: 2
  4. }, function(ret) {
  5. if (ret.status) {
  6. api.alert({ msg: '存在' });
  7. }
  8. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setBubble

设置点击标注时弹出的气泡信息

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

params

id:

  • 类型:数字
  • 描述:要设置气泡的标注 id

bgImg:

  • 类型:字符串
  • 描述:(可选项)弹出气泡的背景图片,要求本地路径(fs://、widget://),中轴线下边缘点为气泡弹出点
  • 默认值:默认气泡背景图片

content:

  • 类型:JSON 对象
  • 描述:弹出气泡的内容
  • 内部字段:
  1. {
  2. title: '', //字符串类型;弹出气泡的标题
  3. subTitle: '', //(可选项)字符串类型;弹出气泡的概述内容,若不传则 title 在上下位置居中显示
  4. illus: '' //(可选项)字符串类型;弹出气泡的配图(30*40规格),支持http://、https://、widget://、fs://等协议,若不传则不显示插图,标题和子标题忽略插图显示
  5. }

styles:

  • 类型:JSON 对象
  • 描述:弹出气泡的样式
  • 内部字段:
  1. {
  2. titleColor: '#000', //(可选项)字符串类型;气泡标题的文字颜色,支持 rgb、rgba、#;默认:'#000'
  3. titleSize: 16, //(可选项)数字类型;气泡标题的文字大小;默认:16
  4. subTitleColor: '#000', //(可选项)字符串类型;气泡概述内容的文字颜色,支持 rgb、rgba、#;默认:'#000'
  5. subTitleSize: 14, //(可选项)数字类型;气泡概述内容的文字大小;默认:14
  6. illusAlign: 'left' //(可选项)字符串类型;气泡配图的显示位置;默认:'left'
  7. //取值范围:
  8. //left(图片居左)
  9. //right(图片居右)
  10. w: 160, //(可选项)数字类型;气泡的宽;默认:bgImg有值时,为160;bgImg为默认值时,为title的长度,并且不会超过地图视图的宽度-64,不会小于160
  11. h: 90, //(可选项)数字类型;气泡的高;默认:90
  12. }

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. id: 10, //数字类型;用户点击气泡返回的id
  3. eventType: 'clickContent', //字符串类型;交互事件类型
  4. //取值范围:
  5. //clickContent(点击气泡文本内容)
  6. //clickIllus(点击配图)
  7. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setBubble({
  3. id: 2,
  4. bgImg: 'widget://res/bubble_bg.png',
  5. content: {
  6. title: '大标题',
  7. subTitle: '概述内容',
  8. illus: 'http://ico.ooopic.com/ajax/iconpng/?id=145044.png'
  9. },
  10. styles: {
  11. titleColor: '#000',
  12. titleSize: 16,
  13. subTitleColor: '#999',
  14. subTitleSize: 12,
  15. illusAlign: 'left'
  16. }
  17. }, function(ret) {
  18. if (ret) {
  19. alert(JSON.stringify(ret));
  20. }
  21. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setWebBubble

设置点击标注时弹出的气泡信息

setWebBubble({params})

params

id:

  • 类型:数字
  • 描述:要设置气泡的标注 id

url:

  • 类型:字符串
  • 描述:(可选项)弹出气泡的网页地址,用户点击标注时,模块在标注上弹出窗口(类似open一个frame,模块会用webview去加载此url的网页显示出来),当data参数不为空时,url将做为baseUrl,data中的html引用的资源文件根路径以该url为基础。

data:

  • 类型:字符串
  • 描述:(可选项)页面加载的数据内容,可以为html片段或者整张html文件的数据,当data为空或者不传的时候, 会将url地址作为整个加载进去

size:

  • 类型:JSON对象
  • 描述:(可选项)气泡的大小配置
  • 内部字段
  1. {
  2. width: 50, //(可选项)数字类型;气泡的宽;默认:50
  3. height: 50 //(可选项)数字类型;气泡的高;默认:50
  4. }

bg:

  • 类型:字符串
  • 描述:(可选项)弹出气泡的背景设置,支持rgb、rgba、#、img(要求本地路径,如:widget://、fs://)
  • 默认:rgba(0,0,0,0)

示例代码

  1. var map = api.require('aMap');
  2. map.setWebBubble({
  3. id:1,
  4. size : {
  5. width:100,
  6. height:100
  7. },
  8. bg:'rgba(0,0,0,0.6)',
  9. url:'http://img6.ph.126.net',
  10. data:'漂亮MM <img src="hBiG96B8egigBULxUWcOpA==/109212290980771276.jpg">'
  11. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

addWebBubbleListener

添加网页气泡点击监听

addWebBubbleListener(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. id: 1 //数字类型;用户点击气泡返回的id
  3. }

示例代码

  1. var map = api.require('aMap');
  2. map.addWebBubbleListener(function(ret){
  3. api.alert({msg:JSON.stringify(ret)});
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

removeWebBubbleListener

移除网页气泡点击监听

removeWebBubbleListener(callback(ret))

示例代码

  1. var map = api.require('aMap');
  2. map.removeWebBubbleListener();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

popupBubble

弹出指定标注的气泡

popupBubble({params})

params

id:

  • 类型:数字
  • 描述:气泡的 id

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.popupBubble({
  3. id: 2
  4. }, function(ret){
  5. alert(JSON.stringify(ret));
  6. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

closeBubble

关闭已弹出的气泡

closeBubble({params})

params

id:

  • 类型:数字
  • 描述:气泡的 id

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.closeBubble({
  3. id: 2
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

addBillboard

在地图上添加布告牌,布告牌图标中轴线的下边缘点为坐标基准点

addBillboard({params})

params

id:

  • 类型:数字
  • 描述:布告牌的 id,注意:本 id 不可与 addAnnotations 接口内的 id 相同

coords:

  • 类型:JSON 对象
  • 描述:布告牌所在位置的坐标
  • 内部字段:
  1. {
  2. lon: 116.233, //数字类型;布告牌所在位置的经度
  3. lat: 39.134 //数字类型;布告牌所在位置的纬度
  4. }

bgImg:

  • 类型:字符串
  • 描述:布告牌的背景图片,要求本地路径(fs://、widget://)

content:

  • 类型:JSON 对象
  • 描述:布告牌的内容
  • 内部字段:
  1. {
  2. title: '', //(可选项)字符串类型;布告牌的标题
  3. subTitle: '', //(可选项)字符串类型;布告牌的概述内容
  4. illus: '' //(可选项)字符串类型;布告牌的配图,支持http://、https://、widget://、fs://等协议
  5. }

draggable:

  • 类型:布尔
  • 描述:(可选项)所添加的布告牌是否可被拖动
  • 默认值:false

styles:

  • 类型:JSON 对象
  • 描述:布告牌的样式
  • 内部字段:
  1. {
  2. size: { //(可选项)JSON对象;布告牌大小配置,若不传则取默认值
  3. width: 160, //(可选项)数组类型;布告牌的宽;默认:160
  4. height: 75 //(可选项)数组类型;布告牌的高;默认:75
  5. },
  6. illusRect: { //(可选项)JSON对象;插图大小配置,与 illusAlign 同时存在时以本参数为准
  7. x: , //(可选项)数字类型;插图左上角x坐标,相对布告牌坐标系;默认:10
  8. y: , //(可选项)数字类型;插图左上角y坐标,相对布告牌坐标系;默认:5
  9. w: , //(可选项)数字类型;插图的宽;默认:35
  10. h: //(可选项)数字类型;插图的高;默认:50
  11. },
  12. marginT: 10, //(可选项)数字类型;标题距布告牌顶端的距离,默认:10
  13. titleMarginLeft:10, //(可选项) 数字类型;标题的左边距;默认:10
  14. titleMarginRight:10, //(可选项) 数字类型;标题的右边距;默认:10
  15. marginB: 15, //(可选项)数字类型;子标题距布告牌低端的距离,默认:15
  16. subTitleMarginLeft:10, //(可选项) 数字类型;子标题的左边距;默认:10
  17. subTitleMarginRight:10, //(可选项) 数字类型;子标题的右边距;默认:10
  18. alignment: 'left', //(可选项)字符串类型;标题和子标题的对齐方式:left(水平居左)、center(水平居中)、right(水平居右);默认:left
  19. titleColor: '#000', //(可选项)字符串类型;布告牌标题的文字颜色,支持 rgb、rgba、#;默认:'#000'
  20. titleSize: 14, //(可选项)数字类型;布告牌标题的文字大小;默认:16
  21. subTitleColor: '#000', //(可选项)字符串类型;布告牌概述内容的文字颜色,支持 rgb、rgba、#;默认:'#000'
  22. subTitleSize: 12, //(可选项)数字类型;布告牌概述内容的文字大小;默认:16
  23. titleMaxLines:1, // (可选项) 数字类型;标题最大行数,超过一行自动换行,换行规则与原生一致;默认:1
  24. subTitleMaxLines:1, // (可选项)数字类型 ;子标题最大行数,超过一行自动换行,换行规则与原生一致;默认:1
  25. illusAlign: 'left', //(可选项)字符串类型;布告牌配图的显示位置,与 illusRect 同时存在时忽略本参数;默认:'left'
  26. //取值范围:
  27. //left(图片居左)
  28. //right(图片居右)
  29. }

selectedStyles:

  • 类型:JSON 对象
  • 描述:布告牌选中后的样式
  • 内部字段:
  1. {
  2. bgImg:'', //(可选项)字符串类型;选中后的布告牌背景图片,要求本地路径(fs://、widget://);默认:同未选中时值相同
  3. titleColor: '#000', //(可选项)字符串类型;选中后的布告牌标题的文字颜色,支持 rgb、rgba、#;默认:同未选中时值相同
  4. subTitleColor: '#000', //(可选项)字符串类型;选中后的布告牌概述内容的文字颜色,支持 rgb、rgba、#;默认:同未选中时值相同
  5. illus: '' //(可选项)字符串类型;选中后的布告牌的配图;默认:同未选中时值相同
  6. }

useIllusPoint:

  • 类型:布尔类型
  • 描述:(可选项)是否以插图中轴线底部为基准点,此参数设置为true背景设置无效。此参数为true需要styles.size.height 等于styles.illusRect.h + styles.illusRect.y
  • 默认值:false

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. id: 4, //数字类型;用户点击布告牌返回的id
  3. eventType: 'click', //字符串类型;交互事件类型
  4. //取值范围:
  5. //click(用户点击布告牌事件)
  6. //drag(用户拖动布告牌事件)
  7. dragState: 'starting' //字符串类型;布告牌被拖动的状态,当 eventType 为 drag 时本字段有值,
  8. //取值范围:
  9. //starting(开始拖动)
  10. //dragging (拖动中)
  11. //ending (拖动结束)
  12. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.addBillboard({
  3. id: 4,
  4. draggable: true,
  5. coords: {
  6. lon: 116.233,
  7. lat: 39.134
  8. },
  9. bgImg: 'widget://image/aMapTest.png',
  10. content: {
  11. title: '大标题大标题大标题大标题',
  12. subTitle: '概述内容概述内容概述内容',
  13. illus: 'http://ico.ooopic.com/ajax/iconpng/?id=145044.png'
  14. },
  15. styles: {
  16. titleColor: '#000',
  17. titleSize: 16,
  18. subTitleColor: '#999',
  19. subTitleSize: 12,
  20. illusAlign: 'left'
  21. }
  22. }, function(ret) {
  23. if (ret) {
  24. alert(JSON.stringify(ret));
  25. }
  26. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

addWebBoard

在地图上添加网页布告牌,布告牌图标中轴线的下边缘点为坐标基准点

addWebBoard({params})

params

id:

  • 类型:数字
  • 描述:布告牌的 id,注意:本 id 不可与 addAnnotations 接口内的 id 相同

coords:

  • 类型:JSON 对象
  • 描述:布告牌所在位置的坐标
  • 内部字段:
  1. {
  2. lon: 116.233, //数字类型;布告牌所在位置的经度
  3. lat: 39.134 //数字类型;布告牌所在位置的纬度
  4. }

bg:

  • 类型:字符串
  • 描述:布告牌的背景图片,要求本地路径(fs://、widget://)(仅ios支持)

url:

  • 类型:字符串
  • 描述:(可选项)网页布告牌的网页地址,当data参数不为空时,url将做为baseUrl,data中的html引用的资源文件根路径以该url为基础。

data:

  • 类型:字符串
  • 描述:(可选项)页面加载的数据内容,可以为html片段或者整张html文件的数据,当data为空或者不传的时候, 会将url地址作为整个加载进去

size:

  • 类型:JSON对象
  • 描述:(可选项)气泡的大小配置
  • 内部字段
  1. {
  2. w: 50, //(可选项)数字类型;气泡的宽;默认:50
  3. h: 50 //(可选项)数字类型;气泡的高;默认:50
  4. }

示例代码

  1. var map = api.require('aMap');
  2. map.addWebBoard({
  3. id: 4,
  4. draggable: true,
  5. coords: {
  6. lon:116.29432327,
  7. lat:39.98963192
  8. },
  9. bg: 'widget://res/billboard.png',
  10. url:'./aMap-con.html',
  11. data:'',
  12. size:{
  13. w:100,
  14. h:100
  15. }
  16. });

可用性

iOS系统

可提供的1.3.1及更高版本

addWebBoardListener

添加网页布告牌点击监听

addWebBoardListener(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. id: 1 //数字类型;用户点击布告牌返回的id
  3. }

示例代码

  1. var map = api.require('aMap');
  2. map.addWebBoardListener(function(ret){
  3. api.alert({msg:'网页布告牌'+JSON.stringify(ret)});
  4. });

可用性

iOS系统

可提供的1.3.1及更高版本

removeWebBoardListener

移除网页布告牌点击监听

removeWebBoardListener(callback(ret))

示例代码

  1. var map = api.require('aMap');
  2. map.removeWebBoardListener();

可用性

iOS系统

可提供的1.3.1及更高版本

addMobileAnnotations

在地图上添加可移动、旋转的标注图标,图标的中心点为坐标基准点

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

params

annotations:

  • 类型:数组
  • 描述:图标标注信息组成的数组
  • 内部字段:
  1. [{
  2. id: 10, //数字类型;图标标注的唯一标识,注意:本 id 不可与 addAnnotations、addBillboard 接口内的 id 相同
  3. lon: 116.233, //数字类型;图标标注所在位置的经度
  4. lat: 39.134, //数字类型;图标标注所在位置的纬度
  5. icon: 'widget://', //字符串类型;指定的标注图标,要求本地路径(fs://、widget://),图标的锚点即是坐标点。
  6. draggable: true //布尔类型;所添加的可移动的标注是否可被拖动;默认:false
  7. }]

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. id: 4, //数字类型;交互标注对象的 id
  3. dragState: 'starting' //字符串类型;标注被拖动的状态
  4. //取值范围:
  5. //starting(开始拖动)
  6. //dragging (拖动中)
  7. //ending (拖动结束)
  8. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.addMobileAnnotations({
  3. annotations: [{
  4. id: 10,
  5. lon: 116.297,
  6. lat: 40.109,
  7. icon: 'widget://image/aMap_car1.png',
  8. draggable: true
  9. }, {
  10. id: 11,
  11. lon: 116.98,
  12. lat: 40.109,
  13. icon: 'widget://image/aMap_car2.png',
  14. draggable: true
  15. }, {
  16. id: 12,
  17. lon: 115.30,
  18. lat: 40.109,
  19. icon: 'widget://image/aMap_car3.png',
  20. draggable: true
  21. }, {
  22. id: 13,
  23. lon: 116.297,
  24. lat: 39.109,
  25. icon: 'widget://image/aMap_car1.png',
  26. draggable: true
  27. }, {
  28. id: 14,
  29. lon: 116.98,
  30. lat: 39.109,
  31. icon: 'widget://image/aMap_car2.png',
  32. draggable: true
  33. }, {
  34. id: 15,
  35. lon: 115.30,
  36. lat: 39.109,
  37. icon: 'widget://image/aMap_car3.png',
  38. draggable: true
  39. }]
  40. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

moveAnnotation

移动地图上已添加的可移动、旋转的标注图标,在移动动画开始前,会先做 0.3 秒的旋转动画,使所移动的图标中间轴线顶端对准终点坐标点。在 Android 平台上,如果标注添加到地图当前可视区域以外的区域,则不可以移动该标注

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

params

id:

  • 类型:数字
  • 描述:要移动的标注的 id

duration:

  • 类型:数字
  • 描述:(可选项)标注图标移动动画的时间,单位为秒(s),不包括旋转动画时间
  • 默认值:1.0(s)

end:

  • 类型:JSON 对象
  • 描述:终点经纬度
  • 内部字段:
  1. {
  2. lon: 116.581515, //数字类型;终点的经度
  3. lat: 29.615467 //数字类型;终点的纬度
  4. }

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. id: //数字类型;移动动画结束的标注的 id
  3. }

示例代码

  1. var aMap = api.require('aMap');
  2. for (var i = 0; i < 6; i++) {
  3. aMap.moveAnnotation({
  4. id: 10 + i,
  5. duration: 6,
  6. end: {
  7. lon: 116.3843839609304,
  8. lat: 39.98964439091298
  9. }
  10. }, function(ret, err) {
  11. alert(ret.id + '移动结束')
  12. });
  13. }

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

removeAnnotations

移除指定 id 的标注(可移动、不可移动)或布告牌

removeAnnotations({params})

params

ids:

  • 类型:数组
  • 描述:(可选项)要移除的标注或布告牌id(数字),若为空或不传,则移除所有标注

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.removeAnnotations({
  3. ids: [1,3,5,7]
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

addMoveAnimation

给地图上的标注添加移动动画

注意:

第一个添加的动画以当前位置为起始点,沿传入的coordinates点移动,否则以上一个动画终点为起始点

params

id:

  • 类型:数字
  • 描述:要移动的标注的 id

duration:

  • 类型:数字
  • 描述:(可选项)移动动画的时间,单位为秒(s)
  • 默认值:3.0(s)

coordinates:

  • 类型:数组
  • 描述:动画移动经过点坐标集合
  • 内部字段:
  1. {
  2. lon: 116.581515, //数字类型;经度
  3. lat: 29.615467 //数字类型;纬度
  4. }

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. isFinished: true //布尔类型;是否结束
  3. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.addMoveAnimation({
  3. id: 10,
  4. duration: 6,
  5. coordinates: [{
  6. lon: 116.3843839609304,
  7. lat: 39.98964439091298
  8. }]
  9. }, function(ret) {
  10. alert(ret.id + '移动结束')
  11. });

可用性

iOS系统,Android系统

可提供的1.1.8及更高版本

cancelMoveAnimation

取消地图上的标注移动动画

cancelMoveAnimation({params})

params

id:

  • 类型:字符串
  • 描述:要移除的标注或布告牌id(数字)

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.cancelMoveAnimation({
  3. id: 1
  4. });

可用性

iOS系统,Android系统

可提供的1.1.8及更高版本

showAnnotations

显示指定 id 的标注(可移动、不可移动)或布告牌

showAnnotations({params})

params

animation:

  • 类型:布尔
  • 描述:(可选项)移动地图以显示标注时是否带动画效果
  • 默认:true

ids:

  • 类型:数组
  • 描述:(可选项)要显示的标注或布告牌id(数字),若为空或不传,则显示所有标注

insets:

  • 类型:JSON对象
  • 描述:(可选项)标注显示的区域上下左右边距
  • 内部字段:
  1. {
  2. top:, //数字类型;上边距;默认:50
  3. left:, //数字类型;左边距;默认:20
  4. bottom:, //数字类型;下边距;默认:50
  5. right: //数字类型;右边距;默认:20
  6. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.showAnnotations({
  3. ids: [1,3,5,7]
  4. });

可用性

iOS系统,Android系统

可提供的1.2.9及更高版本

addHeatMap

在地图上添加热力点图层

addHeatMap({params})

params

id:

  • 类型:数字
  • 描述:热力点图层的id,不可与覆盖物类其它接口添加得图层 id 一样

data:

  • 类型:字符串/数组类型
  • 描述:为字符串类型时表示热力点信息文件路径,要求本地路径(widget://、fs://);若传数组类型则表示直接将热力点数据传给模块
  • 内部字段:
  1. [{
  2. longitude:, //数字类型;经度
  3. latitude:, //数字类型;纬度
  4. intensity:'' //数字类型;强度
  5. }]

styles:

  • 类型:JSON 对象
  • 描述:(可选项)直线的样式
  • 内部字段:
  1. {
  2. radius: , //(可选项)数字类型;热力图半径,范围:0-100 screen point;默认:12
  3. opacity: , //(可选项)数字类型;透明度,范围:0-1;默认:0.6
  4. allowRetinaAdapting: ,//(可选项)布尔类型;是否开启高清热力图,默认:false;(android不支持)
  5. gradient: { //(可选项)JSON对象;渐变色彩及其点配置,colors和points 一一对应
  6. colors: [], //(可选项)数组类型;渐变色组;默认:['#ff0000','#0000FF','#008000']
  7. points: [] //(可选项)数组类型;渐变点:默认:[0.3,0.6,0.9]
  8. }
  9. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.addHeatMap({
  3. id: 1,
  4. styles: {
  5. radius: ,
  6. opacity:,
  7. allowRetinaAdapting:,
  8. gradient: {
  9. colors:[“#ff0000”,””,“”],
  10. points:[0.30.60.9]
  11. }
  12. },
  13. data:‘widget://res/points.txt’
  14. });

可用性

iOS系统,Android系统

可提供的1.1.8及更高版本

refreshHeatMap

刷新在地图上添加热力点图层

refreshHeatMap({params})

params

id:

  • 类型:数字
  • 描述:热力点图层的id

styles:

  • 类型:JSON 对象
  • 描述:(可选项)直线的样式
  • 内部字段:
  1. {
  2. radius: , //(可选项)数字类型;热力图半径,范围:0-100 screen point;默认:12
  3. opacity: , //(可选项)数字类型;透明度,范围:0-1;默认:0.6
  4. allowRetinaAdapting: ,//(可选项)布尔类型;是否开启高清热力图,默认:No;(android不支持)
  5. gradient: { //(可选项)JSON对象;渐变色彩及其点配置,colors和points 一一对应
  6. colors: [], //(可选项)数组类型;渐变色组;默认:['#ff0000','#0000FF','#008000']
  7. points: [] //(可选项)数组类型;渐变点:默认:[0.3,0.6,0.9]
  8. }
  9. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.refreshHeatMap({
  3. id: 1,
  4. styles: {
  5. radius: ,
  6. opacity:,
  7. allowRetinaAdapting:,
  8. gradient: {
  9. colors:[],
  10. points:[]
  11. }
  12. }
  13. });

可用性

iOS系统,Android系统

可提供的1.1.8及更高版本

addMultiPoint

在地图上添加点聚合图层

addMultiPoint({params},callback(ret))

params

id:

  • 类型:数字
  • 描述:点聚合图层的id,不可与覆盖物类其它接口添加得图层 id 一样

path:

  • 类型:字符串
  • 描述:聚合点信息文件路径,要求本地路径(widget://、fs://)
  • 内部字段:iOS上需要按照标准的json格式,否则解析不了
  1. [{
  2. "longitude":, //数字类型;经度
  3. "latitude":, //数字类型;纬度
  4. "title":"apicloud", //字符串类型;标题
  5. "subtitle":"apicloud", //字符串类型;子标题
  6. "customID":"1" //字符串类型;自定义id
  7. }]

styles:

  • 类型:JSON 对象
  • 描述:(可选项)直线的样式
  • 内部字段:
  1. {
  2. icon: '', //(可选项)字符串类型;聚点图标路径,要求本地路径(fs://、widget://)
  3. pointSize: { //(可选项)JSON对象;聚点图标的大小,不传则默认图片大小(android不支持)
  4. w: , //(可选项)数字类型;宽度;默认:10
  5. h: //(可选项)数字类型;高度:默认:10
  6. },
  7. anchor: { //(可选项)JSON对象;聚点图标的锚点位置,左上角为 (0,0) 右下角为 (1,1)
  8. x: , //(可选项)数字类型;x坐标,范围[0-1];默认:0.5
  9. y: //(可选项)数字类型;y坐标,范围[0-1];默认:0.5
  10. }
  11. }

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. eventType: 'click' ,//字符串类型;交互事件类型
  3. point: {
  4. longitude:, //数字类型;经度
  5. latitude:, //数字类型;纬度
  6. title:'', //字符串类型;标题
  7. subtitle:'', //字符串类型;子标题
  8. customID:'' //字符串类型;自定义id
  9. }
  10. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.addMultiPoint({
  3. id: 1,
  4. styles: {
  5. icon: 'arrow',
  6. pointSize: {
  7. w:,
  8. h:
  9. },
  10. anchor: {
  11. x:,
  12. y:
  13. },
  14. },
  15. path:‘widget://res/points.txt’
  16. },function(ret){
  17. api.alert({msg:JSON.stringify(ret)});
  18. });

可用性

iOS系统,Android系统

可提供的1.1.8及更高版本

addLine

在地图上添加线

addLine({params})

params

id:

  • 类型:数字
  • 描述:线的 id,不可与覆盖物类其它接口添加得图层 id 一样

styles:

  • 类型:JSON 对象
  • 描述:(可选项)直线的样式
  • 内部字段:
  1. {
  2. type: 'arrow', //(可选项)字符串类型;线的末端类型;默认:round;取值范围如下:
  3. //round:圆头线,在Android 上无效,显示为普通方头线条
  4. //square:方头线
  5. //arrow:带箭头的线
  6. lineDash: false, //(可选项)布尔类型;是否绘制成虚线,当 type 为 arrow 时,本参数无效;默认:false
  7. borderColor: '#000', //(可选项)字符串类型;线的颜色,支持 rgb、rgba、#;默认值:'#000'
  8. borderWidth: 3, //(可选项)数字类型;线的宽度,默认:2
  9. strokeImg:'fs://arrow.png'//(可选项)字符串类型;组成纹理画线的图片路径,要求本地路径(fs://、widget://),图片需满足: 长宽相等,且宽度值为2的整数次幂,若本参数不为空,则本接口忽略 type、lineDash、borderColor 参数
  10. }

points:

  • 类型:数组
  • 描述:线的两个点组成的数组
  • 内部字段:
  1. [{
  2. lon: 116.297, //数字类型;经度
  3. lat: 40.109 //数字类型;纬度
  4. }]

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.addLine({
  3. id: 1,
  4. styles: {
  5. type: 'arrow',
  6. borderColor: '#FF0000',
  7. borderWidth: 3,
  8. lineDash: true,
  9. strokeImg: ''
  10. },
  11. points: [{
  12. lon: 116.297, lat: 40.109
  13. },
  14. {
  15. lon: 116.298, lat: 40.109
  16. }]
  17. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

addCircle

在地图上添加圆形

addCircle({params})

params

id:

  • 类型:数字
  • 描述:圆形的 id,不可与覆盖物类其它接口添加得图层 id 一样

center:

  • 类型:JSON 对象
  • 描述:圆形中心点的经纬度
  • 内部字段:
  1. {
  2. lon: 116.297, //数字类型;圆形中心点的经度
  3. lat: 40.109 //数字类型;圆形中心点的纬度
  4. }

radius:

  • 类型:数字
  • 描述:圆形的半径

styles:

  • 类型:JSON 对象
  • 描述:(可选项)圆形的样式
  • 内部字段:
  1. {
  2. borderColor: '#000', //(可选项)字符串类型;圆形的边框颜色,支持 rgb、rgba、#;默认:'#000'
  3. borderWidth: 3 , //(可选项)数字类型;圆形的边框宽度,默认:2
  4. lineDash: false, //(可选项)布尔类型;是否绘制成虚线,Android 平台不支持;默认:false
  5. fillColor: '#ff0' //(可选项)字符串类型;圆形填充颜色,支持 rgb、rgba、#;默认:'rgba(1,0.8,0,0.8)'
  6. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.addCircle({
  3. id: 2,
  4. center: {
  5. lon: 116.298,
  6. lat: 40.11,
  7. },
  8. radius: 500,
  9. styles: {
  10. borderColor: '#FF0000',
  11. borderWidth: 3,
  12. lineDash: true,
  13. fillColor: 'rgba(1,0.8,0,0.8)'
  14. }
  15. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

addPolygon

在地图上添加多边形

addPolygon({params})

params

id:

  • 类型:数字
  • 描述:多边形的 id,不可与覆盖物类其它接口添加得图层 id 一样

styles:

  • 类型:JSON 对象
  • 描述:(可选项)多边形的样式
  • 内部字段:
  1. {
  2. borderColor: '#000', //(可选项)字符串类型;多边形的边框颜色,支持 rgb、rgba、#;默认:'#000'
  3. borderWidth: 3, //(可选项)数字类型;多边形的边框宽度,默认:2
  4. lineDash: false, //(可选项)布尔类型;是否绘制成虚线,Android 平台不支持本参数;默认:false
  5. fillColor: '#ff0' //(可选项)字符串类型;圆形填充颜色,支持 rgb、rgba、#;默认:'rgba(1,0.8,0,0.8)'
  6. }

points:

  • 类型:数组
  • 描述:多边形的各个点组成的数组
  • 内部字段:
  1. [{
  2. lon: 116.297, //数字类型;经度
  3. lat: 40.109 //数字类型;纬度
  4. }]

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.addPolygon({
  3. id: 4,
  4. styles: {
  5. borderColor: '#FF0000',
  6. borderWidth: 3,
  7. lineDash:false,
  8. fillColor:'#ff0'
  9. },
  10. points: [{
  11. lon: 116.297, lat: 40.109
  12. },
  13. {
  14. lon: 116.298, lat: 40.109
  15. },
  16. {
  17. lon: 116.298, lat: 40.11
  18. }]
  19. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

addImg

在地图上添加图片

addImg({params})

params

id:

  • 类型:数字
  • 描述:图片 id,不可与覆盖物类其它接口添加得图层 id 一样

imgPath:

  • 类型:字符串
  • 描述:图片的路径,要求本地路径(fs://、widget://)

lbLon:

  • 类型:数字
  • 描述:左下角点的经度

lbLat:

  • 类型:数字
  • 描述:左下角点的纬度

rtLon:

  • 类型:数字
  • 描述:右上角点的经度

rtLat:

  • 类型:数字
  • 描述:右上角点的纬度

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.addImg({
  3. id: 5,
  4. imgPath: 'widget://res/over_img.png',
  5. lbLon: 116.297,
  6. lbLat: 40.109,
  7. rtLon: 116.298,
  8. rtLat: 40.11
  9. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

addLocus

在地图上添加轨迹线

addLocus({params})

params

id:

  • 类型:数字
  • 描述:线的 id,不可与覆盖物类其它接口添加得图层 id 一样

borderWidth:

  • 类型:数字
  • 描述:(可选项)轨迹线的粗细
  • 默认:5

autoresizing:

  • 类型:布尔
  • 描述:路线渲染结束是否自动调整地图可视区域,为 true 时自带 0.3 秒地图移动动画效果
  • 默认值:true

locusData:

  • 类型:字符串
  • 描述:组成轨迹线的点信息组文件路径(本地路径),该文件为 .json 文件
  • .json文件内部字段:
  1. [{
  2. longitude: "116.297", //字符串类型;经度
  3. latitude: "40.109" //字符串类型;纬度
  4. rgba: 'rgba(123,234,12,1)' //字符串类型;颜色值
  5. }]

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.addLocus({
  3. id: 1,
  4. borderWidth: 5,
  5. autoresizing: true,
  6. locusData:'widget://res/runningRecord.json'
  7. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

removeOverlay

移除指定 id 的覆盖物

removeOverlay({params})

params

ids:

  • 类型:数组
  • 描述:要移除的 id(数字)组成的数组

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.removeOverlay({
  3. ids: [1, 2, 3, 4, 5]
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

searchRoute

搜索路线方案,无需调用 open 接口即可使用

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

params

type:

  • 类型:字符串
  • 描述:(可选项)路线类型
  • 默认值:transit
  • 取值范围:
    • drive(开车)
    • transit(公交)
    • walk(步行)
    • ride(骑行)

strategy:

  • 类型:字符串
  • 描述:(可选项)路线策略,type 为 walk(步行)或ride(骑行)时,此参数可不传
  • 默认值:’drive_time_first/transit_time_first’
  • 取值范围:
    • drive_time_first:速度优先(时间)
    • drive_fee_first:费用优先(不走收费路段的最快道路)
    • drive_dis_first:距离优先
    • drive_highway_no:不走高速
    • drive_jam_no:结合实时交通(躲避拥堵)
    • drive_highway_fee_no:不走高速且避免收费
    • drive_highway_jam_no:不走高速且躲避拥堵
    • drive_fee_jam_no:躲避收费和拥堵
    • drive_highway_fee_jam_no:不走高速且躲避收费和拥堵
    • transit_time_first:最快捷模式
    • transit_fee_first:最经济模式
    • transit_transfer_first:最少换乘模式
    • transit_walk_first:最少步行模式
    • transit_comfort_first:最舒适模式
    • transit_subway_no:不乘地铁模式

start:

  • 类型:JSON 对象
  • 描述:起点信息
  • 内部字段:
  1. {
  2. lon: 116.403838, //数字类型;起点经度
  3. lat: 39.914437 //数字类型;起点纬度
  4. }

waypoints:

  • 类型:JSON 对象
  • 描述:(可选项)途经点信息组成的数组,仅当 type 为 drive 时有效
  • 内部字段:
  1. [{
  2. lon: 116.403838, //数字类型;起点经度
  3. lat: 39.914437 //数字类型;起点纬度
  4. }]

nightflag:

  • 类型:布尔
  • 描述:(可选项)是否包含夜班车,仅当 type 为 transit 时有效
  • 默认:false

city:

  • 类型:字符串
  • 描述:(可选项)搜索公交路线时所在的城市,仅当 type 为 transit 时有效且必传

end:

  • 类型:JSON 对象
  • 描述:终点信息
  • 内部字段:
  1. {
  2. lon: 116.384852, //数字类型;终点经度
  3. lat: 39.989576 //数字类型;终点纬度
  4. }

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. start:{ //JSON对象;起点信息
  4. lon: 116.384852, //数字类型;起点经度
  5. lat: 39.989576 //数字类型;起点纬度
  6. },
  7. end:{ //JSON对象;终点信息
  8. lon: 116.384852, //数字类型;终点经度
  9. lat: 39.989576 //数字类型;终点纬度
  10. },
  11. taxiCost: 50, //数字类型;出租车费用(单位:元)
  12. paths: [{ //数组类型;步行、骑行、驾车方案列表数组
  13. steps:[{ //数组类型;路段基本信息组成的数组
  14. instruction:'左转', //字符串类型;行走指示
  15. orientation:'北', //字符串类型;方向
  16. road:'光明路', //字符串类型;道路名称
  17. distance:'2000', //数字类型;此路段长度(单位:米)
  18. duration:'1000', //数字类型;此路段预计耗时(单位:秒)
  19. action:'go', //字符串类型;导航主要动作
  20. assistantAction:'go',//字符串类型;导航辅助动作
  21. tolls:'5', //数字类型;此段收费(单位:元)
  22. tollDistance:'500', //数字类型;收费路段长度(单位:米)
  23. tollRoad:'' //字符串类型;主要收费路段
  24. enterLoc:{ //JSON对象;入口经纬度,Android 平台上无此字段
  25. lon:, //数字类型;入口经度
  26. lat: //数字类型;入口纬度
  27. },
  28. exitLoc:{ //JSON对象;出口经纬度,入口经纬度,Android 平台上无此字段
  29. lon:, //数字类型;出口经度
  30. lat: //数字类型;出口纬度
  31. }
  32. }],
  33. distance: 1000, //数字类型;路线长度,单位:米
  34. duration: 10, //数字类型;路线耗时,单位:秒
  35. strategy: 1000, //字符串类型;导航策略
  36. tolls: 1000, //数字类型;此方案费用(单位:元)
  37. tollDistance: 1000 //数字类型;此方案收费路段长度(单位:米)
  38. }],
  39. transits:[{ //数组类型;公交换乘方案列表数组
  40. cost: 50, //数字类型;此公交方案价格(单位:元)
  41. duration: 36000, //数字类型;此换乘方案预期时间(单位:秒)
  42. nightflag: false , //布尔类型;是否是夜班车
  43. walkingDistance: 100, //数字类型;此方案总步行距离(单位:米)
  44. busDistance: 100, //数字类型;此方案公交路线距离(单位:米),iOS 平台上无此参数
  45. segments:[{ //数组类型;换乘路段组成的数组
  46. enterName:'', //字符串类型;公交换乘路段入口名称
  47. exitName:'', //字符串类型;公交换乘路段出口名称
  48. busline:{ //JSON对象;路段可供选择的公交线路
  49. type:'', //字符串类型;公交类型
  50. name:'', //字符串类型;公交线路名称
  51. uid:'' //字符串类型;公交线路ID
  52. },
  53. enterLoc:{ //JSON对象;入口经纬度
  54. lon:, //数字类型;入口经度
  55. lat: //数字类型;入口纬度
  56. },
  57. exitLoc:{ //JSON对象;出口经纬度
  58. lon:, //数字类型;出口经度
  59. lat: //数字类型;出口纬度
  60. },
  61. walking:{ //JSON对象;此路段步行导航信息
  62. distance:, //数字类型;起点和终点的步行距离(单位:米)
  63. duration: //数字类型;步行预计时间
  64. }
  65. }]
  66. }]
  67. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.searchRoute({
  3. id: 1,
  4. type: 'drive',
  5. policy: 'drive_time_first',
  6. start: {
  7. lon: 116.403838,
  8. lat: 39.914437
  9. },
  10. end: {
  11. lon: 116.384852,
  12. lat: 39.989576
  13. },
  14. city: '北京',
  15. nightflag: false,
  16. waypoints: []
  17. }, function(ret, err) {
  18. if (ret.status) {
  19. api.alert({ msg: JSON.stringify(ret) });
  20. }
  21. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

drawRoute

在地图上绘制显示 searchRoute 搜索到的指定路线,调用本接口前,必须保证已经调用过 open 和 searchRoute 接口

drawRoute({params})

params

id:

  • 类型:数字
  • 描述:绘制路线分配的 id ,removeRoute 时使用此 id 移除路线

autoresizing:

  • 类型:布尔
  • 描述:路线渲染结束是否自动调整地图可视区域,为 true 时自带 0.3 秒地图移动动画效果
  • 默认值:true

index:

  • 类型:数字类型
  • 描述:路线方案的索引,在 searchRoute 时返回的多个路线方案组成的数组中的索引
  • 默认值:0

styles:

  • 类型:JSON 对象
  • 描述:路线样式设置
  • 内部字段:
  1. {
  2. walkLine:{ //(可选项)JSON对象;步行路线样式
  3. width: 3, //(可选项)数字类型;步行路线的线条宽度;默认:3
  4. color:'#698B22', //(可选项)字符串类型;步行路线的线条颜色,支持 rgb、rgba、#;默认:#698B22
  5. lineDash:false, //(可选项)布尔类型;步行路线的线条是否为虚线;默认:false
  6. strokeImg:'fs://arrow.png'//(可选项)字符串类型;组成纹理画线的图片路径,要求本地路径(fs://、widget://),若本参数不为空,则忽略 color、dashed 参数 。
  7. },
  8. rideLine:{ //(可选项)JSON对象;骑行路线样式
  9. width: 3, //(可选项)数字类型;骑行路线的线条宽度;默认:3
  10. color:'#698B22', //(可选项)字符串类型;骑行路线的线条颜色,支持 rgb、rgba、#;默认:#698B22
  11. lineDash:false, //(可选项)布尔类型;骑行路线的线条是否为虚线;默认:false
  12. strokeImg:'fs://arrow.png'//(可选项)字符串类型;组成纹理画线的图片路径,要求本地路径(fs://、widget://),若本参数不为空,则忽略 color、dashed 参数 。
  13. },
  14. driveLine:{ //(可选项)JSON对象;驾车路线样式
  15. width: 6, //(可选项)数字类型;驾车路线的线条宽度;默认:5
  16. color:'#0000EE', //(可选项)字符串类型;驾车路线的线条颜色,支持 rgb、rgba、#;默认:#00868B
  17. lineDash:false, //(可选项)布尔类型;驾车路线的线条是否为虚线;默认:false
  18. strokeImg:'fs://arrow.png'//(可选项)字符串类型;组成纹理画线的图片路径,要求本地路径(fs://、widget://),若本参数不为空,则忽略 color、dashed 参数。
  19. },
  20. busLine:{ //(可选项)JSON对象;公交路线样式
  21. width: 4, //(可选项)数字类型;公交路线的线条宽度;默认:4
  22. color:'#00BFFF', //(可选项)字符串类型;公交路线的线条颜色,支持 rgb、rgba、#;默认:#00BFFF
  23. lineDash:false, //(可选项)布尔类型;公交路线的线条是否为虚线;默认:false
  24. strokeImg:'fs://arrow.png'//(可选项)字符串类型;组成纹理画线的图片路径,要求本地路径(fs://、widget://),若本参数不为空,则忽略 color、dashed 参数。
  25. },
  26. icons: { //(可选项)JSON对象;路线结点标注图标
  27. start: '', //(可选项)字符串类型;起点图标路径,要求本地路径(fs://、widget://);默认:默认起点图标
  28. end: '', //(可选项)字符串类型;终点图标路径,要求本地路径(fs://、widget://);默认:默认终点图标
  29. bus: '', //(可选项)字符串类型;公交路线结点提示图标路径,要求本地路径(widget://、fs://)默认:默认公交图标
  30. car: '', //(可选项)字符串类型;驾车路线结点提示图标路径,要求本地路径(widget://、fs://)默认:默认驾车图标
  31. man: '', //(可选项)字符串类型;步行路线结点提示图标路径,要求本地路径(widget://、fs://)默认:默认步行图标
  32. ride: '' //(可选项)字符串类型;骑行路线结点提示图标路径,要求本地路径(widget://、fs://)默认:默认步行图标
  33. }
  34. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.searchRoute({
  3. type: 'drive',
  4. policy: 'drive_fee_first',
  5. start: {
  6. lon: 116.403838,
  7. lat: 39.914437
  8. },
  9. end: {
  10. lon: 116.384852,
  11. lat: 39.989576
  12. }
  13. }, function(ret, err) {
  14. if (ret.status) {
  15. aMap.drawRoute({
  16. id: 1,
  17. autoresizing: false,
  18. index: 0,
  19. styles: {
  20. walkLine: {
  21. width: 3,
  22. color: '#698B22',
  23. lineDash: false,
  24. strokeImg: ''
  25. },
  26. driveLine: {
  27. width: 6,
  28. color: '#0000EE',
  29. lineDash: false,
  30. strokeImg: ''
  31. },
  32. busLine: {
  33. width: 4,
  34. color: '#00BFFF',
  35. lineDash: false,
  36. strokeImg: ''
  37. },
  38. icons: {
  39. start: '',
  40. end: '',
  41. bus: '',
  42. car: '',
  43. man: ''
  44. }
  45. }
  46. });
  47. } else {
  48. api.alert({ msg: JSON.stringify(ret) });
  49. }
  50. });

可用性

iOS 系统,Android系统

可提供的1.0.0及更高版本

removeRoute

移除指定 id 的路线

removeRoute({params})

params

ids:

  • 类型:数组
  • 描述:所要移除的 id(数字)组成的数组

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.removeRoute({
  3. ids: [1, 2, 3]
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

searchBusRoute

根据关键字搜索公交、地铁线路,无需调用 open 接口即可搜索

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

params

city:

  • 类型:字符串
  • 描述:城市

line:

  • 类型:字符串
  • 描述:公交、地铁线路号(例如:1路,1号线)

offset:

  • 类型:数字
  • 描述:(可选项)每页记录数,取值为1-50
  • 默认:20

page:

  • 类型:数字
  • 描述:(可选项)当前页数,取值为1-100
  • 默认:1

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. buslines: [{ //数组类型;公交线路信息组成的数组
  4. uid: '', //字符串类型;公交线路ID
  5. type: '', //字符串类型;公交类型
  6. name: '', //字符串类型;公交线路名称
  7. startStop: '', //字符串类型;首发站
  8. endStop: '', //字符串类型;终点站
  9. startTime: '', //字符串类型;首班车时间
  10. endTime: '', //字符串类型;末班车时间
  11. company: '', //字符串类型;所属公交公司
  12. distance: '', //数字类型;此线路的全程距离,单位为千米
  13. basicPrice: '', //数字类型;起步价
  14. totalPrice: '', //数字类型;全程票价
  15. busStops: [{ //数组类型;途径公交站
  16. uid:'', //字符串类型;公交站点ID
  17. name:'', //字符串类型;公交站名
  18. lat: , //数字类型;公交站坐标纬度
  19. lon: //数字类型;公交站坐标经度
  20. }]
  21. }] ,
  22. suggestion:{ //JSON对象;关键字建议列表和城市建议列表
  23. keywords:['','','',''],//数组类型;字符串类型的关键字组成的建议列表
  24. cities:['','','',''] //数组类型;字符串类型的城市名组成的城市建议列表
  25. }
  26. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.searchBusRoute({
  3. city: '北京',
  4. line: '110',
  5. offset: 20,
  6. page: 1
  7. }, function(ret, err) {
  8. if (ret.status) {
  9. alert(JSON.stringify(ret));
  10. }
  11. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

drawBusRoute

根据 searchBusRoute 搜索返回的公交信息,将指定线路绘制在地图上

drawBusRoute({params})

params

id:

  • 类型:数字
  • 描述:地图上显示的公交、地铁路线的 id,removeBusRoute 时使用此 id

autoresizing:

  • 类型:布尔
  • 描述:路线渲染结束是否自动调整地图可视区域
  • 默认值:true

index:

  • 类型:数字类型
  • 描述:路线方案的索引,在 searchBusRoute 时返回的多个公交路线组成的数组中的索引
  • 默认值:0

styles:

  • 类型:JSON 对象
  • 描述:路线样式设置
  • 内部字段:
  1. {
  2. line:{ //(可选项)JSON对象;公交路线样式
  3. width: 4, //(可选项)数字类型;公交路线的线条宽度;默认:4
  4. color:'#00BFFF', //(可选项)字符串类型;公交路线的线条颜色,支持 rgb、rgba、#;默认:#00BFFF
  5. lineDash:false, //(可选项)布尔类型;公交路线的线条是否为虚线;默认:false
  6. strokeImg:'fs://arrow.png'//(可选项)字符串类型;组成纹理画线的图片路径,要求本地路径(fs://、widget://),若本参数不为空,则忽略 color、dashed 参数
  7. },
  8. icons: { //(可选项)JSON对象;路线结点标注图标
  9. start: '', //(可选项)字符串类型;起点图标路径,要求本地路径(fs://、widget://);默认:默认起点图标
  10. end: '', //(可选项)字符串类型;终点图标路径,要求本地路径(fs://、widget://);默认:默认终点图标
  11. bus: '' //(可选项)字符串类型;公交路线结点提示图标路径,要求本地路径(widget://、fs://)默认:默认公交图标
  12. }
  13. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.searchBusRoute({
  3. city: '北京',
  4. line: '110',
  5. offset: 20,
  6. page: 1
  7. }, function(ret, err) {
  8. if (ret.status) {
  9. aMap.drawBusRoute({
  10. id: 1,
  11. autoresizing: true,
  12. index: 0,
  13. styles: {
  14. line: {
  15. width: 4,
  16. color: '#00BFFF',
  17. lineDash: false,
  18. strokeImg: 'fs://arrow.png'
  19. },
  20. icons: {
  21. start: '',
  22. end: '',
  23. bus: ''
  24. }
  25. }
  26. });
  27. }
  28. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

removeBusRoute

移除地图上显示的公交、地铁线路

removeBusRoute({params})

params

ids:

  • 类型:数组
  • 描述:所要移除的公交、地铁线路的 id(数字)组成的数组

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.removeBusRoute({
  3. ids:[1, 2, 3]
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

searchInCity

根据单个关键字搜索兴趣点,无需调用 open 接口即可搜索

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

params

city:

  • 类型:字符串
  • 描述:要搜索的城市,可选值:cityname(中文或中文全拼)、citycode、adcode

keyword:

  • 类型:字符串
  • 描述:搜索的关键字,多个关键字用“|”分割

offset:

  • 类型:数字
  • 描述:(可选项)每页记录数,取值为1-50
  • 默认:20

page:

  • 类型:数字
  • 描述:(可选项)当前页数,取值为1-100
  • 默认:1

sortrule:

  • 类型:数字
  • 描述:(可选项)排序规则,0-距离排序;1-综合排序,Android 平台上忽略本参数
  • 默认:0

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. pois:[{ //数组类型;搜索的兴趣点信息组成的数组
  4. uid: '', //字符串类型;兴趣点全局唯一ID
  5. name: '', //字符串类型;兴趣点名称
  6. type: '', //字符串类型;兴趣点类型
  7. lat: , //数字类型;兴趣点纬度
  8. lon: , //数字类型;兴趣点经度
  9. address: '', //字符串类型;兴趣点地址
  10. province: '', //字符串类型;省
  11. city: '', //字符串类型;城市名称
  12. district: '', //字符串类型;区域名称
  13. tel: '', //字符串类型;兴趣点电话
  14. distance: //数字类型;兴趣点距离中心点距离
  15. }],
  16. suggestion:{ //JSON对象;关键字建议列表和城市建议列表
  17. keywords:['','','',''],//数组类型;字符串类型的关键字组成的建议列表
  18. cities:['','','',''] //数组类型;字符串类型的城市名组成的城市建议列表
  19. }
  20. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.searchInCity({
  3. city: '北京',
  4. keyword: '学校',
  5. offset: 20,
  6. page: 1,
  7. sortrule: 0
  8. }, function(ret) {
  9. if (ret.status) {
  10. alert(JSON.stringify(ret));
  11. }
  12. });

补充说明

searchInCity、searchNearby、searchInPolygon 三者不可并发执行,在接口未响应前 ,最后一次调用的接口会覆盖之前调用的所有接口

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

searchNearby

根据单个关键字在圆形区域内搜索兴趣点,无需调用 open 接口即可搜索

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

params

keyword:

  • 类型:字符串
  • 描述:搜索关键字,多个关键字用“|”分割

lon:

  • 类型:数字
  • 描述:指定区域中心点的经度

lat:

  • 类型:数字
  • 描述:指定区域中心点的纬度

radius:

  • 类型:数字
  • 描述:(可选项)指定区域的半径,单位为 m(米),范围:0-50000
  • 默认:3000

offset:

  • 类型:数字
  • 描述:(可选项)每页记录数,取值为1-50
  • 默认:20

page:

  • 类型:数字
  • 描述:(可选项)当前页数,取值为1-100
  • 默认:1

sortrule:

  • 类型:数字
  • 描述:(可选项)排序规则,0-距离排序;1-综合排序,Android 平台上忽略本参数
  • 默认:0

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. pois:[{ //数组类型;搜索的兴趣点信息组成的数组
  4. uid: '', //字符串类型;兴趣点全局唯一ID
  5. name: '', //字符串类型;兴趣点名称
  6. type: '', //字符串类型;兴趣点类型
  7. lat: , //数字类型;兴趣点纬度
  8. lon: , //数字类型;兴趣点经度
  9. address: '', //字符串类型;兴趣点地址
  10. province: '', //字符串类型;省
  11. city: '', //字符串类型;城市名称
  12. district: '', //字符串类型;区域名称
  13. tel: '', //字符串类型;兴趣点电话
  14. distance: //数字类型;兴趣点距离中心点距离
  15. }],
  16. suggestion:{ //JSON对象;关键字建议列表和城市建议列表
  17. keywords:['','','',''],//数组类型;字符串类型的关键字组成的建议列表
  18. cities:['','','',''] //数组类型;字符串类型的城市名组成的城市建议列表
  19. }
  20. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.searchNearby({
  3. keyword: 'KTV',
  4. lon: 116.384767,
  5. lat: 39.989539,
  6. radius: 2000,
  7. offset: 20,
  8. page: 1,
  9. sortrule: 0
  10. }, function(ret, err) {
  11. if (ret.status) {
  12. alert(JSON.stringify(ret));
  13. }
  14. });

补充说明

searchInCity、searchNearby、searchInPolygon 三者不可并发执行,在接口未响应前 ,最后一次调用的接口会覆盖之前调用的所有接口

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

searchInPolygon

根据单个关键字在指定的多边形区域内搜索兴趣点,无需调用 open 接口即可搜索

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

params

keyword:

  • 类型:字符串
  • 描述:搜索关键字

points:

  • 类型:数组
  • 描述:能确定一个多边形的坐标点集合
  • 内部字段:
  1. [{
  2. lat: , //数字类型;坐标点的纬度
  3. lon: //数字类型;坐标点的经度
  4. }]

offset:

  • 类型:数字
  • 描述:(可选项)每页记录数,取值为1-50
  • 默认:20

page:

  • 类型:数字
  • 描述:(可选项)当前页数,取值为1-100
  • 默认:1

sortrule:

  • 类型:数字
  • 描述:(可选项)排序规则,0-距离排序;1-综合排序,Android 平台上忽略本参数
  • 默认:0

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. pois:[{ //数组类型;搜索的兴趣点信息组成的数组
  4. uid: '', //字符串类型;兴趣点全局唯一ID
  5. name: '', //字符串类型;兴趣点名称
  6. type: '', //字符串类型;兴趣点类型
  7. lat: , //数字类型;兴趣点纬度
  8. lon: , //数字类型;兴趣点经度
  9. address: '', //字符串类型;兴趣点地址
  10. province: '', //字符串类型;省
  11. city: '', //字符串类型;城市名称
  12. district: '', //字符串类型;区域名称
  13. tel: '', //字符串类型;兴趣点电话
  14. distance: //数字类型;兴趣点距离中心点距离
  15. }],
  16. suggestion:{ //JSON对象;关键字建议列表和城市建议列表
  17. keywords:['','','',''],//数组类型;字符串类型的关键字组成的建议列表
  18. cities:['','','',''] //数组类型;字符串类型的城市名组成的城市建议列表
  19. }
  20. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.searchInPolygon({
  3. keyword: '图书馆',
  4. points: [{
  5. lat: 34.55648,
  6. lon: 112.47723
  7. }, {
  8. lat: 34.13144,
  9. lon: 112.87723
  10. }, {
  11. lat: 34.13144,
  12. lon: 112.47723
  13. }],
  14. offset: 20,
  15. page: 1,
  16. sortrule: 0
  17. }, function(ret, err) {
  18. if (ret.status) {
  19. alert(JSON.stringify(ret));
  20. }
  21. });

补充说明

searchInCity、searchNearby、searchInPolygon 三者不可并发执行,在接口未响应前 ,最后一次调用的接口会覆盖之前调用的所有接口

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

autocomplete

根据关键字返回建议搜索关键字,无需调用 open 接口即可搜索

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

params

keyword:

  • 类型:字符串
  • 描述:关键字

city:

  • 类型:字符串
  • 描述:要搜索的城市,查询城市,中文或中文全拼

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. tips: [{ //数组类型;返回建议搜索关键字组成的数组
  4. uid: '', //字符串类型;提示点的id,Android 平台上忽略本参数
  5. name: '', //字符串类型;提示点的名字
  6. adcode: '', //字符串类型;提示点所在区域编码
  7. district: '', //字符串类型;提示的所属区域
  8. lat: , //数字类型;提示点纬度
  9. lon: //数字类型;提示点经度
  10. }]
  11. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.autocomplete({
  3. keyword: '北京',
  4. city: '北京'
  5. }, function(ret) {
  6. if (ret.status) {
  7. alert(JSON.stringify(ret));
  8. }
  9. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

districtSearch

根据关键字返回行政区划数据,无需调用 open 接口即可搜索,如果调用open打开了一个地图,则同时在地图上绘制并跳转到行政区划边界区域,是否绘制由showInMap控制

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

params

keyword:

  • 类型:字符串
  • 描述:关键字,该字段只支持精确名称,不可以是拼音,简写,代号等,如:北京可以用,但beijing,首都 等字样是无效的;

showInMap:

  • 类型:JSON对象
  • 描述:(可选项)搜索的区域是否同时显示在当前地图上,若不传,则不显示
  • 内部字段:
  1. {
  2. type: 'arrow', //(可选项)字符串类型;线的末端类型;默认:round;取值范围如下:
  3. //round:圆头线,在Android 上无效,显示为普通方头线条
  4. //square:方头线
  5. //arrow:带箭头的线
  6. lineDash: false, //(可选项)布尔类型;是否绘制成虚线,当 type 为 arrow 时,本参数无效;默认:false
  7. borderColor: '#000', //(可选项)字符串类型;线的颜色,支持 rgb、rgba、#;默认值:'#000'
  8. borderWidth: 3, //(可选项)数字类型;线的宽度,默认:2
  9. strokeImg:'fs://arrow.png'//(可选项)字符串类型;组成纹理画线的图片路径,要求本地路径(fs://、widget://),若本参数不为空,则本接口忽略 type、lineDash、borderColor 参数
  10. }

callback(ret,err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. districtResult: { //JSON对象;搜索结果
  4. count: 10, //数字类型;子区域数
  5. districts: [{ //JSON对象;行政区信息
  6. adcode: '', //字符串类型;区域编码
  7. citycode: '', //字符串类型;城市编码
  8. name: '', //字符串类型;行政区名称
  9. level: '' //字符串类型;级别
  10. center: { //JSON对象;城市中心点经纬度
  11. latitude: , //数字类型;维度
  12. longitude: //数字类型;经度
  13. },
  14. polylines:['','','']//字符串类型;内部元素是边界线段上的点的经纬度拼接成的字符串,如:'119.309678,39.397575;119.309339,39.397613;'
  15. districts:{ //JSON对象;子区域信息,内部数据接口同父级一致
  16. ...
  17. }]
  18. }
  19. }
  20. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.districtSearch({
  3. keyword: '北京',
  4. showInMap:{}//传空取默认值,不传则不显示边界线
  5. }, function(ret) {
  6. if (ret.status) {
  7. alert(JSON.stringify(ret));
  8. }
  9. });

可用性

iOS系统,Android系统

可提供的1.0.7及更高版本

weatherSearch

查询天气,无需调用 open 接口即可搜索

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

params

cityName:

  • 类型:字符串
  • 描述:城市:如’北京’,iOS端支持cityname和adcode,如:’110000’

type:

  • 类型:字符串
  • 描述:(可选项)查询类型
  • 默认:live
  • 取值范围:
    • live:实时天气
    • forecast:预报天气

callback(ret,err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;是否查询成功
  3. type: '', //字符串类型;查询类型,live|forecast
  4. weather: { //JSON对象类型;天气信息
  5. forecasts: [{ //数组类型;预报信息
  6. adcode: '', //字符串类型;区域编码
  7. province: '', //字符串类型;省份名
  8. city: '', //字符串类型;城市名
  9. reportTime'', //字符串类型;数据发布时间
  10. casts:[{ //数组类型;
  11. date: '', //字符串类型;日期
  12. week: '', //字符串类型;星期
  13. dayWeather: '', //字符串类型;白天天气
  14. nightWeather'', //字符串类型;晚上天气
  15. dayTemp: '', //字符串类型;白天气温
  16. nightTemp: '', //字符串类型;晚上气温
  17. dayWind: '', //字符串类型;白天风向
  18. nightWind'', //字符串类型;晚上风向
  19. dayPower: '', //字符串类型;白天风力
  20. nightPower'', //字符串类型;晚上风力
  21. }]
  22. }]
  23. lives: [{ //数组类型;实时天气信息
  24. adcode: '', //字符串类型;区域编码
  25. province: '', //字符串类型;省份名
  26. city: '', //字符串类型;城市名
  27. weather: '', //字符串类型;天气现象
  28. temperature:'', //字符串类型;温度
  29. windDirection:'',//字符串类型;风向
  30. windPower'', //字符串类型;风力,单位:级
  31. humidity:'', //字符串类型;空气湿度
  32. reportTime'' //字符串类型;数据发布时间
  33. }]
  34. }
  35. },

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code:, //数字类型;错误码
  3. msg:'' //字符串类型;错误信息
  4. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.weatherSearch({
  3. cityName:'北京',
  4. type:'live'
  5. }, function(ret, err) {
  6. if (ret.status) {
  7. api.alert({msg:JSON.stringify(ret)});
  8. } else {
  9. api.alert({msg:JSON.stringify(err)});
  10. }
  11. });

可用性

iOS系统,Android系统

可提供的1.4.5及更高版本

getProvinces

获取省份列表,无需调用 open 接口

getProvinces(callback(ret, err))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. provinces : [ //数组类型;返回全国省份的信息
  4. { //JSON对象;返回组成该省份的信息
  5. name: '', //字符串类型;区域名称
  6. adcode: '', //字符串类型;区域编码
  7. jianpin: '', //字符串类型;区域简拼
  8. pinyin: '', //字符串类型;区域拼音
  9. size: , //数字类型;该区域离线包数据大小,单位:byte
  10. downloadSize: , //数字类型;已下载离线包数据大小,单位:byte,android 平台暂不支持本字段
  11. status: //数字类型;城市离线数据状态,取值范围如下:
  12. // 0:不存在
  13. // 1:缓存状态
  14. // 2:已安装
  15. // 3:已过期
  16. },{},{},{}...
  17. ]
  18. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getProvinces(function(ret) {
  3. if (ret.status) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getCitiesByProvince

获取各个省份包括的城市列表,无需调用 open 接口

getCitiesByProvince(callback(ret, err))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. provinces : [ //数组类型;返回全国各省份城市信息
  4. {
  5. province:{ //JSON对象;返回组成该省份的信息
  6. name: '', //字符串类型;区域名称
  7. adcode: '', //字符串类型;区域编码
  8. jianpin: '', //字符串类型;区域简拼
  9. pinyin: '', //字符串类型;区域拼音
  10. size: , //数字类型;该区域离线包数据大小,单位:byte
  11. downloadSize: , //数字类型;已下载离线包数据大小,单位:byte,android 平台暂不支持本字段
  12. status: //数字类型;城市离线数据状态,取值范围如下:
  13. // 0:不存在
  14. // 1:缓存状态
  15. // 2:已安装
  16. // 3:已过期
  17. },
  18. cities:[ //数组类型;返回组成该省份的各个城市信息
  19. {
  20. name: '', //字符串类型;区域名称
  21. adcode: '', //字符串类型;区域编码
  22. cityCode: , //字符串类型;城市编码
  23. jianpin: '', //字符串类型;区域简拼
  24. pinyin: '', //字符串类型;区域拼音
  25. size: , //数字类型;该区域离线包数据大小,单位:byte
  26. downloadSize: , //数字类型;已下载离线包数据大小,单位:byte,android 平台暂不支持本字段
  27. status: //数字类型;城市离线数据状态,取值范围如下:
  28. // 0:不存在
  29. // 1:缓存状态
  30. // 2:已安装
  31. // 3:已过期
  32. },{}...]
  33. },{},{}...]
  34. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getCitiesByProvince(function(ret) {
  3. if (ret.status) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

iOS系统,Android系统

可提供的1.1.8及更高版本

getMunicipalities

获取直辖市列表,无需调用 open 接口。Android 平台不支持此接口

getMunicipalities(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. municipalities : [{ //数组类型;返回全国直辖市信息
  4. name: '', //字符串类型;区域名称
  5. adcode: '', //字符串类型;区域编码
  6. cityCode: , //字符串类型;城市编码
  7. jianpin: '', //字符串类型;区域简拼
  8. pinyin: '', //字符串类型;区域拼音
  9. size: , //数字类型;该区域离线包数据大小,单位:byte
  10. downloadSize: , //数字类型;已下载离线包数据大小,单位:byte
  11. status: //数字类型;城市离线数据状态,取值范围如下:
  12. // 0:不存在
  13. // 1:缓存状态
  14. // 2:已安装
  15. // 3:已过期
  16. }]
  17. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getMunicipalities(function(ret) {
  3. if (ret.status) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

iOS系统

可提供的1.0.0及更高版本

getNationWide

获取全国概要图信息,无需调用 open 接口。Android 平台不支持此接口

getNationWide(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. nationWide : { //JSON对象;全国概要图信息
  4. name: '', //字符串类型;区域名称
  5. adcode: '', //字符串类型;区域编码
  6. cityCode: , //字符串类型;城市编码
  7. jianpin: '', //字符串类型;区域简拼
  8. pinyin: '', //字符串类型;区域拼音
  9. size: , //数字类型;该区域离线包数据大小,单位:byte
  10. downloadSize: , //数字类型;已下载离线包数据大小,单位:byte
  11. status: //数字类型;城市离线数据状态,取值范围如下:
  12. // 0:不存在
  13. // 1:缓存状态
  14. // 2:已安装
  15. // 3:已过期
  16. }
  17. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getNationWide(function(ret) {
  3. if (ret.status) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

iOS系统

可提供的1.0.0及更高版本

getAllCities

获取全国所有离线地图城市信息,无需调用 open 接口

getAllCities(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. cities : [{ //JSON对象;全国所有离线城市信息
  4. name: '', //字符串类型;区域名称
  5. adcode: '', //字符串类型;区域编码
  6. cityCode: , //字符串类型;城市编码
  7. jianpin: '', //字符串类型;区域简拼
  8. pinyin: '', //字符串类型;区域拼音
  9. size: , //数字类型;该区域离线包数据大小,单位:byte
  10. downloadSize: , //数字类型;已下载离线包数据大小,单位:byte
  11. status: //数字类型;城市离线数据状态,取值范围如下:
  12. // 0:不存在
  13. // 1:缓存状态
  14. // 2:已安装
  15. // 3:已过期
  16. }]
  17. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getAllCities(function(ret) {
  3. if (ret.status) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getVersion

获取离线数据的版本号,无需调用 open 接口。Android 平台不支持此接口

getVersion(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. versioin: '20130715' //字符串类型;离线数据的版本号,由年月日组成, 如@"20130715"
  4. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.getVersion(function(ret) {
  3. if (ret.status) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

iOS系统

可提供的1.0.0及更高版本

downloadRegion

启动下载指定 adcode 区域的离线地图,无需调用 open 接口

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

params

adcode:

  • 类型:字符串
  • 描述:指定的区域的 adcode 码(在android平台使用区域的cityCode)

shouldContinueWhenAppEntersBackground:

  • 类型:布尔
  • 描述:(可选项)进入后台是否允许继续下载
  • 默认:false

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: 0, //数字类型;取值范围如下:
  3. // 0:以插入队列,等待中
  4. // 1:开始下载
  5. // 2:下载过程中
  6. // 3:下载成功
  7. // 4:取消
  8. // 5:解压缩
  9. // 6:全部顺利完成
  10. // 7:发生错误
  11. info: { //JSON对象;离线包信息,仅当 status 为2时有值
  12. expectedSize: , //数字类型;离线包大小,单位:byte
  13. receivedSize: //数字类型;已下载到本地离线包大小,单位:byte
  14. }
  15. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.downloadRegion({
  3. adcode: '110000',
  4. shouldContinueWhenAppEntersBackground: true
  5. }, function(ret) {});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

isDownloading

检测指定 adcode 的区域是否正在下载,无需调用 open 接口

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

params

adcode:

  • 类型:字符串
  • 描述:指定的区域的 adcode 码

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔型;是否正在下载,true||false
  3. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.isDownloading({
  3. adcode: '110000'
  4. }, function(ret) {
  5. if (ret.status) {
  6. alert('正在下载');
  7. }
  8. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

pauseDownload

暂停下载指定 adcode 区域的离线地图,无需调用 open 接口,android端会暂停所有下载

pauseDownload({params})

params

adcode:

  • 类型:字符串
  • 描述:指定的区域的 adcode 码

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.pauseDownload({
  3. adcode: '110000'
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

cancelAllDownload

取消全部下载,无需调用 open 接口,android端会取消所有下载

cancelAllDownload()

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.cancelAllDownload();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

clearDisk

清除所有保存在磁盘上的离线地图数据, 之后调用 reloadMap 会使其立即生效

clearDisk()

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.clearDisk();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

checkNewestVersion

监测新版本,Android 平台不支持此接口

checkNewestVersion(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔型;是否有新版本,true||false
  3. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.checkNewestVersion(function(ret) {
  3. if (ret.status) {
  4. alert('有新版本');
  5. } else {
  6. alert('无新版本');
  7. }
  8. });

可用性

iOS系统

可提供的1.0.0及更高版本

reloadMap

将离线地图下载解压、移除后,调用此函数使离线数据生效,Android 平台不支持此接口

reloadMap()

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.reloadMap();

可用性

iOS系统

可提供的1.0.0及更高版本

convertCoordinate

其它坐标系经纬度转换为高德地图经纬度

convertCoordinate({params},callback(ret))

params

type:

  • 类型:字符串
  • 描述:(可选项)经纬度坐标类型
  • 默认:GPS
  • 取值范围:
    • GPS:gps坐标
    • baidu:百度坐标
    • mapBar:mapbar坐标
    • mapABC:mapABC坐标
    • sosoMap:soso地图坐标
    • aliYun:阿里云地图坐标
    • google:谷歌地图坐标

location:

  • 类型:JSON对象
  • 描述:经纬度
  • 内部字段:
  1. {
  2. lat: , //数字类型:纬度
  3. lon: //数字类型:经度
  4. }

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. lat: , //数字类型:纬度
  3. lon: //数字类型:经度
  4. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.convertCoordinate({
  3. type:'GPS',
  4. location:{
  5. lat:,
  6. lon:
  7. }
  8. },function(ret){
  9. api.alert({msg:JSON.stringify(ret)});
  10. });

可用性

iOS系统,android系统

可提供的1.1.8及更高版本

processedTrace

开始纠偏轨迹

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

params

type:

  • 类型:字符串
  • 描述:(可选项)轨迹坐标类型
  • 默认:aMap
  • 取值范围:

    • aMap: 高德地图坐标
    • GPS:gps坐标

    • baidu:百度坐标

    • mapBar:mapbar坐标
    • mapABC:mapABC坐标
    • sosoMap:soso地图坐标
    • aliYun:阿里云地图坐标
    • google:谷歌地图坐标

path:

  • 类型:字符串
  • 描述:经纬度轨迹点信息文件路径,要求本地路径(widget://、fs://)
  • 内部字段:
  1. [{
  2. "loctime":1470297096917, //数字类型;时间,单位毫秒
  3. "longitude":116.47284, //数字类型;经度坐标
  4. "latitude":39.99493, //数字类型;纬度坐标
  5. "speed":0, //数字类型;速度,单位km/h
  6. "bearing":0 //数字类型;角度, 标识移动方向,单位度
  7. }]

savePath:

  • 类型:字符串
  • 描述:(可选项)纠偏后的经纬度轨迹点信息文件保存路径,要求本地路径(fs://)
  • 默认:若不传则使用模块默认路径

callback(ret,err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔类型;是否纠偏成功
  3. path: ‘’ //字符串类型;纠偏后的轨迹点信息文件保存路径,格式如下所示:
  4. [{"longitude":116,"latitude":34},{}...]
  5. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: true, //布尔类型;错误码
  3. msg: ‘’ //字符串类型;错误信息
  4. }

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.processedTrace({
  3. type:'GPS',
  4. path:'',
  5. savePath:''
  6. },function(ret,err) {
  7. api.alert({msg:JSON.stringify(ret)});
  8. });

可用性

iOS系统,android系统

可提供的1.1.8及更高版本

cancelProcessedTrace

取消轨迹纠偏

cancelProcessedTrace()

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.cancelProcessedTrace();

可用性

iOS系统,android系统

可提供的1.1.8及更高版本

setMapLanguage

地图中英文切换

setMapLanguage()

params

language:

  • 类型:字符串
  • 描述:要切换的语言
  • 取值范围:’zh_cn’/中文,’en’/英文
  • 默认:’zh_cn’

示例代码

  1. var aMap = api.require('aMap');
  2. aMap.setMapLanguage({
  3. language:'zh_cn'
  4. });

可用性

iOS系统,android系统

可提供的1.1.8及更高版本

论坛示例

为帮助用户更好更快的使用模块,论坛维护了一个示例,示例中包含示例代码、知识点讲解、注意事项等,供您参考。