uni.createMapContext(mapId, component?)

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

参考：Map组件

createMapContext 兼容性 ^?

Web	微信小程序	支付宝小程序	Android	iOS	HarmonyOS
4.0	4.41	x	4.31	4.31	4.61

参数

名称	类型	必填	兼容性
mapId	string	是
component	ComponentPublicInstance	否

返回值

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

MapContext 的方法

getCenterLocation(options : MapContextGetCenterLocationOptions) : void;

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

getCenterLocation 兼容性 ^?

支付宝小程序	Android	iOS	HarmonyOS
x	4.31	4.31	4.61

参数

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

LocationObject 的属性值

名称	类型	必备	兼容性	描述
latitude	number	是		纬度，浮点数，范围为-90~90，负数表示南纬
longitude	number	是		经度，范围为-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;

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

moveToLocation 兼容性 ^?

支付宝小程序	Android	iOS	HarmonyOS
x	4.31	4.31	4.61

参数

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

MapContextFail 的属性值

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

translateMarker(options : MapContextTranslateMarkerOptions) : void;

translateMarker 平移marker，带动画

translateMarker 兼容性 ^?

支付宝小程序	Android	iOS	HarmonyOS
x	4.31	4.31	4.61

参数

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

MapContextFail 的属性值

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

includePoints(options : MapContextIncludePointsOptions) : void;

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

includePoints 兼容性 ^?

支付宝小程序	Android	iOS	HarmonyOS
x	4.31	4.31	4.61

参数

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

MapContextFail 的属性值

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

getRegion(options : MapContextGetRegionOptions) : void;

getRegion 获取当前地图的视野范围

getRegion 兼容性 ^?

支付宝小程序	Android	iOS	HarmonyOS
x	4.31	4.31	4.61

参数

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

MapContextGetRegionResult 的属性值

名称	类型	必备	兼容性	描述
southwest	LocationObject	是		西南角的经纬度
名称 类型 必备 兼容性 描述 latitude number 是 纬度，浮点数，范围为-90~90，负数表示南纬 longitude number 是 经度，范围为-180~180，负数表示西经
northeast	LocationObject	是		东北角的经纬度
名称 类型 必备 兼容性 描述 latitude number 是 纬度，浮点数，范围为-90~90，负数表示南纬 longitude number 是 经度，范围为-180~180，负数表示西经

MapContextFail 的属性值

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

getScale(options : MapContextGetScaleOptions) : void;

getScale 获取当前地图的缩放级别

getScale 兼容性 ^?

支付宝小程序	Android	iOS	HarmonyOS
x	4.31	4.31	4.61

参数

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

MapContextGetScaleResult 的属性值

名称	类型	必备	兼容性	描述
scale	number	是		地图缩放级别

MapContextFail 的属性值

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

addGroundOverlay(options : MapContextAddGroundOverlayOptions) : void;

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

addGroundOverlay 兼容性 ^?

支付宝小程序	Android	iOS	HarmonyOS
x	4.31	4.31	x

参数

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

MapContextFail 的属性值

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

addMarkers(options : MapContextAddMarkersOptions) : void;

addMarkers 添加 marker

addMarkers 兼容性 ^?

支付宝小程序	Android	iOS	HarmonyOS
x	4.31	4.31	4.61

参数

名称	类型	必填	兼容性
options	MapContextAddMarkersOptions	是
名称 类型 必备 默认值 兼容性 描述 markers Array<string> 是 同传入 map 组件的 marker 属性 clear boolean 是 是否先清空地图上所有 marker success (result: any) => void 否 null 接口调用成功的回调函数 fail (result: MapContextFail) => void 否 null 接口调用失败的回调函数 complete (result: any) => void 否 null 接口调用结束的回调函数（调用成功、失败都会执行）

MapContextFail 的属性值

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

moveAlong(options : MapContextMoveAlongOptions) : void;

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

moveAlong 兼容性 ^?

支付宝小程序	Android	iOS	HarmonyOS
x	4.31	4.31	4.61

参数

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

MapContextFail 的属性值

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

