uni.createMapContext(options)

创建并返回 map 上下文 mapContext 对象

参考：Map组件

createMapContext 兼容性

Web	Android	iOS
-	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
mapId	string	是	-	-	-
component	ComponentPublicInstance	否	-	-

返回值

类型	描述	必备
MapContext	map组件上下文对象	否

MapContext 的方法

getCenterLocation(options : MapContextGetCenterLocationOptions) : void;

获取当前地图中心的经纬度，返回的是 gcj02 坐标系，可以用于 uni.openLocation

getCenterLocation 兼容性

Web	Android	iOS
-	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
options	MapContextGetCenterLocationOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 success (result: LocationObject) => void 否 - - 接口调用成功的回调函数 fail (result: MapContextFail) => void 否 null - 接口调用失败的回调函数 complete (result: any) => void 否 null - 接口调用结束的回调函数（调用成功、失败都会执行）

LocationObject 的属性值

名称	类型	必备	默认值	兼容性	描述
latitude	number	是	-	Web Android iOS - 4.31 4.31	纬度，浮点数，范围为-90~90，负数表示南纬
longitude	number	是	-	Web Android iOS - 4.31 4.31	经度，范围为-180~180，负数表示西经

MapContextFail 的属性值

名称	类型	必备	默认值	兼容性	描述
errCode	number	是	-	-	错误码
合法值 兼容性 描述 500001 - 获取当前地图中心的经纬度失败 500002 - 未找到当前定位位置 500003 - 未找到marker 500004 - 创建自定义图片图层失败 500005 - 未找到自定义图层id 500006 - 网络图片加载失败 500012 - 地图内部错误
errSubject	string	是	-	-	统一错误主题（模块）名称
data	any	否	-	-	错误信息中包含的数据
cause	Error	否	-	-	源错误信息，可以包含多个错误，详见SourceError
errMsg	string	是	-	-	-

moveToLocation(options : MapContextMoveToLocationOptions) : void;

将地图中心移动到当前定位点，需要配合map组件的show-location使用

moveToLocation 兼容性

Web	Android	iOS
-	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
options	MapContextMoveToLocationOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 latitude number 否 null Web Android iOS - 4.31 4.31 纬度，浮点数，范围为-90~90，负数表示南纬 longitude number 否 null Web Android iOS - 4.31 4.31 经度，范围为-180~180，负数表示西经 success (result: any) => void 否 null - 接口调用成功的回调函数 fail (result: MapContextFail) => void 否 null - 接口调用失败的回调函数 complete (result: any) => void 否 null - 接口调用结束的回调函数（调用成功、失败都会执行）

translateMarker(options : MapContextTranslateMarkerOptions) : void;

平移marker，带动画

translateMarker 兼容性

Web	Android	iOS
-	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
options	MapContextTranslateMarkerOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 markerId number 是 - Web Android iOS - 4.31 4.31 指定marker destination LocationObject 是 - Web Android iOS - 4.31 4.31 指定marker移动到的目标点 autoRotate boolean 否 - Web Android iOS - x x 移动过程中是否自动旋转marker rotate number 否 0 Web Android iOS - 4.31 4.31 marker的旋转角度 moveWithRotate boolean 否 false Web Android iOS - 4.31 4.31 平移和旋转同时进行 duration number 否 1000 Web Android iOS - 4.31 4.31 动画持续时长，平移与旋转分别计算 success (result: any) => void 否 null - 接口调用成功的回调函数 fail (result: MapContextFail) => void 否 null - 接口调用失败的回调函数 complete (result: any) => void 否 null - 接口调用结束的回调函数（调用成功、失败都会执行）

includePoints(options : MapContextIncludePointsOptions) : void;

缩放视野展示所有经纬度

includePoints 兼容性

Web	Android	iOS
-	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
options	MapContextIncludePointsOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 points Array<LocationObject> 是 - Web Android iOS - 4.31 4.31 要显示在可视区域内的坐标点列表，[{latitude, longitude}] success (result: any) => void 否 null - 接口调用成功的回调函数 fail (result: MapContextFail) => void 否 null - 接口调用失败的回调函数 complete (result: any) => void 否 null - 接口调用结束的回调函数（调用成功、失败都会执行）

getRegion(options : MapContextGetRegionOptions) : void;

获取当前地图的视野范围

getRegion 兼容性

