tmui-cli 2.0.2 → 2.0.4

package/data/uniappx/api/create-map-context.md

@@ -0,0 +1,677 @@
+## uni.createMapContext(mapId, component?) @createmapcontext
+
+创建并返回 map 上下文 mapContext 对象
+
+参考：[Map组件](../component/map.md)
+
+### createMapContext 兼容性  
+| Web | 微信小程序 | Android | iOS | HarmonyOS |
+| :- | :- | :- | :- | :- |
+| 4.0 | 4.41 | 4.31 | 4.31 | 4.61 |
+
+### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| mapId | string | 是 |
+| component | ComponentPublicInstance | 否 |
+
+### 返回值 
+
+| 类型 | 描述 | 必备 |
+| :- | :- | :- |
+| [MapContext](#mapcontext-values) | map组件上下文对象 | 否 |
+
+#### MapContext 的方法 @mapcontext-values 
+
+#### getCenterLocation(options : MapContextGetCenterLocationOptions) : void; @getcenterlocation
+getCenterLocation
+获取当前地图中心的经纬度，返回的是 gcj02 坐标系，可以用于 uni.openLocation
+##### getCenterLocation 兼容性  
+| Android | iOS | HarmonyOS |
+| :- | :- | :- |
+| 4.31 | 4.31 | 4.61 |
+
+##### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **MapContextGetCenterLocationOptions** | 是 |
+| 名称 | 类型 | 必备 | 默认值 | 描述 |
+| :- | :- | :- | :- | :- |
+| success | (result: [LocationObject](#locationobject-values)) => void | 否 |  | 接口调用成功的回调函数 |
+| fail | (result: [MapContextFail](#mapcontextfail-values)) => void | 否 | null | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | null | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+###### LocationObject 的属性值 @locationobject-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| latitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 纬度，浮点数，范围为-90~90，负数表示南纬 |
+| longitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 经度，范围为-180~180，负数表示西经 |
+
+###### MapContextFail 的属性值 @mapcontextfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| 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
+moveToLocation
+将地图中心移动到当前定位点，需要配合map组件的show-location使用
+##### moveToLocation 兼容性  
+| Android | iOS | HarmonyOS |
+| :- | :- | :- |
+| 4.31 | 4.31 | 4.61 |
+
+##### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **MapContextMoveToLocationOptions** | 是 |
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| latitude | number | 否 | null | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 纬度，浮点数，范围为-90~90，负数表示南纬 |
+| longitude | number | 否 | null | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 经度，范围为-180~180，负数表示西经 |
+| success | (result: any) => void | 否 | null |   | 接口调用成功的回调函数 |
+| fail | (result: [MapContextFail](#mapcontextfail-values)) => void | 否 | null |   | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | null |   | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+###### MapContextFail 的属性值 @mapcontextfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| 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
+translateMarker
+平移marker，带动画
+##### translateMarker 兼容性  
+| Android | iOS | HarmonyOS |
+| :- | :- | :- |
+| 4.31 | 4.31 | 4.61 |
+
+##### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **MapContextTranslateMarkerOptions** | 是 |
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| markerId | number | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 指定marker |
+| destination | **LocationObject** | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 指定marker移动到的目标点 |
+@@| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+@@| :- | :- | :- |  :-: | :- |
+@@| latitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 纬度，浮点数，范围为-90~90，负数表示南纬 |
+@@| longitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 经度，范围为-180~180，负数表示西经 |
+| autoRotate | boolean | 否 |  | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 移动过程中是否自动旋转marker |
+| rotate | number | 否 | 0 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | marker的旋转角度 |
+| moveWithRotate | boolean | 否 | false | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 平移和旋转同时进行 |
+| duration | number | 否 | 1000 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 动画持续时长，平移与旋转分别计算 |
+| success | (result: any) => void | 否 | null |   | 接口调用成功的回调函数 |
+| fail | (result: [MapContextFail](#mapcontextfail-values)) => void | 否 | null |   | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | null |   | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+###### MapContextFail 的属性值 @mapcontextfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| 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
+缩放视野展示所有经纬度
+##### includePoints 兼容性  
+| Android | iOS | HarmonyOS |
+| :- | :- | :- |
+| 4.31 | 4.31 | 4.61 |
+
+##### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **MapContextIncludePointsOptions** | 是 |
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| points | Array<**LocationObject**> | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 要显示在可视区域内的坐标点列表，\[{latitude, longitude}\] |
+@@| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+@@| :- | :- | :- |  :-: | :- |
+@@| latitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 纬度，浮点数，范围为-90~90，负数表示南纬 |
+@@| longitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 经度，范围为-180~180，负数表示西经 |
+| success | (result: any) => void | 否 | null |   | 接口调用成功的回调函数 |
+| fail | (result: [MapContextFail](#mapcontextfail-values)) => void | 否 | null |   | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | null |   | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+###### MapContextFail 的属性值 @mapcontextfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| 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
+获取当前地图的视野范围
+##### getRegion 兼容性  
+| Android | iOS | HarmonyOS |
+| :- | :- | :- |
+| 4.31 | 4.31 | 4.61 |
+
+##### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **MapContextGetRegionOptions** | 是 |
+| 名称 | 类型 | 必备 | 默认值 | 描述 |
+| :- | :- | :- | :- | :- |
+| success | (result: [MapContextGetRegionResult](#mapcontextgetregionresult-values)) => void | 否 | null | 接口调用成功的回调函数 |
+| fail | (result: [MapContextFail](#mapcontextfail-values)) => void | 否 | null | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | null | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+###### MapContextGetRegionResult 的属性值 @mapcontextgetregionresult-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| southwest | **LocationObject** | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 西南角的经纬度 |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| latitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 纬度，浮点数，范围为-90~90，负数表示南纬 |
+| longitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 经度，范围为-180~180，负数表示西经 |
+| northeast | **LocationObject** | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 东北角的经纬度 |
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| latitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 纬度，浮点数，范围为-90~90，负数表示南纬 |
+| longitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 经度，范围为-180~180，负数表示西经 |
+
+###### MapContextFail 的属性值 @mapcontextfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| 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
+获取当前地图的缩放级别
+##### getScale 兼容性  
+| Android | iOS | HarmonyOS |
+| :- | :- | :- |
+| 4.31 | 4.31 | 4.61 |
+
+##### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **MapContextGetScaleOptions** | 是 |
+| 名称 | 类型 | 必备 | 默认值 | 描述 |
+| :- | :- | :- | :- | :- |
+| success | (result: [MapContextGetScaleResult](#mapcontextgetscaleresult-values)) => void | 否 | null | 接口调用成功的回调函数 |
+| fail | (result: [MapContextFail](#mapcontextfail-values)) => void | 否 | null | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | null | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+###### MapContextGetScaleResult 的属性值 @mapcontextgetscaleresult-values 
+
+| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+| :- | :- | :- |  :-: | :- |
+| scale | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 地图缩放级别 |
+
+###### MapContextFail 的属性值 @mapcontextfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| 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
+创建自定义图片图层，图片会随着地图缩放而缩放
+##### addGroundOverlay 兼容性  
+| Android | iOS | HarmonyOS |
+| :- | :- | :- |
+| 4.31 | 4.31 | x |
+
+##### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **MapContextAddGroundOverlayOptions** | 是 |
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| id | string | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 图片图层 id |
+| src | string | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 图片路径，支持网络图片、临时路径、代码包路径 |
+| bounds | **Bounds** | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 图片覆盖的经纬度范围 |
+@@| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+@@| :- | :- | :- |  :-: | :- |
+@@| southwest | **LocationObject** | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 西南角的经纬度 |
+@@@| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+@@@| :- | :- | :- |  :-: | :- |
+@@@| latitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 纬度，浮点数，范围为-90~90，负数表示南纬 |
+@@@| longitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 经度，范围为-180~180，负数表示西经 |
+@@| northeast | **LocationObject** | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 东北角的经纬度 |
+@@@| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+@@@| :- | :- | :- |  :-: | :- |
+@@@| latitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 纬度，浮点数，范围为-90~90，负数表示南纬 |
+@@@| longitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 经度，范围为-180~180，负数表示西经 |
+| visible | boolean | 否 | false | Android 4.31 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 是否可见 |
+| zIndex | number | 否 | 0 | Android 4.31 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 图层绘制顺序 |
+| opacity | number | 否 | 1 | Android 4.31 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 图层透明度 |
+| success | (result: any) => void | 否 | null |   | 接口调用成功的回调函数 |
+| fail | (result: [MapContextFail](#mapcontextfail-values)) => void | 否 | null |   | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | null |   | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+###### MapContextFail 的属性值 @mapcontextfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| 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
+addMarkers
+添加 marker
+##### addMarkers 兼容性  
+| Android | iOS | HarmonyOS |
+| :- | :- | :- |
+| 4.31 | 4.31 | 4.61 |
+
+##### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **MapContextAddMarkersOptions** | 是 |
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| markers | Array<**Marker**> | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 同传入 map 组件的 marker 属性 |
+@@| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+@@| :- | :- | :- | :- |  :-: | :- |
+@@| id | number | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 标记点id，marker点击事件回调会返回此id。建议为每个marker设置上Number类型id，保证更新marker时有更好的性能。最大限制9位数 |
+@@| latitude | number | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 纬度，浮点数，范围 -90 ~ 90 |
+@@| longitude | number | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 经度，浮点数，范围 -180 ~ 180 |
+@@| iconPath | string | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 显示的图标，项目目录下的图片路径，支持相对路径写法，以'/'开头则表示相对小程序根目录；也支持临时路径 |
+@@| title | string | 否 | null | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 标注点名，点击时显示，callout存在时将被忽略 |
+@@| rotate | number | 否 | 0 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 旋转角度，顺时针旋转的角度，范围 0 ~ 360 |
+@@| alpha | number | 否 | 1 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 标注的透明度，范围 0 ~ 1 |
+@@| width | number | 否 | 默认为图片实际宽度 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 标注图标宽度 |
+@@| height | number | 否 | 默认为图片实际高度 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 标注图标高度 |
+@@| ariaLabel | string | 否 | null | Android(VDOM) x / Android(Vapor) 5.21 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 无障碍访问，（属性）元素的额外描述 |
+@@| anchor | **Anchor** | 否 | \[0.5, 1\] | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 经纬度在标注图标的锚点，默认底边中点	{x, y}，x表示横向(0-1)，y表示竖向(0-1)。{x: .5, y: 1} 表示底边中点 |
+@@@| 名称 | 类型 | 必备 |
+@@@| :- | :- | :- |
+@@@| x | number | 是 |
+@@@| y | number | 是 |
+@@| callout | **MapMarkerCallout** | 否 | null | Android 4.51 / iOS 4.51 / HarmonyOS x（部分支持，见上） | 自定义标记点上方的气泡窗口 |
+@@@| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+@@@| :- | :- | :- | :- |  :-: | :- |
+@@@| content | string | 否 | "" | Android 4.51 / iOS 4.51（部分支持，见上） | 文本 |
+@@@| color | string.ColorString | 否 | "black" | Android 4.51 / iOS 4.51（部分支持，见上） | 文本颜色 |
+@@@| fontSize | number | 否 | null | Android 4.51 / iOS 4.51（部分支持，见上） | 文字大小 |
+@@@| borderRadius | number | 否 | 0 | Android 4.51 / iOS 4.51（部分支持，见上） | 边框圆角 |
+@@@| borderWidth | number | 否 | 0 | Android 4.51 / iOS 4.51（部分支持，见上） | 边框宽度 |
+@@@| borderColor | string.ColorString | 否 | "transparent" | Android 4.51 / iOS 4.51（部分支持，见上） | 边框颜色 |
+@@@| bgColor | string.ColorString | 否 | "#fff" | Android 4.51 / iOS 4.51（部分支持，见上） | 背景色 |
+@@@| padding | number | 否 | 0 | Android 4.51 / iOS 4.51（部分支持，见上） | 文本边缘留白 |
+@@@| display | string | 否 | "BYCLICK" | Android 4.51 / iOS 4.51（部分支持，见上） | 'BYCLICK':点击显示; 'ALWAYS':常显 |
+@@@@| 合法值 |
+@@@@| :- |
+@@@@| BYCLICK |
+@@@@| ALWAYS |
+@@@| textAlign | string | 否 | "left" | Android 4.51 / iOS 4.51（部分支持，见上） | 文本对齐方式。 |
+@@@@| 合法值 |
+@@@@| :- |
+@@@@| left |
+@@@@| center |
+@@@@| right |
+@@@| anchorX | number | 否 | 0.5 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 横向偏移量，向右为正数 |
+@@@| anchorY | number | 否 | 1 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 纵向偏移量，向下为正数 |
+@@| label | **MapMarkerLabel** | 否 | null | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS x（部分支持，见上） | 为标记点旁边增加标签 |
+@@@| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+@@@| :- | :- | :- |  :-: | :- |
+@@@| content | string | 否 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 文本 |
+@@@| color | string | 否 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 文本颜色 |
+@@@| fontSize | number | 否 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 文字大小 |
+@@@| x | number | 否 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | label的坐标，原点是 marker 对应的经纬度 |
+@@@| y | number | 否 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | label的坐标，原点是 marker 对应的经纬度 |
+@@@| anchorX | number | 否 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | label的坐标，原点是 marker 对应的经纬度 |
+@@@| anchorY | number | 否 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | label的坐标，原点是 marker 对应的经纬度 |
+@@@| borderWidth | number | 否 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 边框宽度 |
+@@@| borderColor | string | 否 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 边框颜色 |
+@@@| borderRadius | number | 否 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 边框圆角 |
+@@@| bgColor | string | 否 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 背景色 |
+@@@| padding | number | 否 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 文本边缘留白 |
+@@@| textAlign | string | 否 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 文本对齐方式。 |
+@@@@| 合法值 |
+@@@@| :- |
+@@@@| left |
+@@@@| center |
+@@@@| right |
+@@@| ariaLabel | string | 否 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 无障碍访问，（属性）元素的额外描述 |
+@@| clusterId | number | 否 | null | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS x（部分支持，见上） | 自定义点聚合簇效果时使用 |
+@@| customCallout | **MapMarkerCallout** | 否 | null | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS x（部分支持，见上） | 自定义气泡窗口 |
+@@@| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+@@@| :- | :- | :- | :- |  :-: | :- |
+@@@| content | string | 否 | "" | Android 4.51 / iOS 4.51（部分支持，见上） | 文本 |
+@@@| color | string.ColorString | 否 | "black" | Android 4.51 / iOS 4.51（部分支持，见上） | 文本颜色 |
+@@@| fontSize | number | 否 | null | Android 4.51 / iOS 4.51（部分支持，见上） | 文字大小 |
+@@@| borderRadius | number | 否 | 0 | Android 4.51 / iOS 4.51（部分支持，见上） | 边框圆角 |
+@@@| borderWidth | number | 否 | 0 | Android 4.51 / iOS 4.51（部分支持，见上） | 边框宽度 |
+@@@| borderColor | string.ColorString | 否 | "transparent" | Android 4.51 / iOS 4.51（部分支持，见上） | 边框颜色 |
+@@@| bgColor | string.ColorString | 否 | "#fff" | Android 4.51 / iOS 4.51（部分支持，见上） | 背景色 |
+@@@| padding | number | 否 | 0 | Android 4.51 / iOS 4.51（部分支持，见上） | 文本边缘留白 |
+@@@| display | string | 否 | "BYCLICK" | Android 4.51 / iOS 4.51（部分支持，见上） | 'BYCLICK':点击显示; 'ALWAYS':常显 |
+@@@@| 合法值 |
+@@@@| :- |
+@@@@| BYCLICK |
+@@@@| ALWAYS |
+@@@| textAlign | string | 否 | "left" | Android 4.51 / iOS 4.51（部分支持，见上） | 文本对齐方式。 |
+@@@@| 合法值 |
+@@@@| :- |
+@@@@| left |
+@@@@| center |
+@@@@| right |
+@@@| anchorX | number | 否 | 0.5 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 横向偏移量，向右为正数 |
+@@@| anchorY | number | 否 | 1 | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11（部分支持，见上） | 纵向偏移量，向下为正数 |
+@@| joinCluster | boolean | 否 | null | Android(VDOM) x / Android(Vapor) 5.21 / iOS(VDOM) x / iOS(Vapor) 5.11 / HarmonyOS x（部分支持，见上） | 是否参与点聚合 |
+| clear | boolean | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 是否先清空地图上所有 marker |
+| success | (result: any) => void | 否 | null |   | 接口调用成功的回调函数 |
+| fail | (result: [MapContextFail](#mapcontextfail-values)) => void | 否 | null |   | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | null |   | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+###### MapContextFail 的属性值 @mapcontextfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| 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
+moveAlong
+沿指定路径移动 marker，用于轨迹回放等场景。动画完成时触发回调事件，若动画进行中，对同一 marker 再次调用 moveAlong 方法，前一次的动画将被打断。
+##### moveAlong 兼容性  
+| Android | iOS | HarmonyOS |
+| :- | :- | :- |
+| 4.31 | 4.31 | 4.61 |
+
+##### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **MapContextMoveAlongOptions** | 是 |
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| markerId | number | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 指定marker |
+| path | Array<**LocationObject**> | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 移动路径的坐标串，坐标点格式 {longitude, latitude} |
+@@| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+@@| :- | :- | :- |  :-: | :- |
+@@| latitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 纬度，浮点数，范围为-90~90，负数表示南纬 |
+@@| longitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 经度，范围为-180~180，负数表示西经 |
+| duration | number | 否 | 1000 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 平滑移动的时间 |
+| success | (result: any) => void | 否 | null |   | 接口调用成功的回调函数 |
+| fail | (result: [MapContextFail](#mapcontextfail-values)) => void | 否 | null |   | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | null |   | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+###### MapContextFail 的属性值 @mapcontextfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| 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
+移除自定义图片图层
+##### removeGroundOverlay 兼容性  
+| Android | iOS | HarmonyOS |
+| :- | :- | :- |
+| 4.31 | 4.31 | x |
+
+##### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **MapContextRemoveGroundOverlayOptions** | 是 |
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| id | string | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 图片图层 id |
+| success | (result: any) => void | 否 | null |   | 接口调用成功的回调函数 |
+| fail | (result: [MapContextFail](#mapcontextfail-values)) => void | 否 | null |   | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | null |   | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+###### MapContextFail 的属性值 @mapcontextfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| 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
+removeMarkers
+移除 marker
+##### removeMarkers 兼容性  
+| Android | iOS | HarmonyOS |
+| :- | :- | :- |
+| 4.31 | 4.31 | 4.61 |
+
+##### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **MapContextRemoveMarkersOptions** | 是 |
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| markerIds | Array<number> | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 要被删除的marker的id属性组成的数组 |
+| success | (result: any) => void | 否 | null |   | 接口调用成功的回调函数 |
+| fail | (result: [MapContextFail](#mapcontextfail-values)) => void | 否 | null |   | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | null |   | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+###### MapContextFail 的属性值 @mapcontextfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| 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
+更新自定义图片图层。
+##### updateGroundOverlay 兼容性  
+| Android | iOS | HarmonyOS |
+| :- | :- | :- |
+| 4.31 | 4.31 | x |
+
+##### 参数 
+
+| 名称 | 类型 | 必填 |
+| :- | :- | :- |
+| options | **MapContextUpdateGroundOverlayOptions** | 是 |
+| 名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
+| :- | :- | :- | :- |  :-: | :- |
+| id | string | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 图片图层 id |
+| src | string | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 图片路径，支持网络图片、临时路径、代码包路径 |
+| bounds | **Bounds** | 是 |  | Android 4.31 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 图片覆盖的经纬度范围 |
+@@| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+@@| :- | :- | :- |  :-: | :- |
+@@| southwest | **LocationObject** | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 西南角的经纬度 |
+@@@| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+@@@| :- | :- | :- |  :-: | :- |
+@@@| latitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 纬度，浮点数，范围为-90~90，负数表示南纬 |
+@@@| longitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 经度，范围为-180~180，负数表示西经 |
+@@| northeast | **LocationObject** | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 东北角的经纬度 |
+@@@| 名称 | 类型 | 必备 | 兼容性 | 描述 |
+@@@| :- | :- | :- |  :-: | :- |
+@@@| latitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 纬度，浮点数，范围为-90~90，负数表示南纬 |
+@@@| longitude | number | 是 | Android 4.31 / iOS 4.31 / HarmonyOS 4.61（部分支持，见上） | 经度，范围为-180~180，负数表示西经 |
+| visible | boolean | 否 | true | Android 4.31 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 是否可见 |
+| zIndex | number | 否 | 0 | Android 4.31 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 图层绘制顺序 |
+| opacity | number | 否 | 1 | Android 4.31 / iOS 4.31 / HarmonyOS x（部分支持，见上） | 图层透明度 |
+| success | (result: any) => void | 否 | null |   | 接口调用成功的回调函数 |
+| fail | (result: [MapContextFail](#mapcontextfail-values)) => void | 否 | null |   | 接口调用失败的回调函数 |
+| complete | (result: any) => void | 否 | null |   | 接口调用结束的回调函数（调用成功、失败都会执行） | 
+
+###### MapContextFail 的属性值 @mapcontextfail-values 
+
+| 名称 | 类型 | 必备 | 描述 |
+| :- | :- | :- | :- |
+| errCode | number | 是 | 错误码 |
+| 合法值 | 描述 |
+| :- | :- |
+| 500001 | 获取当前地图中心的经纬度失败 |
+| 500002 | 未找到当前定位位置 |
+| 500003 | 未找到marker |
+| 500004 | 创建自定义图片图层失败 |
+| 500005 | 未找到自定义图层id |
+| 500006 | 网络图片加载失败 |
+| 500012 | 地图内部错误 |
+| errSubject | string | 是 | 统一错误主题（模块）名称 |
+| data | any | 否 | 错误信息中包含的数据 |
+| cause | Error | 否 | 源错误信息，可以包含多个错误，详见SourceError |
+| errMsg | string | 是 |  |
+
+### 参见
+- [相关 Bug](https://issues.dcloud.net.cn/?mid=api.component.createMapContext)
+- [参见uni-app相关文档](https://uniapp.dcloud.net.cn/api/location/map.html#createmapcontext)
+- [微信小程序文档](https://developers.weixin.qq.com/miniprogram/dev/api/media/map/MapContext.html)
+- [支付宝小程序文档](https://open.alipay.com/portal/zhichi/search?keyword=createMapContext&pageIndex=1&pageSize=10&source=doc_top&type=all)
+- [百度小程序文档](https://smartprogram.baidu.com/forum/search?query=createMapContext&scope=devdocs&source=docs)
+- [抖音小程序文档](https://developer.open-douyin.com/search-page?keyword=createMapContext&secondType=all&type=1)
+- [飞书小程序文档](https://open.feishu.cn/search?from=header&page=1&pageSize=10&q=createMapContext&topicFilter=)
+- [钉钉小程序文档](https://open.dingtalk.com/search?keyword=createMapContext)
+- [QQ小程序文档](https://q.qq.com/wiki/develop/miniprogram/frame/)
+- [快手小程序文档](https://developers.kuaishou.com/page?keyword=createMapContext&from=docs)
+- [京东小程序文档](https://mp-docs.jd.com/doc/dev/framework/-1)
+- [华为快应用文档](https://developer.huawei.com/consumer/cn/doc/quickApp-References/webview-frame-overview-0000001124793625)
+- [360小程序文档](https://mp.360.cn/doc/miniprogram/dev/#/b770a184ff1f06c6b3393a0fd1132380)