媒体 – 第 21 页 – 微信小程序开发指南

MapContext.removeCustomLayer(Object object)

基础库 2.12.0 开始支持，低版本需做兼容处理。

以 Promise 风格调用：不支持

微信小程序插件：支持

相关文档: map

功能描述

移除个性化图层。

参数

Object object

属性	类型	必填	说明
layerId	string	是	个性化图层id
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

MapContext.removeArc(Object object)

基础库 2.22.0 开始支持，低版本需做兼容处理。

以 Promise 风格调用：不支持

微信小程序插件：支持

微信鸿蒙 OS 版：支持

相关文档: map

功能描述

删除弧线。工具侧暂未支持。

参数

Object object

属性	类型	必填	说明
id	number	是	圆弧 id
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

MapContext.openMapApp(Object object)

基础库 2.14.0 开始支持，低版本需做兼容处理。

以 Promise 风格调用：不支持

微信小程序插件：支持

微信鸿蒙 OS 版：支持

相关文档: map

功能描述

拉起地图APP选择导航。

参数

Object object

属性

类型

默认值

必填

说明

longitude

Number

是

目的地经度

latitude

Number

是

目的地纬度

destination

String

是

目的地名称

preferApplication

String

否

指定推荐使用的地图 App

合法值	说明
baidu	百度地图
google	谷歌地图
amap	高德地图
tencent	腾讯地图
petal	花瓣地图
apple	苹果地图

poiId

Object

否

传递给地图App的poi参数

结构属性	类型	必填	说明
baidu	String	否	百度地图
google	String	否	谷歌地图
amap	String	否	高德地图
tencent	String	否	腾讯地图
petal	String	否	花瓣地图
apple	String	否	苹果地图

success

function

否

接口调用成功的回调函数

fail

function

否

接口调用失败的回调函数

complete

function

否

接口调用结束的回调函数（调用成功、失败都会执行）

MapContext.on(string event, function callback)

基础库 2.13.0 开始支持，低版本需做兼容处理。

微信小程序插件：支持

微信鸿蒙 OS 版：支持

相关文档: map

功能描述

监听地图事件。

visualLayerEvent

可视化图层 visualLayer 统一回调出口，’2.26.0′ 起支持。

返回参数

参数	类型	说明
layerId	String	图层 id
eventType	String	事件类型
eventInfo	String	事件信息

markerClusterCreate

缩放或拖动导致新的聚合簇产生时触发，仅返回新创建的聚合簇信息。

返回参数

参数	类型	说明
clusters	`Array<ClusterInfo>`	聚合簇数据

markerClusterClick

聚合簇的点击事件。

返回参数

参数	类型	说明
cluster	ClusterInfo	聚合簇

ClusterInfo 结构

参数	类型	说明
clusterId	Number	聚合簇的 id
center	LatLng	聚合簇的坐标
markerIds	`Array<Number>`	该聚合簇内的点标记数据数组

markerCollisionStatusChange

marker 参与碰撞后隐藏时的回调，’3.4.3′ 起支持。

返回参数

参数	类型	说明
show	`Array<Number>`	碰撞时隐藏后又显示的 `markerIds`
hide	`Array<Number>`	碰撞时被隐藏的 `markerIds`

参数

string event

事件名

event 的合法值

值	说明	最低版本
markerClusterCreate
markerClusterClick
visualLayerEvent
markerCollisionStatusChange

function callback

事件的回调函数

示例代码

  MapContext.on('visualLayerEvent', (res) => {})
  MapContext.on('markerClusterCreate', (res) => {})
  MapContext.on('markerClusterClick', (res) => {})
  MapContext.on('markerCollisionStatusChange', (res) => {})

MapContext.moveToLocation(Object object)

基础库 1.2.0 开始支持，低版本需做兼容处理。

以 Promise 风格调用：不支持

用户授权：需要 scope.userLocation

微信小程序插件：支持

相关文档: map

功能描述

将地图中心移置当前定位点，此时需设置地图组件 show-location 为true。’2.8.0′ 起支持将地图中心移动到指定位置。

参数

Object object

属性	类型	必填	说明	最低版本
longitude	number	否	经度	2.8.0
latitude	number	否	纬度	2.8.0
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

MapContext.moveAlong(Object object)

基础库 2.13.0 开始支持，低版本需做兼容处理。

以 Promise 风格调用：不支持

微信小程序插件：支持

相关文档: map

功能描述

沿指定路径移动 marker，用于轨迹回放等场景。动画完成时触发回调事件，若动画进行中，对同一 marker 再次调用 moveAlong 方法，前一次的动画将被打断。

参数

Object object

属性	类型	默认值	必填	说明
markerId	number		是	指定 marker
path	Array		是	移动路径的坐标串，坐标点格式 `{longitude, latitude}`
autoRotate	boolean	true	否	根据路径方向自动改变 marker 的旋转角度
duration	number		是	平滑移动的时间
precision	Object		是	平滑移动触发 map 组件 interpolatepoint 事件的插值精度，单位为 m。默认不触发。
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

MapContext.initMarkerCluster(Object object)

基础库 2.13.0 开始支持，低版本需做兼容处理。

以 Promise 风格调用：不支持

微信小程序插件：支持

相关文档: map

功能描述

初始化点聚合的配置，未调用时采用默认配置。

参数

Object object

属性	类型	默认值	必填	说明
enableDefaultStyle	boolean	true	否	启用默认的聚合样式
zoomOnClick	boolean	true	否	点击已经聚合的标记点时是否实现聚合分离
gridSize	number	60	否	聚合算法的可聚合距离，即距离小于该值的点会聚合至一起，以像素为单位
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

MapContext.includePoints(Object object)

基础库 1.2.0 开始支持，低版本需做兼容处理。

以 Promise 风格调用：不支持

微信小程序插件：支持

微信鸿蒙 OS 版：支持

相关文档: map

功能描述

缩放视野以展示所有经纬度

参数

Object object

属性类型默认值必填说明

points Array.<Object> 是要显示在可视区域内的坐标点列表

	结构属性	类型	默认值	必填	说明
	longitude	number		是	经度
	latitude	number		是	纬度

padding Array.<number> 否坐标点形成的矩形边缘到地图边缘的距离，单位像素。格式为[上,右,下,左]。开发者工具暂不支持 padding 参数。

success function 否接口调用成功的回调函数

fail function 否接口调用失败的回调函数

complete function 否接口调用结束的回调函数（调用成功、失败都会执行）

MapContext.getSkew(Object object)

基础库 2.8.0 开始支持，低版本需做兼容处理。

以 Promise 风格调用：不支持

微信小程序插件：支持

微信鸿蒙 OS 版：支持

相关文档: map

功能描述

获取当前地图的倾斜角

参数

Object object

属性	类型	必填	说明
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

Object res

属性	类型	说明
skew	number	倾斜角

MapContext.getScale(Object object)

基础库 1.4.0 开始支持，低版本需做兼容处理。

以 Promise 风格调用：不支持

微信小程序插件：支持

相关文档: map

功能描述

获取当前地图的缩放级别

参数

Object object

属性	类型	必填	说明
success	function	否	接口调用成功的回调函数
fail	function	否	接口调用失败的回调函数
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

Object res

属性	类型	说明
scale	number	缩放值