Web	Android	iOS
-	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
options	MapContextGetRegionOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 success (result: MapContextGetRegionResult) => void 否 null - 接口调用成功的回调函数 fail (result: MapContextFail) => void 否 null - 接口调用失败的回调函数 complete (result: any) => void 否 null - 接口调用结束的回调函数（调用成功、失败都会执行）

MapContextGetRegionResult 的属性值

名称	类型	必备	默认值	兼容性	描述
southwest	LocationObject	是	-	Web Android iOS - 4.31 4.31	西南角的经纬度
northeast	LocationObject	是	-	Web Android iOS - 4.31 4.31	东北角的经纬度

getScale(options : MapContextGetScaleOptions) : void;

获取当前地图的缩放级别

getScale 兼容性

Web	Android	iOS
-	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
options	MapContextGetScaleOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 success (result: MapContextGetScaleResult) => void 否 null - 接口调用成功的回调函数 fail (result: MapContextFail) => void 否 null - 接口调用失败的回调函数 complete (result: any) => void 否 null - 接口调用结束的回调函数（调用成功、失败都会执行）

MapContextGetScaleResult 的属性值

名称	类型	必备	默认值	兼容性	描述
scale	number	是	-	Web Android iOS - 4.31 4.31	地图缩放级别

addGroundOverlay(options : MapContextAddGroundOverlayOptions) : void;

创建自定义图片图层，图片会随着地图缩放而缩放

addGroundOverlay 兼容性

Web	Android	iOS
-	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
options	MapContextAddGroundOverlayOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 id string 是 - Web Android iOS - 4.31 4.31 图片图层 id src string 是 - Web Android iOS - 4.31 4.31 图片路径，支持网络图片、临时路径、代码包路径 bounds Bounds 是 - Web Android iOS - 4.31 4.31 图片覆盖的经纬度范围 名称 类型 必备 默认值 兼容性 描述 southwest LocationObject 是 - Web Android iOS - 4.31 4.31 西南角的经纬度 northeast LocationObject 是 - Web Android iOS - 4.31 4.31 东北角的经纬度 visible boolean 否 false Web Android iOS - 4.31 4.31 是否可见 zIndex number 否 0 Web Android iOS - 4.31 4.31 图层绘制顺序 opacity number 否 1 Web Android iOS - 4.31 4.31 图层透明度 success (result: any) => void 否 null - 接口调用成功的回调函数 fail (result: MapContextFail) => void 否 null - 接口调用失败的回调函数 complete (result: any) => void 否 null - 接口调用结束的回调函数（调用成功、失败都会执行）

addMarkers(options : MapContextAddMarkersOptions) : void;

添加 marker

addMarkers 兼容性

Web	Android	iOS
-	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
options	MapContextAddMarkersOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 markers Array<Marker> 是 - Web Android iOS - 4.31 4.31 同传入 map 组件的 marker 属性 名称 类型 必备 默认值 兼容性 描述 id number 是 - Web Android iOS - 4.31 4.31 标记点id，marker点击事件回调会返回此id。建议为每个marker设置上Number类型id，保证更新marker时有更好的性能。最大限制9位数 latitude number 是 - Web Android iOS - 4.31 4.31 纬度，浮点数，范围 -90 ~ 90 longitude number 是 - Web Android iOS - 4.31 4.31 经度，浮点数，范围 -180 ~ 180 iconPath string 是 - Web Android iOS - 4.31 4.31 显示的图标，项目目录下的图片路径，支持相对路径写法，以'/'开头则表示相对小程序根目录；也支持临时路径 title string 否 null Web Android iOS - 4.31 4.31 标注点名，点击时显示，callout存在时将被忽略 rotate number 否 0 Web Android iOS - 4.31 4.31 旋转角度，顺时针旋转的角度，范围 0 ~ 360 alpha number 否 1 Web Android iOS - 4.31 4.31 标注的透明度，范围 0 ~ 1 width number 否 默认为图片实际宽度 Web Android iOS - 4.31 4.31 标注图标宽度 height number 否 默认为图片实际高度 Web Android iOS - 4.31 4.31 标注图标高度 ariaLabel string 否 null Web Android iOS - 4.31 4.31 无障碍访问，（属性）元素的额外描述 anchor Anchor 否 [0.5, 1] Web Android iOS - 4.31 4.31 经纬度在标注图标的锚点，默认底边中点 {x, y}，x表示横向(0-1)，y表示竖向(0-1)。{x: .5, y: 1} 表示底边中点 名称 类型 必备 默认值 兼容性 描述 x number 是 - - - y number 是 - - - callout MapMarkerCallout 否 - - 名称 类型 必备 默认值 兼容性 描述 content string 否 - - color string 否 - - fontSize number 否 - - borderRadius number 否 - - borderWidth number 否 - - borderColor string 否 - - bgColor string 否 - - padding number 否 - - display string 否 - - - 合法值 兼容性 描述 BYCLICK - - ALWAYS - - textAlign string 否 - - - 合法值 兼容性 描述 left - - center - - right - - anchorX number 否 - - anchorY number 否 - - label MapMarkerLabel 否 - - 名称 类型 必备 默认值 兼容性 描述 content string 否 - - color string 否 - - fontSize number 否 - - x number 否 - - y number 否 - - anchorX number 否 - - anchorY number 否 - - borderWidth number 否 - - borderColor string 否 - - borderRadius number 否 - - bgColor string 否 - - padding number 否 - - textAlign string 否 - - - 合法值 兼容性 描述 left - - center - - right - - ariaLabel string 否 - - clusterId number 否 - - customCallout MapMarkerCallout 否 - - joinCluster boolean 否 - - clear boolean 是 - Web Android iOS - 4.31 4.31 是否先清空地图上所有 marker success (result: any) => void 否 null - 接口调用成功的回调函数 fail (result: MapContextFail) => void 否 null - 接口调用失败的回调函数 complete (result: any) => void 否 null - 接口调用结束的回调函数（调用成功、失败都会执行）