removeGroundOverlay(options : MapContextRemoveGroundOverlayOptions) : void;

removeGroundOverlay 移除自定义图片图层

removeGroundOverlay 兼容性 ^?

支付宝小程序	Android	iOS	HarmonyOS
x	4.31	4.31	x

参数

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

MapContextFail 的属性值

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

removeMarkers(options : MapContextRemoveMarkersOptions) : void;

removeMarkers 移除 marker

removeMarkers 兼容性 ^?

支付宝小程序	Android	iOS	HarmonyOS
x	4.31	4.31	4.61

参数

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

MapContextFail 的属性值

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

updateGroundOverlay(options : MapContextUpdateGroundOverlayOptions) : void;

updateGroundOverlay 更新自定义图片图层。

updateGroundOverlay 兼容性 ^?

支付宝小程序	Android	iOS	HarmonyOS
x	4.31	4.31	x

参数

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

MapContextFail 的属性值

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

MapContextGetCenterLocationOptions 的属性值

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

LocationObject 的属性值

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

MapContextFail 的属性值

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

MapContextMoveToLocationOptions 的属性值

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

MapContextFail 的属性值

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

MapContextTranslateMarkerOptions 的属性值

名称	类型	必备	默认值	兼容性	描述
markerId	number	是			指定marker
destination	LocationObject	是			指定marker移动到的目标点
名称 类型 必备 兼容性 描述 latitude number 是 纬度，浮点数，范围为-90~90，负数表示南纬 longitude number 是 经度，范围为-180~180，负数表示西经
autoRotate	boolean	否			移动过程中是否自动旋转marker
rotate	number	否	0		marker的旋转角度
moveWithRotate	boolean	否	false		平移和旋转同时进行
duration	number	否	1000		动画持续时长，平移与旋转分别计算
success	(result: any) => void	否	null		接口调用成功的回调函数
fail	(result: MapContextFail) => void	否	null		接口调用失败的回调函数
complete	(result: any) => void	否	null		接口调用结束的回调函数（调用成功、失败都会执行）

MapContextFail 的属性值

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

MapContextIncludePointsOptions 的属性值

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

MapContextFail 的属性值

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

MapContextGetRegionOptions 的属性值

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

MapContextGetRegionResult 的属性值

名称	类型	必备	兼容性	描述
southwest	LocationObject	是		西南角的经纬度
名称 类型 必备 兼容性 描述 latitude number 是 纬度，浮点数，范围为-90~90，负数表示南纬 longitude number 是 经度，范围为-180~180，负数表示西经
northeast	LocationObject	是		东北角的经纬度
名称 类型 必备 兼容性 描述 latitude number 是 纬度，浮点数，范围为-90~90，负数表示南纬 longitude number 是 经度，范围为-180~180，负数表示西经

MapContextFail 的属性值

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

MapContextGetScaleOptions 的属性值

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

MapContextGetScaleResult 的属性值

名称	类型	必备	兼容性	描述
scale	number	是		地图缩放级别

MapContextFail 的属性值

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

MapContextAddGroundOverlayOptions 的属性值

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

MapContextFail 的属性值

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

MapContextAddMarkersOptions 的属性值

名称	类型	必备	默认值	兼容性	描述
markers	Array<string>	是			同传入 map 组件的 marker 属性
clear	boolean	是			是否先清空地图上所有 marker
success	(result: any) => void	否	null		接口调用成功的回调函数
fail	(result: MapContextFail) => void	否	null		接口调用失败的回调函数
complete	(result: any) => void	否	null		接口调用结束的回调函数（调用成功、失败都会执行）

MapContextFail 的属性值

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

MapContextMoveAlongOptions 的属性值

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

MapContextFail 的属性值

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

MapContextRemoveGroundOverlayOptions 的属性值

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

MapContextFail 的属性值

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

MapContextRemoveMarkersOptions 的属性值

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

MapContextFail 的属性值

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

MapContextUpdateGroundOverlayOptions 的属性值

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

MapContextFail 的属性值

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

参见

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