moveAlong(options : MapContextMoveAlongOptions) : void;

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

moveAlong 兼容性

Web	Android	iOS
-	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
options	MapContextMoveAlongOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 markerId number 是 - Web Android iOS - 4.31 4.31 指定marker path Array<LocationObject> 是 - Web Android iOS - 4.31 4.31 移动路径的坐标串，坐标点格式 {longitude, latitude} duration number 否 1000 Web Android iOS - 4.31 4.31 平滑移动的时间 success (result: any) => void 否 null - 接口调用成功的回调函数 fail (result: MapContextFail) => void 否 null - 接口调用失败的回调函数 complete (result: any) => void 否 null - 接口调用结束的回调函数（调用成功、失败都会执行）

removeGroundOverlay(options : MapContextRemoveGroundOverlayOptions) : void;

移除自定义图片图层

removeGroundOverlay 兼容性

Web	Android	iOS
-	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
options	MapContextRemoveGroundOverlayOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 id string 是 - Web Android iOS - 4.31 4.31 图片图层 id success (result: any) => void 否 null - 接口调用成功的回调函数 fail (result: MapContextFail) => void 否 null - 接口调用失败的回调函数 complete (result: any) => void 否 null - 接口调用结束的回调函数（调用成功、失败都会执行）

removeMarkers(options : MapContextRemoveMarkersOptions) : void;

移除 marker

removeMarkers 兼容性

Web	Android	iOS
-	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
options	MapContextRemoveMarkersOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 markerIds Array<number> 是 - Web Android iOS - 4.31 4.31 要被删除的marker的id属性组成的数组 success (result: any) => void 否 null - 接口调用成功的回调函数 fail (result: MapContextFail) => void 否 null - 接口调用失败的回调函数 complete (result: any) => void 否 null - 接口调用结束的回调函数（调用成功、失败都会执行）

updateGroundOverlay(options : MapContextUpdateGroundOverlayOptions) : void;

更新自定义图片图层。

updateGroundOverlay 兼容性

Web	Android	iOS
-	4.31	4.31

参数

名称	类型	必填	默认值	兼容性	描述
options	MapContextUpdateGroundOverlayOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 id string 是 - Web Android iOS - 4.31 4.31 图片图层 id src string 是 - Web Android iOS - 4.31 4.31 图片路径，支持网络图片、临时路径、代码包路径 bounds Bounds 是 - Web Android iOS - 4.31 4.31 图片覆盖的经纬度范围 visible boolean 否 true Web Android iOS - 4.31 4.31 是否可见 zIndex number 否 0 Web Android iOS - 4.31 4.31 图层绘制顺序 opacity number 否 1 Web Android iOS - 4.31 4.31 图层透明度 success (result: any) => void 否 null - 接口调用成功的回调函数 fail (result: MapContextFail) => void 否 null - 接口调用失败的回调函数 complete (result: any) => void 否 null - 接口调用结束的回调函数（调用成功、失败都会执行）

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档