mapCommon（地图属性模型）

导入模块

import { mapCommon } from '@kit.MapKit';

MapOptions

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

提供Map组件初始化的属性。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
mapType	MapType	否	是	地图类型，默认值为MapType.STANDARD，异常值按默认值处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
position	CameraPosition	否	否	地图相机位置。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
bounds	LatLngBounds	否	是	地图展示边界，默认值无边界，异常值按默认值处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。说明：西南角纬度不能大于东北角纬度。
minZoom	number	否	是	地图最小层级，有效范围：[2, 20]，默认值为2，异常值按默认值处理。如果设置的最小缩放级别小于2，minZoom会取2；如果设置的最小缩放层级大于20，minZoom会取20。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
maxZoom	number	否	是	地图最大层级，有效范围：[2, 20]，默认值为20，异常值按默认值处理。如果设置的最大缩放级别小于2，maxZoom会取2；如果设置的最大缩放层级大于20，maxZoom会取20。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
rotateGesturesEnabled	boolean	否	是	是否支持旋转手势，默认值为true，异常值按默认值处理。 - true：支持 - false：不支持元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
scrollGesturesEnabled	boolean	否	是	是否支持滑动手势，默认值为true，异常值按默认值处理。 - true：支持 - false：不支持元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
zoomGesturesEnabled	boolean	否	是	是否支持缩放手势，默认值为true，异常值按默认值处理。 - true：支持 - false：不支持元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
tiltGesturesEnabled	boolean	否	是	是否支持倾斜手势，默认值为true，异常值按默认值处理。 - true：支持 - false：不支持元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
zoomControlsEnabled	boolean	否	是	是否展示缩放控件，默认值为true，异常值按默认值处理。 - true：展示 - false：不展示元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
myLocationControlsEnabled	boolean	否	是	是否展示我的位置按钮，默认值为false，异常值按默认值处理。 - true：展示 - false：不展示元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
compassControlsEnabled	boolean	否	是	是否展示指南针控件，默认值为true，异常值按默认值处理。 - true：展示 - false：不展示元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
scaleControlsEnabled	boolean	否	是	是否展示比例尺，默认值为false，异常值按默认值处理。 - true：展示 - false：不展示元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
padding	Padding	否	是	设置地图和边界的距离，默认值为{ left: 0 , top: 0 , right: 0 , bottom: 0 }。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
styleId	string	否	是	自定义样式ID。ID不生效时，使用系统样式。使用方式详见显示自定义地图章节。起始版本： 5.0.0(12) 元服务API：从版本5.0.0(12)开始，该接口支持在元服务中使用。
dayNightMode	DayNightMode	否	是	日间夜间模式，默认值为DayNightMode.DAY（日间模式）。起始版本： 5.0.0(12) 元服务API：从版本5.0.0(12)开始，该接口支持在元服务中使用。
alwaysShowScaleEnabled	boolean	否	是	是否一直显示比例尺，只有比例尺启用时该参数才生效。启用比例尺可以由地图初始化时scaleControlsEnabled属性设置为true或者通过setScaleControlsEnabled方法设置为true。 - true：始终显示 - false：关闭始终显示默认是false。起始版本： 5.0.0(12) 元服务API：从版本5.0.0(12)开始，该接口支持在元服务中使用。
logoScale	number	否	是	Logo缩放比例，取值范围是[0.8, 1]，默认值是1，异常值按默认值处理。起始版本： 5.0.3(15) 元服务API：从版本5.0.3(15)开始，该接口支持在元服务中使用。
sphereEnabled	boolean	否	是	是否开启3D地球效果，默认值为false。 - true：开启3D地球效果 - false：关闭3D地球效果起始版本： 5.0.3(15) 元服务API：从版本5.0.3(15)开始，该接口支持在元服务中使用。
indoorMapEnabled	boolean	否	是	是否启用室内图，默认值为false。 - true：开启室内图 - false：关闭室内图起始版本： 5.1.1(19) 元服务API：从版本5.1.1(19)开始，该接口支持在元服务中使用。
scaleUnit	ScaleUnit	否	是	地图比例尺单位，默认值为ScaleUnit.METRIC_UNIT（公制单位）。起始版本： 5.1.1(19) 元服务API：从版本5.1.1(19)开始，该接口支持在元服务中使用。
language	string	否	是	地图语言。语种取值请参见地图组件支持语言列表。默认使用当前系统语言。起始版本： 6.0.0(20) 元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。
approveNumberEnabled	boolean	否	是	是否显示审图号并附带logo，只有路由地在中国才会显示。 - true：显示审图号 - false：隐藏审图号起始版本： 6.1.0(23) 元服务API：从版本6.1.0(23)开始，该接口支持在元服务中使用。

示例：

// 地图初始化参数
let mapOptions: mapCommon.MapOptions = {
  mapType: mapCommon.MapType.STANDARD,
  position: {
    target: {
      latitude: 39.9,
      longitude: 116.4
    },
    zoom: 10
  },
  bounds: {
    northeast: {
      latitude: 41.5,
      longitude: 125.5
    },
    southwest: {
      latitude: 37.5,
      longitude: 108.5
    }
  },
  maxZoom: 20,
  minZoom: 2,
  rotateGesturesEnabled: true,
  scrollGesturesEnabled: true,
  zoomGesturesEnabled: true,
  zoomControlsEnabled: true,
  myLocationControlsEnabled: false,
  dayNightMode: mapCommon.DayNightMode.NIGHT,
  scaleControlsEnabled: true,
  alwaysShowScaleEnabled: true,
  scaleUnit: mapCommon.ScaleUnit.METRIC_UNIT,
  language: 'zh-Hans',
  approveNumberEnabled: true
};

LatLng

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

经纬度对象。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
latitude	number	否	否	纬度，单位：度，取值范围：[-90, 90]。
longitude	number	否	否	经度，单位：度，取值范围：[-180, 180)。

示例：

let position: mapCommon.LatLng = {
  latitude: 39.9,
  longitude: 116.4
};

CameraPosition

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

相机状态，包括位置、倾斜角、缩放级别等信息。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
target	LatLng	否	否	地图中心位置的经纬度坐标。
zoom	number	否	否	屏幕中心附近的缩放级别，取值范围：[2, 20]，默认值为2。
tilt	number	否	是	相机与垂直于地球表面的线的夹角角度，单位：度，取值范围：[0, 75]，默认值为0。
bearing	number	否	是	地图旋转角度。以正北方向为0度、顺时针方向为正的角度，单位：度，默认值为0，取值范围：[0, 360)。超出取值范围的值会换算成取值范围内的值，比如361会被换算成1，-1换算为359。

示例：

let cameraPosition: mapCommon.CameraPosition = {
  target: {
    latitude: 39.9,
    longitude: 116.4
  },
  zoom: 10,
  tilt: 45,
  bearing: 90
};

LatLngBounds

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

经纬度划分的一个矩形区域。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
northeast	LatLng	否	否	东北角经纬度。
southwest	LatLng	否	否	西南角经纬度。

示例：

let bounds: mapCommon.LatLngBounds = {
  northeast: {
    latitude: 41.5,
    longitude: 125.5
  },
  southwest: {
    latitude: 37.5,
    longitude: 108.5
  }
};

PatternItem

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

圆、多边形或折线的边框样式。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
type	PatternItemType	否	否	边框样式类型。
length	number	否	是	边框样式类型为DASH或GAP时的边框长度，默认值为1，取值范围：大于等于0，单位：px。

示例：

let patternItem: mapCommon.PatternItem = {
  type: mapCommon.PatternItemType.DASH,
  length: 10
};

MyLocationStyle

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

自定义定位样式。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
anchorU	number	否	是	锚点横坐标方向的偏移量，建议取值[0, 1]，默认值为0.5。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
anchorV	number	否	是	锚点纵坐标方向的偏移量，建议取值[0, 1]，默认值为0.5。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
icon	string \| image.PixelMap \| Resource	否	是	定位图标。 - 图片格式支持jpg、jpeg、png、gif（只支持显示第一帧）、webp、svg。 - string类型入参支持两种格式： - 资源相对路径格式：图标存放在resources/rawfile，icon参数传入rawfile文件夹下的相对路径。 - toDataURL格式（如data:image/png;base64,<图片的Base64字节编码值>）。说明：从5.0.0(12)版本开始，icon属性支持image.PixelMap和Resource类型。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
radiusFillColor	number	否	是	定位图标填充色，默认值为0x8F7570FF（紫色），颜色值为ARGB格式。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
displayType	MyLocationDisplayType	否	是	定位图标的展示样式，默认值为MyLocationDisplayType.DEFAULT。起始版本： 5.0.0(12) 元服务API：从版本5.0.0(12)开始，该接口支持在元服务中使用。

示例：

let style: mapCommon.MyLocationStyle = {
  anchorU: 0.5,
  anchorV: 1,
  radiusFillColor: 0xffff0000,
  // 图标需存放在resources/rawfile目录下
  icon: 'test.png',
  displayType: mapCommon.MyLocationDisplayType.FOLLOW
};

Poi

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

地图上的POI对象。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
id	string	否	否	POI的标识。
name	string	否	否	POI的名称。
position	LatLng	否	否	POI的经纬度位置。

示例：

let poi: mapCommon.Poi = {
  id: "1001",
  name: "城东烧烤店",
  position: {
    latitude: 39.6,
    longitude: 116.4
  }
};

BaseOverlayOptions

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

定义覆盖物基本属性。MarkerOptions、MapCircleOptions、MapPolygonOptions、MapPolylineOptions、MapArcParams、ImageOverlayParams、BasePriorityOverlayParams等继承该基础类。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
visible	boolean	否	是	是否可见，默认值为true，异常值按默认值处理。 - true：可见 - false：不可见
zIndex	number	否	是	覆盖物的叠加顺序，具有较大z指数的覆盖物会绘制在具有较小z指数的覆盖物上，具有相同z指数的叠加顺序为元素添加的先后顺序。覆盖物初始化时如果未设置zIndex参数，默认值为0。异常值按默认值处理。说明： BasePriorityOverlayParams的zIndex向下取整数。

名称

类型

只读

可选

说明

visible

boolean

否

是

是否可见，默认值为true，异常值按默认值处理。

- true：可见

- false：不可见

zIndex

number

否

是

覆盖物的叠加顺序，具有较大z指数的覆盖物会绘制在具有较小z指数的覆盖物上，具有相同z指数的叠加顺序为元素添加的先后顺序。覆盖物初始化时如果未设置zIndex参数，默认值为0。异常值按默认值处理。

说明：

BasePriorityOverlayParams的zIndex向下取整数。

MarkerOptions

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

描述Marker属性，继承BaseOverlayOptions。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
position	LatLng	否	否	标记的位置坐标。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
rotation	number	否	是	标记的旋转角度，单位：度。以正北方向为0度、顺时针方向为正的角度，默认值为0，取值范围：[0, 360)。超出取值范围的值会换算成取值范围内的值，比如361会被换算成1，-1换算为359。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
icon	string \| image.PixelMap \| Resource	否	是	图标，不传时显示默认图标。 - 图片格式支持jpg、jpeg、png、gif（只支持显示第一帧）、webp、svg。 - string类型入参支持两种格式： - 资源相对路径格式：图标存放在resources/rawfile，icon参数传入rawfile文件夹下的相对路径。 - toDataURL格式（如data:image/png;base64,<图片的Base64字节编码值>）。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。说明：从5.0.0(12)版本开始，icon属性支持image.PixelMap和Resource类型。
alpha	number	否	是	透明度，取值范围[0, 1]，0代表完全透明，1表示完全不透明，默认值为1，异常值按默认值处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
anchorU	number	否	是	锚点的水平坐标，以图像宽度的比例，建议取值[0, 1]，默认值为0.5，异常值按默认值处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
anchorV	number	否	是	锚点的垂直坐标，以图像高度的比例，建议取值[0, 1]，默认值为1，异常值按默认值处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
clickable	boolean	否	是	标记是否可以点击，默认值为false，异常值按默认值处理。 - true：可点击 - false：不可点击元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
draggable	boolean	否	是	是否可以通过长按来拖拽，默认值为false，异常值按默认值处理。 - true：可拖拽 - false：不可拖拽元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
flat	boolean	否	是	是否平贴地图，默认值为false，异常值按默认值处理。 - true：可平贴 - false：不可平贴说明：开启3D地球且层级处于2~5层时不可平贴地图。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
title	string	否	是	信息窗口的标题，信息窗的最大宽度为136vp，超长字串超出部分用省略号“...”表示。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
snippet	string	否	是	信息窗口的子标题，信息窗的最大宽度为136vp，超长字串超出部分用省略号“...”表示。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
infoWindowAnchorU	number	否	是	指示标记信息窗口的锚点在水平方向上的位置。值范围：[0, 1]，默认值为0.5，异常值按默认值处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
infoWindowAnchorV	number	否	是	指示标记信息窗口的锚点在垂直方向上的位置。值范围：[0, 1]，默认值为0，异常值按默认值处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
altitude	number	否	是	相对于地面的高度，单位：m，默认值为0，异常值按默认值处理。起始版本： 5.0.0(12) 元服务API：从版本5.0.0(12)开始，该接口支持在元服务中使用。
collisionRule	CollisionRule	否	是	标记与地图POI之间的冲突处理规则，默认值为CollisionRule.NONE。异常值按照默认值处理。说明：从5.0.3(15)版本开始，collisionRule属性支持CollisionRule.NONE和CollisionRule.ALL类型；从6.1.0(23)版本开始，collisionRule属性新增支持CollisionRule.NAME和CollisionRule.ICON_CASCADE类型。起始版本： 5.0.3(15) 元服务API：从版本5.0.3(15)开始，该接口支持在元服务中使用。
annotations	Text[]	否	是	标记的注释，最小长度为1，最大长度为3。起始版本： 5.0.3(15) 元服务API：从版本5.0.3(15)开始，该接口支持在元服务中使用。
showIcon	boolean	否	是	是否显示标记的图标，默认值为true。根据显示的图标对异常值进行处理。 - true：显示标记的图标 - false：不显示标记的图标起始版本： 5.0.3(15) 元服务API：从版本5.0.3(15)开始，该接口支持在元服务中使用。
annotationPosition	TextPosition	否	是	注释相对于图标的位置，默认值为TextPosition.DEFAULT。起始版本： 5.0.3(15) 元服务API：从版本5.0.3(15)开始，该接口支持在元服务中使用。
iconBuilder	CustomBuilder	否	是	用于生成标记图标的自定义组件。自定义组件的优先级高于图标属性。起始版本： 6.0.0(20) 元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用
offsetX	number	否	是	标记图标沿X轴的偏移量，X轴向右是正方向，原点是图标的中心点，单位：px。若只设置了一个offsetX，offsetY默认设置为0，异常值不处理。若设置offsetX则偏移量以offsetX为准，若未设置offsetX则偏移量以anchorU为准。起始版本： 6.0.2(22) 元服务API：从版本6.0.2(22)开始，该接口支持在元服务中使用
offsetY	number	否	是	标记图标沿Y轴的偏移量，Y轴向下是正方向，原点是图标的中心点，单位：px。若只设置了一个offsetY，offsetX默认设置为0，异常值不处理。若设置offsetY则偏移量以offsetY为准，若未设置offsetY则偏移量以anchorV为准。起始版本： 6.0.2(22) 元服务API：从版本6.0.2(22)开始，该接口支持在元服务中使用
forceVisible	boolean	否	是	碰撞后是否强制显示，默认值为false，异常值按默认值处理。 - true：碰撞后仍能显示 - false：碰撞后不强制显示起始版本： 6.1.0(23) 元服务API：从版本6.1.0(23)开始，该接口支持在元服务中使用。
priority	number	否	是	两个标记（Marker）碰撞时优先级低的标记（Marker）被隐藏，碰撞优先级，数值越大，优先级越低。该值为整数，取值范围：[0, 65535]。当取值小于最小值时，按照取值范围的最小值处理；取值大于最大值时，按照取值范围的最大值处理。当不配置或取值为null、undefined，默认为2147483647，即碰撞优先级最低。起始版本： 6.1.0(23) 元服务API：从版本6.1.0(23)开始，该接口支持在元服务中使用。
minZoom	number	否	是	展示的最小地图层级，默认值为2。最小层级不大于最大层级，不小于2，异常值按默认值处理。如果设置的最小缩放级别小于2，minZoom会取2。起始版本： 6.1.0(23) 元服务API：从版本6.1.0(23)开始，该接口支持在元服务中使用。
maxZoom	number	否	是	展示的最大地图层级，默认值为20。最大层级不大于20，不小于最小层级，异常值按默认值处理。如果设置的最大缩放级别大于20，maxZoom会取20。起始版本： 6.1.0(23) 元服务API：从版本6.1.0(23)开始，该接口支持在元服务中使用。
annotationBackgroundColor	number	否	是	注释的背景颜色，颜色值为ARGB格式，默认值无背景色，异常值按默认值处理。起始版本： 6.1.1(24) 元服务API：从版本6.1.1(24)开始，该接口支持在元服务中使用。

示例：

let markerOptions: mapCommon.MarkerOptions = {
  position: {
    latitude: 39.9,
    longitude: 116.4
  },
  rotation: 0,
  visible: true,
  zIndex: 0,
  alpha: 1,
  anchorU: 0.5,
  anchorV: 1,
  clickable: true,
  draggable: true,
  flat: false,
  // 图标需存放在resources/rawfile目录下
  icon: 'test.png',
  altitude: 100,
  collisionRule: mapCommon.CollisionRule.ALL,
  offsetX: 20,
  offsetY: 20,
  forceVisible: true,
  priority: 5,
  minZoom: 5,
  maxZoom: 19,
  annotationBackgroundColor: 0XFF00FFFF
};

MapCircleOptions

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

描述MapCircle属性，继承BaseOverlayOptions。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
center	LatLng	否	否	圆的圆心，不能为空。圆的中心点纬度在[-85.051119, 85.051119]范围内才能画出圆。若圆中心点纬度为-85.051119或85.051119时，能画出半径为1米的圆。异常值不处理。
radius	number	否	否	圆的半径，单位：m，取值范围：大于等于0，默认值为0，异常值按默认值处理。
clickable	boolean	否	是	圆的可点击性，默认值为false，异常值按默认值处理。 - true：可点击 - false：不可点击
fillColor	number	否	是	圆的填充颜色，默认值为0x00000000（透明），颜色值为ARGB格式，异常值按默认值处理。
strokeColor	number	否	是	圆的边框颜色，默认值为0xff000000（黑色），颜色值为ARGB格式，异常值按默认值处理。
patterns	Array<PatternItem>	否	是	圆的边框样式，默认值为空数组，异常值按默认值处理。
strokeWidth	number	否	是	圆的边框宽度，单位：px，默认值为10，取值范围：大于等于0，异常值按默认值处理。

示例：

let mapCircleOptions: mapCommon.MapCircleOptions = {
  center: {
    latitude: 39.9,
    longitude: 116.4
  },
  radius: 5000,
  clickable: true,
  fillColor: 0XFF00FFFF,
  strokeColor: 0xFFFF0000,
  strokeWidth: 10,
  visible: true,
  zIndex: 15
};

MapPolygonOptions

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

描述MapPolygon属性，继承BaseOverlayOptions。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
points	Array<LatLng>	否	否	多边形的一组顶点，纬度取值范围：[-85.2, 85.2]，异常值不处理。
holes	Array<Array<LatLng>>	否	是	多边形的一组空心洞，默认值为空数组，异常值按默认值处理。说明：当空心洞的坐标贴合多边形边缘时，会导致渲染出现异常，渲染多余的空心区域。
clickable	boolean	否	是	多边形的可点击性，默认值为false，异常值按默认值处理。 - true：可点击 - false：不可点击
fillColor	number	否	是	多边形的填充颜色，默认值为0x00000000（透明），颜色值为ARGB格式，异常值按默认值处理。
geodesic	boolean	否	是	多边形的线段是否为大地曲线，默认值为false，异常值按默认值处理。 - true：大地曲线 - false：非大地曲线
strokeColor	number	否	是	多边形的边框颜色，默认值为0xff000000（黑色），颜色值为ARGB格式，异常值按默认值处理。
jointType	JointType	否	是	多边形线条的拐角样式，默认值为JointType.DEFAULT，异常值按默认值处理。
patterns	Array<PatternItem>	否	是	多边形的边框样式，默认值为空数组，异常值按默认值处理。
strokeWidth	number	否	是	多边形的边框宽度，单位：px，默认值为10，取值范围：大于等于0，异常值按默认值处理。

示例：

let polygonOptions: mapCommon.MapPolygonOptions = {
  points: [
    { latitude: 41.893478, longitude: 116.4 },
    { latitude: 41.893478, longitude: 121.4 },
    { latitude: 45.893478, longitude: 121.4 },
    { latitude: 45.893478, longitude: 116.4 }
  ],
  holes: [],
  clickable: true,
  fillColor: 0xff00DE00,
  geodesic: false,
  strokeColor: 0xff000000,
  jointType: mapCommon.JointType.DEFAULT,
  patterns: [],
  strokeWidth: 10,
  visible: true,
  zIndex: 0
};

MapPolylineOptions

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

描述MapPolyline属性，继承BaseOverlayOptions。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
points	Array<LatLng>	否	否	折线的一组顶点，异常值不处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
clickable	boolean	否	是	折线的可点击性，默认值为false，异常值按默认值处理。 - true：可点击 - false：不可点击元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
color	number	否	是	折线的颜色，默认值为0xff000000（黑色），颜色值为ARGB格式，异常值按默认值处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
colors	Array<number>	否	是	折线的多段颜色，默认值为空数组（黑色），颜色值为ARGB格式，异常值按默认值处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
startCap	CapStyle	否	是	折线的起始顶点的样式，默认值为CapStyle.BUTT，异常值按默认值处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
endCap	CapStyle	否	是	折线的结束顶点的样式，默认值为CapStyle.BUTT，异常值按默认值处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
geodesic	boolean	否	是	折线的线段是否为大地曲线，默认值为false，异常值按默认值处理。 - true：大地曲线 - false：非大地曲线元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
jointType	JointType	否	是	折线的线条拐角样式，默认值为JointType.DEFAULT，异常值按默认值处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
patterns	Array<PatternItem>	否	是	折线的样式，默认值为空数组，异常值按默认值处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
width	number	否	是	折线的宽度，单位：px，默认值为10，取值范围：[0, 512]，大于512按512处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
gradient	boolean	否	是	折线的渐变属性，默认值为false，异常值按默认值处理。 - true：可渐变 - false：不可渐变元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
customTexture	ResourceStr \| image.PixelMap	否	是	折线纹理。建议纹理使用没有背景色（透明色）的图片。起始版本： 5.0.0(12) 元服务API：从版本5.0.0(12)开始，该接口支持在元服务中使用。说明：从版本6.1.0(23)开始，新增调整纹理间距功能，可通过更换带有更宽透明背景的纹理图片，实现纹理间距调整。
isTextureMappingUsed	boolean	否	是	是否使用贴图的方式处理纹理，默认值为false。 - true：使用贴图的方式处理纹理 - false：不使用贴图的方式处理纹理起始版本： 5.0.3(15) 元服务API：从版本5.0.3(15)开始，该接口支持在元服务中使用。
customTextures	Array<ResourceStr \| image.PixelMap>	否	是	多个纹理图片。起始版本： 5.0.3(15) 元服务API：从版本5.0.3(15)开始，该接口支持在元服务中使用。说明：如果同时传入customTexture和customTextures，则呈现customTexture的效果。
customTextureIndexes	Array<number>	否	是	每个坐标对应的纹理索引。起始版本： 5.0.3(15) 元服务API：从版本5.0.3(15)开始，该接口支持在元服务中使用。说明：如果传入customTextures，则必须传入customTextureIndexes，同时customTextureIndexes的数组长度必须和points数组长度一致，customTextureIndexes每个元素取值必须在0到customTextures数组长度-1的范围内，如果不满足，返回错误码401。

示例：

let polylineOption: mapCommon.MapPolylineOptions = {
  points: [
    { latitude: 39.693478, longitude: 116.334595 },
    { latitude: 39.593478, longitude: 116.434595 },
    { latitude: 39.593478, longitude: 116.134595}
  ],
  clickable: true,
  color: 0xff000000,
  startCap: mapCommon.CapStyle.BUTT,
  endCap: mapCommon.CapStyle.BUTT,
  geodesic: false,
  jointType: mapCommon.JointType.DEFAULT,
  patterns: [{ type: 0, length: 100 }, { type: 0, length: 100 }, { type: 0, length: 100 }],
  visible: true,
  width: 20,
  zIndex: 0,
  gradient: false,
  // 图标需存放在resources/rawfile目录下
  customTexture: "icon/naviline_arrow.png",
  isTextureMappingUsed: false
};

BasePriorityOverlayParams

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

描述气泡、点注释等覆盖物的基础信息，继承BaseOverlayOptions。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
anchorU	number	否	是	POI的锚点在水平方向上的位置，值的范围为[0, 1]，默认值为0.5，异常值按默认值处理。
anchorV	number	否	是	POI的锚点在垂直方向上的位置，值的范围为[0, 1]，默认值为1，异常值按默认值处理。
forceVisible	boolean	否	是	POI的显示属性，默认值为false，异常值按默认值处理。 - true：碰撞后仍能显示 - false：碰撞后不可显示
priority	number	否	是	碰撞优先级，数值越大，优先级越低，取值范围大于0，默认值为Number.MAX_VALUE，异常值按默认值处理。
minZoom	number	否	是	展示的地图最小图层，有效范围：[2, 20]，默认值为2，异常值按默认值处理。如果设置的最小缩放级别小于2，minZoom会取2。约束条件：最小层级不大于最大层级，不小于2。
maxZoom	number	否	是	展示的地图最大图层，有效范围：[2, 20]，默认值为20，异常值按默认值处理。如果设置的最大缩放级别大于20，maxZoom会取20。约束条件：最大层级不大于20，不小于最小层级。

PointAnnotationParams

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

描述点注释属性，继承BasePriorityOverlayParams。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
position	LatLng	否	否	点注释图标锚点，异常值不处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
repeatable	boolean	否	是	点注释名称与地图POI名称相同时，是否支持去重，默认值为false，异常值按默认值处理。 - true：支持去重 - false：不支持去重元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。说明：碰撞规则为CollisionRule.NONE时，repeatable不支持设置。
collisionRule	CollisionRule	否	是	点注释的碰撞规则，默认值为CollisionRule.NAME，异常值按默认值处理。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。说明：设置碰撞规则为CollisionRule.ALL，需要同时设置覆盖物碰撞优先级priority属性。
titles	Array<Text>	否	否	点注释的标题，数组长度最小为1，最大为3。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
icon	string \| image.PixelMap \| Resource	否	是	点注释的图标，不传时使用默认图标。 - 图片格式支持jpg、jpeg、png、gif（只支持显示第一帧）、webp、svg。 - string类型入参支持两种格式： 1. 资源相对路径格式：图标存放在resources/rawfile，icon参数传入rawfile文件夹下的相对路径。 2. toDataURL格式（如data:image/png;base64,<图片的Base64字节编码值>）。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。说明：从5.0.0(12)版本开始，icon属性支持image.PixelMap和Resource类型。
showIcon	boolean	否	是	点注释是否展示图标。默认值为true。 - true：展示 - false：不展示元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
textPosition	TextPosition	否	是	设置点注释的文本位置。默认值为TextPosition.DEFAULT。起始版本： 5.0.0(12) 元服务API：从版本5.0.0(12)开始，该接口支持在元服务中使用。

示例：

let pointAnnotationOptions: mapCommon.PointAnnotationParams = {
  position: {
    latitude: 39.918,
    longitude: 116.397
  },
  repeatable: true,
  collisionRule: mapCommon.CollisionRule.NAME,
  titles: [{
    content: "Title1",
    color: 0xFF000000,
    fontSize: 15,
    strokeColor: 0xFFFFFFFF,
    strokeWidth: 2,
    fontStyle: mapCommon.FontStyle.ITALIC
  }],
  // 图标需存放在resources/rawfile目录下
  icon: "test.png",
  showIcon: true,
  anchorU: 0.5,
  anchorV: 1,
  forceVisible: false,
  priority: 3,
  minZoom: 2,
  maxZoom: 20,
  visible: true,
  zIndex: 10
};

BubbleParams

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

描述气泡属性，继承BasePriorityOverlayParams。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
positions	Array<Array<LatLng>>	否	否	气泡位置，系统基于多个位置段计算图标的适当位置，异常值不处理。
icons	Array<string \| image.PixelMap \| Resource>	否	否	气泡图标，异常值不处理。 - 必须提供4个方向的图标，传入的图标宽高需要相同。 - 图片格式支持jpg、jpeg、png、gif（只支持显示第一帧）、webp、svg。 - string类型入参支持两种格式： - 资源相对路径格式：图标存放在resources/rawfile，icon参数传入rawfile文件夹下的相对路径。 - toDataURL格式（如data:image/png;base64,<图片的Base64字节编码值>）。说明：从5.0.0(12)版本开始，icon属性支持image.PixelMap和Resource类型。

名称

类型

只读

可选

说明

positions

Array<Array<LatLng>>

否

气泡位置，系统基于多个位置段计算图标的适当位置，异常值不处理。

icons

Array<string | image.PixelMap | Resource>

否

气泡图标，异常值不处理。

- 必须提供4个方向的图标，传入的图标宽高需要相同。

- 图片格式支持jpg、jpeg、png、gif（只支持显示第一帧）、webp、svg。

- string类型入参支持两种格式：

- 资源相对路径格式：图标存放在resources/rawfile，icon参数传入rawfile文件夹下的相对路径。

- toDataURL格式（如data:image/png;base64,<图片的Base64字节编码值>）。

说明：

从5.0.0(12)版本开始，icon属性支持image.PixelMap和Resource类型。

示例：

let bubbleOptions: mapCommon.BubbleParams = {
  positions: [[{ latitude: 39.9, longitude: 116.4 }]],
  // 图片按照左上右下的顺序取值，图片需存放在resources/rawfile目录下
  icons: [
    'icon1.png',
    'icon2.png',
    'icon3.png',
    'icon4.png'
  ],
  forceVisible: true,
  priority: 3,
  minZoom: 2,
  maxZoom: 20,
  visible: true,
  zIndex: 1
};

Text

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

用于描述点注释标题的文本属性。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
content	string	否	否	标题内容，最大宽度为136vp，超长字串超出部分用省略号“...”表示。
color	number	否	是	标题字体颜色，默认值为0xFF000000（黑色），颜色值为ARGB格式。
fontSize	number	否	是	标题字体大小，默认值为15，单位：px。取值范围：[0,100]，超出范围按范围内最大值或最小值处理。
strokeColor	number	否	是	标题描边颜色，默认值为0xFFFFFFFF（白色），颜色值为ARGB格式。
strokeWidth	number	否	是	标题描边宽度，默认值为2，单位：px。取值范围：[0,10]，超出范围按范围内最大值或最小值处理。
fontStyle	FontStyle	否	是	标题字体样式，默认值为FontStyle.REGULAR，异常值按默认值处理。

示例：

let text: mapCommon.Text = {
  content: "南京夫子庙",
  color: 0xFF000000,
  fontSize: 15,
  strokeColor: 0xFFFFFFFF,
  strokeWidth: 2,
  fontStyle: mapCommon.FontStyle.ITALIC
};

Padding

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

设置地图和边界的距离的参数。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
left	number	否	是	在地图左侧增加的填充距离，单位：px，默认值为0，异常值按照默认值处理。
top	number	否	是	在地图顶部增加的填充距离，单位：px，默认值为0，异常值按照默认值处理。
right	number	否	是	在地图右侧增加的填充距离，单位：px，默认值为0，异常值按照默认值处理。
bottom	number	否	是	在地图底部增加的填充距离，单位：px，默认值为0，异常值按照默认值处理。

示例：

// 初始化参数，左边距0，底边距50
let padding: mapCommon.Padding = {
  left: 0,
  bottom: 50
};

VisibleRegion

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

VisibleRegion包含四个点，这四个点定义了地图相机的四边形可视区域。因为相机可能会倾斜，所以这个多边形也可以是梯形而不一定是矩形。如果相机正好位于可视区域中心上方，则形状为矩形，但如果相机倾斜，则形状将显示为最短边最接近视点的梯形。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
farLeft	LatLng	否	否	定义相机的左上角。
farRight	LatLng	否	否	定义相机的右上角。
bounds	LatLngBounds	否	否	定义的可视区域的最小边界框。
nearLeft	LatLng	否	否	定义相机的左下角。
nearRight	LatLng	否	否	定义相机的右下角。

示例：

// 示例中this.mapController来源参考指南显示地图示例代码
let projection: map.Projection = this.mapController?.getProjection();
let visibleRegion: mapCommon.VisibleRegion = projection.getVisibleRegion();

MapPoint

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

屏幕坐标点。屏幕左顶点为（0, 0）点，positionX正值代表可视区域向右移动，负值代表可视区域向左移动。positionY正值代表可视区域向下移动，负值代表可视区域向上移动。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	类型	只读	可选	说明
positionX	number	否	否	点的X坐标，单位：px。
positionY	number	否	否	点的Y坐标，单位：px。

示例：

let point: mapCommon.MapPoint = {
  positionX: 100,
  positionY: 100
};

CustomMapStyleOptions

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

自定义样式参数。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.0(12)

展开

名称	类型	只读	可选	说明
styleId	string	否	是	自定义样式ID。说明： styleId和styleContent同时传入，优先使用styleId。styleId可在Petal Maps Studio平台上创建。
styleContent	string	否	是	离线样式内容，内容格式参见样式参考。

名称

类型

只读

可选

说明

styleId

string

否

是

自定义样式ID。

说明：

styleId和styleContent同时传入，优先使用styleId。styleId可在Petal Maps Studio平台上创建。

styleContent

string

否

是

离线样式内容，内容格式参见样式参考。

示例：

// styleId需要替换为您自己的样式ID，样式ID可在Petal Maps Studio平台上创建
let param: mapCommon.CustomMapStyleOptions = {
  styleId: "xxxxxxx"
};

ClusterItem

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

待聚合节点。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.0(12)

展开

名称	类型	只读	可选	说明
position	LatLng	否	否	待聚合节点的坐标。

示例：

let clusterItem: mapCommon.ClusterItem = {
  position: {
    latitude: 39.99,
    longitude: 116.334595
  }
};

ClusterOverlayParams

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

聚合图层参数。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.0(12)

展开

名称	类型	只读	可选	说明
clusterItems	Array<ClusterItem>	否	否	待聚合节点数组。
distance	number	否	否	聚合节点聚合的距离，单位：vp。

接口提供以下方法，支持聚合项自定义图标。

展开

返回类型	方法
Promise<image.PixelMap>	getCustomIcon?(clusterItems: Array<ClusterItem>) 根据聚合项自定义图标，使用Promise异步回调。

返回类型

方法

Promise<image.PixelMap>

getCustomIcon?(clusterItems: Array<ClusterItem>)

根据聚合项自定义图标，使用Promise异步回调。

示例：

let clusterItem1: mapCommon.ClusterItem = {
  position: {
    latitude: 39.89,
    longitude: 116.335595
  }
};
let clusterItem2: mapCommon.ClusterItem = {
  position: {
    latitude: 39.99,
    longitude: 116.334595
  }
};
let array: Array<mapCommon.ClusterItem> = [
  clusterItem1,
  clusterItem2
];
let clusterOverlayParams: mapCommon.ClusterOverlayParams = { distance: 40, clusterItems: array };

getCustomIcon

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

getCustomIcon?(clusterItems: Array<ClusterItem>): Promise<image.PixelMap>

根据聚合项自定义图标。使用Promise异步回调。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.0(12)

展开

参数名	类型	必填	说明
clusterItems	Array<ClusterItem>	是	聚合节点数组。

返回值：

展开

类型	说明
Promise<image.PixelMap>	Promise对象，返回image.PixelMap。

示例：

// 实现mapCommon.ClusterOverlayParams中的getCustomIcon方法
import { mapCommon } from '@kit.MapKit';
import { image } from '@kit.ImageKit';

export class ClusterOverlayParamsMore implements mapCommon.ClusterOverlayParams {
  clusterItems: mapCommon.ClusterItem[] = new Array();
  private offCanvas: OffscreenCanvas = new OffscreenCanvas(62, 62);
  private settings: RenderingContextSettings = new RenderingContextSettings(true);

  constructor(clusterItems: mapCommon.ClusterItem[], distance: number) {
    this.clusterItems = clusterItems;
    this.distance = distance;
  }

  distance: number = 0;

  // 自定义聚合图标，例如将cluster的clusterItems的第一个clusterItem的经度作为文本，绘制圆形图标
  async getCustomIcon(clusterItems: mapCommon.ClusterItem[]): Promise<image.PixelMap> {
    let offContext = this.offCanvas.getContext("2d", this.settings);

    offContext.clearRect(0, 0, 62, 62);
    // 绘制圆形
    offContext.fillStyle = 0xff990000;
    offContext.beginPath();
    offContext.arc(31, 31, 30, 0, 6.28);
    offContext.stroke();
    offContext.fill();
    offContext.save();

    // 在圆形内绘制文本，文本信息为clusterItems的第一个聚合点的经度
    offContext.font = '20vp sans-serif';
    offContext.textAlign = 'center';
    offContext.textBaseline = 'middle';
    offContext.fillStyle = 0xffffffff;
    offContext.fillText(JSON.stringify(clusterItems[0].position.longitude).substring(0, 3), 31, 31);
    offContext.restore();
    let iconPixelMap = offContext.getPixelMap(0, 0, 62, 62);
    return iconPixelMap;
  }
}

ImageOverlayParams

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

覆盖物参数。继承BaseOverlayOptions。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.0(12)

展开

名称	类型	只读	可选	说明
bounds	LatLngBounds	否	是	设置基于矩形区域的覆盖物的位置。position和bounds是可选的，但是两个参数需要必填其中一个参数，当两者都入参时，bounds具有更高的优先级。position入参时，width为必填参数。
position	LatLng	否	是	设置覆盖物的位置。position和bounds是可选的，但是两个参数需要必填其中一个，当两者都入参时，bounds具有更高的优先级。position入参时，width为必填参数。
width	number	否	是	覆盖物的宽度，单位：m，仅当position有值时有效，width为正整数，默认值：0。
height	number	否	是	覆盖物的高度，单位：m，当position和width都有值时才有效，height为正整数，默认值：0。
anchorU	number	否	是	覆盖物的锚点在水平方向上的位置。取值范围：[0,1]。默认值为0.5。说明：当bounds有值时，设置anchorU会改变覆盖物的锚点在水平方向上的位置，不会改变bounds的范围。
anchorV	number	否	是	覆盖物的锚点在垂直方向上的位置。取值范围：[0,1]。默认值为0.5。说明：当bounds有值时，设置anchorV会改变覆盖物的锚点在垂直方向上的位置，不会改变bounds的范围。
bearing	number	否	是	覆盖物的旋转角度。以正北方向为0度、顺时针方向为正的角度，默认值为0，单位：度，取值范围：[0, 360)。超出取值范围的值会换算成取值范围内的值，比如361会被换算成1，-1换算为359。
clickable	boolean	否	是	覆盖物是否可单击。 - true：可点击。 - false：不可点击。默认值为false。
image	ResourceStr \| image.PixelMap	否	否	覆盖物的图像入参。图片格式支持jpg、jpeg、png、gif（只支持显示第一帧）、webp、svg。说明： ResourceStr为Resource和string两种格式，其中string类型入参支持两种格式： - 资源相对路径格式：图标存放在resources/rawfile，image参数传入rawfile文件夹下的相对路径。 - toDataURL格式（如data:image/png;base64,<图片的Base64字节编码值>）。
transparency	number	否	是	覆盖物的透明度。取值范围：[0, 1]。 0表示不透明，1表示全透明。默认值为0。

示例：

let imageOverlayParams: mapCommon.ImageOverlayParams = {
  bounds: { southwest: { latitude: 32, longitude: 118 }, northeast: { latitude: 32.4, longitude: 118.4 } },
  // 图标需存放在resources/rawfile目录下
  image: 'icon/icon.png',
  transparency: 0.3,
  zIndex: 101,
  anchorU: 0.5,
  anchorV: 0.5,
  clickable: true,
  visible: true,
  bearing: 90
};

BuildingOverlayParams

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

3D建筑参数。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.0(12)

展开

名称	类型	只读	可选	说明
points	Array<LatLng>	否	否	建筑底面坐标集合。最少三个坐标点，而且坐标点按顺时针方向连接可以形成完整的平面。
totalHeight	number	否	否	建筑距离地面的高度，单位：m。限制最大高度30000m。
floorBottomHeight	number	否	否	所选楼层底部到地面的高度，单位：m。
topFaceColor	number	否	是	建筑顶部的颜色，颜色值是ARGB格式。默认值为红色（0xffff0000）。
sideFaceColor	number	否	是	建筑侧面的颜色，颜色值是ARGB格式。默认值为红色（0xffff0000）。
floorColor	number	否	是	所选楼层的顶部颜色，颜色值为ARGB格式。默认值为红色（0xffff0000）。
showLevel	number	否	是	建筑开始显示的层级。取值范围：[2,20]，默认值为15，超出范围按默认值处理。
animationDuration	number	否	是	动画时长，单位：ms。取值需大于等于100ms，默认值为0，超出范围按默认值处理。
sideTexture	BuildingTexture	否	是	建筑的侧面纹理。
floorTexture	BuildingTexture	否	是	所选楼层的纹理。

示例：

let points: Array<mapCommon.LatLng> = [
  {
    latitude: 31.984794,
    longitude: 118.765865
  },
  {
    latitude: 31.98468,
    longitude: 118.766076
  },
  {
    latitude: 31.98472,
    longitude: 118.766116
  },
  {
    latitude: 31.98463,
    longitude: 118.766292
  },
  {
    latitude: 31.984586,
    longitude: 118.766251
  },
  {
    latitude: 31.984536,
    longitude: 118.766344
  },
  {
    latitude: 31.984633,
    longitude: 118.766446
  },
  {
    latitude: 31.9848,
    longitude: 118.766285
  },
  {
    latitude: 31.984925,
    longitude: 118.766312
  },
  {
    latitude: 31.985282,
    longitude: 118.766661
  },
  {
    latitude: 31.985438,
    longitude: 118.766419
  },
  {
    latitude: 31.985801,
    longitude: 118.766755
  },
  {
    latitude: 31.985856,
    longitude: 118.766504
  },
  {
    latitude: 31.985785,
    longitude: 118.766434
  },
  {
    latitude: 31.985821,
    longitude: 118.766278
  },
  {
    latitude: 31.985897,
    longitude: 118.766311
  },
  {
    latitude: 31.985944,
    longitude: 118.766095
  },
  {
    latitude: 31.985909,
    longitude: 118.766069
  },
  {
    latitude: 31.985794,
    longitude: 118.765989
  },
  {
    latitude: 31.9857,
    longitude: 118.766029
  },
  {
    latitude: 31.985658,
    longitude: 118.766164
  },
  {
    latitude: 31.985647,
    longitude: 118.766271
  },
  {
    latitude: 31.985574,
    longitude: 118.766297
  },
  {
    latitude: 31.985458,
    longitude: 118.766285
  },
  {
    latitude: 31.985271,
    longitude: 118.766002
  },
  {
    latitude: 31.985219,
    longitude: 118.766002
  },
  {
    latitude: 31.985135,
    longitude: 118.766029
  },
  {
    latitude: 31.985093,
    longitude: 118.766083
  },
  {
    latitude: 31.985019,
    longitude: 118.766109
  },
  {
    latitude: 31.984978,
    longitude: 118.766083
  },
  {
    latitude: 31.984794,
    longitude: 118.765865
  }
];
points.reverse();
// 3D建筑参数
let buildingOverlayOptions: mapCommon.BuildingOverlayParams =
  {
    // 3D建筑的范围参数（点为顺时针绘制）
    points: points,
    // 3D建筑的高度
    totalHeight: 51,
    // 3D建筑的选中楼层高度
    floorBottomHeight: 33,
    // 3D建筑的顶部颜色
    topFaceColor: 0xffa4b8f7,
    // 3D建筑的侧面颜色
    sideFaceColor: 0x44a4b8f7,
    // 3D建筑的选中楼层颜色
    floorColor: 0xff000000,
    // 3D建筑的展示层级
    showLevel: 14,
    // 3D建筑选中楼层从底部升起的动画时长
    animationDuration: 5000,
    // 3D建筑侧面的纹理
    sideTexture: { image: $r("app.media.side_tex"), height: 3, width: 3 },
    // 3D建筑选中楼层的纹理
    floorTexture: { image: $r("app.media.floor_tex"), height: 3, width: 3 }
  };

BuildingTexture

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

建筑纹理。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.0(12)

展开

名称	类型	只读	可选	说明
image	ResourceStr \| image.PixelMap	否	否	纹理图片。图片格式支持jpg、jpeg、png、gif（只支持显示第一帧）、webp、svg。说明： ResourceStr为Resource和string两种格式，其中string类型入参支持两种格式： - 资源相对路径格式：图标存放在resources/rawfile，image参数传入rawfile文件夹下的相对路径。 - toDataURL格式（如data:image/png;base64,<图片的Base64字节编码值>）。
width	number	否	是	纹理宽度，单位：m，取值大于等于0，默认值为3，异常值按默认值处理。
height	number	否	是	纹理高度，单位：m，取值大于等于0，默认值为3，异常值按默认值处理。

名称

类型

只读

可选

说明

image

ResourceStr | image.PixelMap

否

纹理图片。

图片格式支持jpg、jpeg、png、gif（只支持显示第一帧）、webp、svg。

说明：

ResourceStr为Resource和string两种格式，其中string类型入参支持两种格式：

- 资源相对路径格式：图标存放在resources/rawfile，image参数传入rawfile文件夹下的相对路径。

- toDataURL格式（如data:image/png;base64,<图片的Base64字节编码值>）。

width

number

否

是

纹理宽度，单位：m，取值大于等于0，默认值为3，异常值按默认值处理。

height

number

否

是

纹理高度，单位：m，取值大于等于0，默认值为3，异常值按默认值处理。

示例：

let buildingTexture: mapCommon.BuildingTexture = {
  image: $r("app.media.floor_tex"),
  height: 10,
  width: 10
};

TraceOverlayParams

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

动态轨迹的参数。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.0(12)

展开

名称	类型	只读	可选	说明
points	Array<LatLng>	否	否	跟踪点。 points个数上限为100000。
width	number	否	是	轨迹宽度，单位：px。默认值为10。取值范围：[0, 512]，大于512按512处理。
color	number	否	是	轨迹颜色，颜色值是ARGB格式。默认值为0xaaff0000。
isMapMoving	boolean	否	是	设置地图和轨迹是否一起移动。 - true：地图和轨迹一起移动 - false：仅轨迹移动默认值为false。
animationDuration	number	否	是	轨迹动画持续时间，单位为ms，最小值为100。默认值为5000。说明：当持续时间小于100ms时，时间将按默认值5000ms处理。
animationCallback	Callback<number>	否	是	监听轨迹的当前位置。返回点的索引。

示例：

// 示例中this.mapController来源参考指南显示地图示例代码
// marker1的参数
let markerOptions1: mapCommon.MarkerOptions = {
  position: {
    latitude: 31.99227173519985,
    longitude: 118.7622219990476
  },
  // 图标需存放在resources/base/media目录下
  icon: $r("app.media.track_setting_sport_map_marker_22"),
  anchorU: 0.5,
  anchorV: 1,
  visible: true
};
// 新增marker1
let markerBoy1 = await this.mapController.addMarker(markerOptions1);
let boyImages1: map.PlayImageAnimation = new map.PlayImageAnimation();
boyImages1.setDuration(1000);
let resourceArray: Array<Resource> = new Array();
resourceArray.push($r("app.media.side_0"));
resourceArray.push($r("app.media.side_1"));
resourceArray.push($r("app.media.side_2"));
resourceArray.push($r("app.media.side_3"));
resourceArray.push($r("app.media.side_4"));
resourceArray.push($r("app.media.side_5"));
resourceArray.push($r("app.media.side_6"));
resourceArray.push($r("app.media.side_7"));
resourceArray.push($r("app.media.side_8"));
resourceArray.push($r("app.media.side_9"));
resourceArray.push($r("app.media.side_10"));
resourceArray.push($r("app.media.side_11"));
resourceArray.push($r("app.media.side_12"));
resourceArray.push($r("app.media.side_13"));
resourceArray.push($r("app.media.side_14"));
resourceArray.push($r("app.media.side_15"));
resourceArray.push($r("app.media.side_16"));
resourceArray.push($r("app.media.side_17"));
resourceArray.push($r("app.media.side_18"));
resourceArray.push($r("app.media.side_19"));
resourceArray.push($r("app.media.side_20"));
await boyImages1.addImages(resourceArray);
boyImages1.setRepeatCount(-1);

// marker1添加动画
markerBoy1.setAnimation(boyImages1);
markerBoy1.startAnimation();

// marker2的参数
let markerOptions2: mapCommon.MarkerOptions = {
  position: {
    latitude: 31.99227173519985,
    longitude: 118.7622219990476
  },
  // 图标需存放在resources/base/media目录下
  icon: $r("app.media.track_setting_sport_map_marker_22"),
  anchorU: 0.5,
  anchorV: 1,
  visible: false
};
// 新增marker2
let markerBoy2 = await this.mapController.addMarker(markerOptions2);
let boyImages2: map.PlayImageAnimation = new map.PlayImageAnimation();
boyImages2.setDuration(1000);
let resourceArray2: Array<Resource> = new Array();
resourceArray2.push($r("app.media.behavior_front_cycling_boy_000"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_001"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_002"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_003"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_004"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_005"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_006"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_007"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_008"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_009"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_010"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_011"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_012"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_013"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_014"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_015"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_016"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_017"));
resourceArray2.push($r("app.media.behavior_front_cycling_boy_018"));
await boyImages2.addImages(resourceArray2);
boyImages2.setRepeatCount(-1);
// marker2添加动画
markerBoy2.setAnimation(boyImages2);
markerBoy2.startAnimation();

let points: Array<mapCommon.LatLng> = new Array();
points.push({ latitude: 31.99685233070878, longitude: 118.75846023442728 });
points.push({ latitude: 31.99671325810786, longitude: 118.75846738985165 });
points.push({ latitude: 31.99659191076709, longitude: 118.7585347621686 });
points.push({ latitude: 31.99648202537233, longitude: 118.7586266510386 });
points.push({ latitude: 31.99637707201552, longitude: 118.75872004590596 });
points.push({ latitude: 31.996278207010903, longitude: 118.75880449946251 });
points.push({ latitude: 31.996187481969695, longitude: 118.7588781960278 });
points.push({ latitude: 31.996092248919354, longitude: 118.75895330554488 });
points.push({ latitude: 31.995962740450565, longitude: 118.75904721407304 });
points.push({ latitude: 31.995792921394, longitude: 118.75916904998051 });
points.push({ latitude: 31.995601885713416, longitude: 118.7593235241019 });
points.push({ latitude: 31.995398221178277, longitude: 118.75949998588176 });
points.push({ latitude: 31.995185902197715, longitude: 118.7596871082939 });
points.push({ latitude: 31.994983473052656, longitude: 118.75987334062296 });
points.push({ latitude: 31.99482433699269, longitude: 118.76002095184032 });
points.push({ latitude: 31.994709073721708, longitude: 118.76012902920532 });
points.push({ latitude: 31.99460732100702, longitude: 118.76023892576234 });
points.push({ latitude: 31.99449284962087, longitude: 118.7603694232856 });
points.push({ latitude: 31.99435358179254, longitude: 118.76053622438056 });
points.push({ latitude: 31.99420771148339, longitude: 118.76072790126692 });
points.push({ latitude: 31.994075194901523, longitude: 118.7609100960977 });
points.push({ latitude: 31.993952686158877, longitude: 118.7610741329013 });
points.push({ latitude: 31.993840180644217, longitude: 118.7612193418965 });
points.push({ latitude: 31.993733787150244, longitude: 118.76135383115654 });
points.push({ latitude: 31.993617206525155, longitude: 118.76150529647698 });

// 动态轨迹的入参
let traceOptions: mapCommon.TraceOverlayParams = {
  // 轨迹点
  points: points,
  // 轨迹的动画时长
  animationDuration: 5000,
  // 相机是否跟随动画移动
  isMapMoving: true,
  // 轨迹的颜色
  color: 0xAAFFAA00,
  // 轨迹的宽度
  width: 20,
  // 轨迹的动画回调（回调轨迹点的index）
  animationCallback: (pointIndex) => {
    // 换成骑行
    if (pointIndex === 10) {
      markerBoy1.setVisible(false);
      markerBoy2.setVisible(true);
    }
  }
};
let markers: Array<map.Marker> = new Array();
markers.push(markerBoy1, markerBoy2);
// 新增轨迹点动画
let traceOverlay = await this.mapController.addTraceOverlay(traceOptions, markers);

MapArcParams

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

弧线的参数。继承BaseOverlayOptions。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.0(12)

展开

名称	类型	只读	可选	说明
startPoint	LatLng	否	否	起始位置。
centerPoint	LatLng	否	否	中心位置。
endPoint	LatLng	否	否	结束位置。
color	number	否	是	弧线的颜色，默认值为0xFFFFFFFF（白色），颜色值为ARGB格式，异常值按默认值处理。
width	number	否	是	弧线的宽度，默认值为10，单位：px，取值范围：大于等于0，异常值按默认值处理。

示例：

// 设置弧线参数
let mapArcParams: mapCommon.MapArcParams = {
  // 弧线起点坐标
  startPoint: {
    latitude: 39.913138,
    longitude: 116.415112
  },
  // 弧线终点坐标
  endPoint: {
    latitude: 28.239473,
    longitude: 112.954094
  },
  // 弧线中心点坐标
  centerPoint: {
    latitude: 33.86970399048567,
    longitude: 112.08633528544145
  },
  width: 10,
  color: 0xffff0000,
  visible: true,
  zIndex: 100
};

CoordinateLatLng

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

指定的坐标系和坐标。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.0(12)

展开

名称	类型	只读	可选	说明
coordinateType	CoordinateType	否	否	坐标系类型。
location	LatLng	否	否	坐标。

示例：

let location: mapCommon.CoordinateLatLng = {
  coordinateType: mapCommon.CoordinateType.GCJ02,
  location: { latitude: 31.984410259206815, longitude: 118.76625379397866 }
};

TileOverlayParams

Phone5.0.3(15)+PC/2in15.0.3(15)+Tablet5.0.3(15)+Wearable5.1.0(18)+

瓦片图层的参数。继承BaseOverlayOptions。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.3(15)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.3(15)

展开

名称	类型	只读	可选	说明
tileUrl	string	否	否	瓦片图层的URL地址。必须是以http或者https开头的URL且包含占位符{x}、{y}和{z}。
transparency	number	否	是	瓦片图层的透明度。取值范围为[0, 1]，0表示不透明，1表示透明。默认值为0。
fadeIn	boolean	否	是	是否开启瓦片图层淡入。 - true：开启瓦片图层淡入。 - false：不开启瓦片图层淡入。默认值为true。

名称

类型

只读

可选

说明

tileUrl

string

否

瓦片图层的URL地址。

必须是以http或者https开头的URL且包含占位符{x}、{y}和{z}。

transparency

number

否

是

瓦片图层的透明度。

取值范围为[0, 1]，0表示不透明，1表示透明。

默认值为0。

fadeIn

boolean

否

是

是否开启瓦片图层淡入。

- true：开启瓦片图层淡入。

- false：不开启瓦片图层淡入。

默认值为true。

示例：

let params: mapCommon.TileOverlayParams = {
  // 开发者的地图瓦片图层地址，必须使用以http或者https开头的URL地址，且需包含?x={x}&y={y}&z={z}格式的占位符
  tileUrl: "https://xxx/xxx?x={x}&y={y}&z={z}",
  transparency: 0,
  fadeIn: false
};

TileOverlayOptions

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+Wearable6.0.0(20)+

瓦片图层的参数。继承BaseOverlayOptions。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

展开

名称	类型	只读	可选	说明
tileUrl	string	否	是	瓦片图层的URL地址。必须是以http或者https开头的URL且包含占位符{x}、{y}和{z}。元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。
tileProvider	TileProvider	否	是	根据瓦片坐标获取瓦片。元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。
transparency	number	否	是	瓦片图层的透明度。取值范围为[0, 1]，0表示不透明，1表示透明。默认值为0。元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。
fadeIn	boolean	否	是	是否开启瓦片图层淡入。 - true：开启瓦片图层淡入。 - false：不开启瓦片图层淡入。默认值为true。元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。
diskCacheEnabled	boolean	否	是	是否启用磁盘缓存。 - true：开启磁盘缓存。 - false：不开启磁盘缓存。默认值为false。元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。
diskCacheSize	number	否	是	磁盘缓存大小，单位：KB，默认值：20480。元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。
diskCachePath	string	否	是	磁盘缓存路径。如果启用了磁盘缓存，则必须配置。元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。
tileDataReuse	number[]	否	是	该配置项用于定义高层级复用低层级瓦片的规则。默认情况下，不进行层级复用。配置数组的长度固定为19，对应层级2至层级20。若数组长度不等于19，则不进行处理。数组中的数字需逐步增大或保持不变，若出现其他情况则视为异常值。数组中的值应在范围[2, 20]内，并会自动向下取整。任何异常值不处理。起始版本： 6.1.1(24) 元服务API：从版本6.1.1(24)开始，该接口支持在元服务中使用。

示例：

let params: mapCommon.TileOverlayOptions = {
  // 开发者的地图瓦片图层地址，必须使用以http或者https开头的URL地址，且需包含?x={x}&y={y}&z={z}格式的占位符
  tileUrl: "https://xxx/xxx?x={x}&y={y}&z={z}",
  diskCacheEnabled: true,
  diskCacheSize: 20480,
  diskCachePath: '/data/storage/el2/database',
  // 高层级复用低层级瓦片的配置项
  tileDataReuse: [ 2, 3, 4, 5, 6, 6, 6, 6, 6, 6, 6, 6, 7, 7, 7, 7, 7, 7, 7 ]
};

HeatmapParams

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+Wearable6.0.0(20)+

热力图的参数。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本6.0.0(20)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

展开

名称	类型	只读	可选	说明
id	string	否	否	热力图ID。
data	WeightedLatLng[]	否	否	热力图数据（建议数据量小于10000条）。
color	Record<number, number>	否	是	热力图颜色，ARGB格式。取值范围：[0，1]，key是数据密度，value是ARGB格式的颜色。默认值：{ 0: 0x00026C39, 0.15: 0xAA138C4A, 0.3: 0xFF82CB67, 0.45: 0xFFE3F399, 0.6: 0xFFFEDE89, 0.75: 0xFFF67C4A, 0.9: 0xFFBE1827, 1: 0xFFA90426 } 如果某个记录的key取值范围或者value格式非法的话，移除这条记录，如果都不合法，就使用默认值。
intensity	number \| Record<number, number>	否	是	热力图强度，可以配置不同层级的强度，key表示层级，value表示按强度，如果是number类型，所有层级使用同一个强度。小于等于0按默认值1处理。
opacity	number \| Record<number, number>	否	是	热力图透明度。取值范围[0，1]，0表示不透明，1表示透明，小于0按照最小值0处理，大于1按照最大值1处理。如果是number类型，所有层级使用同一个透明度。默认值：0。
radius	number \| Record<number, number>	否	是	热力图半径，可以配置不同层级的半径，key表示层级，value表示按半径，如果是number类型，所有层级使用同一个半径，默认值10，默认单位：RadiusUnit.PIXEL_UNIT。
radiusUnit	RadiusUnit	否	是	半径单位。默认值：RadiusUnit.PIXEL_UNIT。
visible	boolean	否	是	热力图是否可见。默认值：true。 - true：可见。 - false：不可见。

RadiusUnit

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+Wearable6.0.0(20)+

半径单位。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本6.0.0(20)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

展开

名称	值	说明
PIXEL_UNIT	0	像素px。
METER_UNIT	1	米。

WeightedLatLng

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+Wearable6.0.0(20)+

加权经纬度。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本6.0.0(20)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

展开

名称	类型	只读	可选	说明
point	LatLng	否	否	经纬度。
intensity	number	否	是	强度的权重，取值范围：[0，+∞)，默认值：1，异常值按默认值处理。

TileProvider

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+Wearable6.0.0(20)+

type TileProvider = (x: number, y: number, z: number) => Promise<ArrayBuffer>

根据瓦片坐标获取瓦片。使用Promise异步回调。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本6.0.0(20)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

展开

名称	类型	必填	说明
x	number	是	X坐标。
y	number	是	Y坐标。
z	number	是	Z坐标。

返回值：

展开

类型	说明
Promise<ArrayBuffer>	Promise对象，返回瓦片字节。

MvtOverlayParams

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+

矢量图层的参数。继承BaseOverlayOptions。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core.EnhancedOverlay

起始版本： 6.0.0(20)

展开

名称	类型	只读	可选	说明
source	MvtSource	否	否	矢量图层的来源。元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。
layers	MvtLayer[]	否	否	样式数组，建议矢量图层少于2000层，确保矢量图层的流畅度。元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。
blurIntensity	number \| Record<number, number>	否	是	矢量图层的模糊度，不支持3D地球。模糊度范围：[0, 20]，小数向下取整，默认值为0，异常值按默认值处理。若传数字，表示所有缩放层级按同一模糊度处理。若传键值对，key为缩放层级，value为模糊度，有效层级范围：[2，20]，层级异常值大于20取20，小于2取2。例如：{ 5: 5, 10: 8, 18: 15}，2到4层级为0，默认不模糊，5到9层级模糊度为5，10到17层级模糊度为8，18到20层级模糊度为15。起始版本： 6.0.2(22) 元服务API：从版本6.0.2(22)开始，该接口支持在元服务中使用。

名称

类型

只读

可选

说明

source

MvtSource

否

矢量图层的来源。

元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。

layers

MvtLayer[]

否

样式数组，建议矢量图层少于2000层，确保矢量图层的流畅度。

元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。

blurIntensity

number | Record<number, number>

否

是

矢量图层的模糊度，不支持3D地球。

模糊度范围：[0, 20]，小数向下取整，默认值为0，异常值按默认值处理。

若传数字，表示所有缩放层级按同一模糊度处理。

若传键值对，key为缩放层级，value为模糊度，有效层级范围：[2，20]，层级异常值大于20取20，小于2取2。例如：{ 5: 5, 10: 8, 18: 15}，2到4层级为0，默认不模糊，5到9层级模糊度为5，10到17层级模糊度为8，18到20层级模糊度为15。

起始版本： 6.0.2(22)

元服务API： 从版本6.0.2(22)开始，该接口支持在元服务中使用。

MvtSource

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+

矢量图层的来源。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本6.0.0(20)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core.EnhancedOverlay

起始版本： 6.0.0(20)

展开

名称	类型	只读	可选	说明
tileUrl	string	否	是	矢量图层的数据下载URL模板。URL必须包含占位符{x}、{y}和{z}。说明：使用在线下载方式添加矢量图层时（即使用tileUrl方式），需要申请访问网络的权限：ohos.permission.INTERNET。
tileProvider	TileProvider	否	是	根据瓦片坐标获取瓦片。
minZoom	number	否	是	最小缩放层级，默认值：2，取值范围：[2, 20]，异常值按默认值处理。
maxZoom	number	否	是	最大缩放层级，默认值：20，取值范围：[2, 20]，异常值按默认值处理。

MvtLayer

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+

样式数组，用于配置样式。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本6.0.0(20)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core.EnhancedOverlay

起始版本： 6.0.0(20)

展开

名称	类型	只读	可选	说明
id	string	否	否	唯一标识，用于添加、更新或移除图层。
type	MvtLayerType	否	否	矢量图层类型。
sourceLayer	string	否	否	矢量图层数据中图层的名称。
paint	MvtPaint	否	是	用于配置几何体的渲染，如填充、描边等。

MvtPaint

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+

用于配置几何体的渲染，如填充、描边等。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本6.0.0(20)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core.EnhancedOverlay

起始版本： 6.0.0(20)

展开

名称	类型	只读	可选	说明
fillColor	number \| Expression	否	是	填充颜色，默认值：0x000000，异常值按默认值处理。支持： - 十六进制RGB格式。 - 从矢量图层数据的属性中读取。
fillOpacity	number \| Expression	否	是	填充不透明度，默认值：0，异常值按默认值处理。支持： - 取值范围为[0, 1]，0表示完全透明，1表示完全不透明。 - 从矢量图层数据的属性中读取。

名称

类型

只读

可选

说明

fillColor

number | Expression

否

是

填充颜色，默认值：0x000000，异常值按默认值处理。支持：

- 十六进制RGB格式。

- 从矢量图层数据的属性中读取。

fillOpacity

number | Expression

否

是

填充不透明度，默认值：0，异常值按默认值处理。支持：

- 取值范围为[0, 1]，0表示完全透明，1表示完全不透明。

- 从矢量图层数据的属性中读取。

MvtLayerType

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+

矢量图层类型。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本6.0.0(20)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core.EnhancedOverlay

起始版本： 6.0.0(20)

展开

名称	值	说明
FILL	'fill'	填充多边形。

Expression

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+

矢量图层叠加表达式。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本6.0.0(20)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core.EnhancedOverlay

起始版本： 6.0.0(20)

展开

名称	类型	只读	可选	说明
operator	Operator	否	否	操作符。
args	string \| string[] \| Expression[]	否	否	参数。说明： string[]和Expression[]类型为预留类型，将来使用。

名称

类型

只读

可选

说明

operator

Operator

否

操作符。

args

string | string[] | Expression[]

否

参数。

说明：

string[]和Expression[]类型为预留类型，将来使用。

Operator

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+

操作符。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本6.0.0(20)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core.EnhancedOverlay

起始版本： 6.0.0(20)

展开

名称	值	说明
GET	'get'	获取操作符。

FlowFieldOverlayParams

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+

流场图层的参数。继承BaseOverlayOptions。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本6.0.0(20)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core.EnhancedOverlay

起始版本： 6.0.0(20)

展开

名称	类型	只读	可选	说明
data	string	否	否	流场图层的数据，数据格式参见流场数据格式参考。
style	ParticleStyle	否	是	粒子样式。

ParticleStyle

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+

粒子样式。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本6.0.0(20)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core.EnhancedOverlay

起始版本： 6.0.0(20)

展开

名称	类型	只读	可选	说明
count	number	否	是	粒子数，默认值：2000，异常值按默认值处理，建议小于10000。
color	number	否	是	粒子颜色，ARGB格式，默认值：0xffff69b4，异常值按默认值处理。
maxSpeed	number	否	是	粒子最大速度，默认值：70，单位：m/s，建议小于255，异常值按默认值处理。
speedFactor	number	否	是	粒子速度因子，取值范围[0,1]，默认值：0.2，异常值按默认值处理。

MassPointItem

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+Wearable6.0.0(20)+

海量点项。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本6.0.0(20)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

展开

名称	类型	只读	可选	说明
itemId	string	否	否	项目的唯一标识符。
position	LatLng	否	否	项目的经纬度坐标。
title	string	否	是	标题。
snippet	string	否	是	点的内容。

MassPointOverlayParams

Phone6.0.0(20)+PC/2in16.0.0(20)+Tablet6.0.0(20)+Wearable6.0.0(20)+

海量点的参数。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本6.0.0(20)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

展开

名称	类型	只读	可选	说明
id	string	否	否	海量点的唯一标识。
items	MassPointItem[]	否	否	海量点列表（建议数据量小于100000条）。
icon	ResourceStr \| image.PixelMap	否	否	海量点的图标。
anchorU	number	否	是	图标锚点在水平方向上的位置，取值范围：[0, 1]，默认值：0.5。
anchorV	number	否	是	图标锚点在垂直方向上的位置，取值范围：[0, 1]，默认值：0.5。

LineText

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+Wearable26.0.0+

提供地图线段的文本。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 26.0.0

展开

名称	类型	只读	可选	说明
lineNames	string[]	否	否	分段行文本内容列表。
lineNameIndexes	number[]	否	否	用于在段中显示文本的段线范围。说明： - 每个值必须大于等于0。 - 值序列必须单调不递减。 - LineNameIndexes数组长度必须是lineNames数组长度的两倍。如果违反任何一个条件，则该参数将被视为无效参数。
nameOnRight	boolean	否	是	显示在行的哪一边的文本。 - true：右侧。 - false：左侧。默认值：true，异常值按默认值处理。
color	number	否	是	文字内容的颜色，颜色值采用ARGB格式，默认值：0xFF000000，异常值按默认值处理。
fontSize	number	否	是	文字内容的字体大小，默认值：15，单位：px，取值范围：[0, 100]，超出按边界值处理，null和undefined按默认值处理。
strokeColor	number	否	是	文本内容描边颜色，颜色值采用ARGB格式，默认值：0xFFFFFFFF，异常值按默认值处理。
fontStyle	FontStyle	否	是	文字内容的字体样式，默认值：FontStyle.REGULAR，异常值按默认值处理。

SphereParams

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+Wearable26.0.0+

3D地球的属性，包括启用晨昏线、城市灯光、动画持续时间、背景和覆盖物。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 26.0.0

展开

名称	类型	只读	可选	说明
sunLightEnabled	boolean	否	是	是否启用晨昏线。 - true：启用晨昏线。 - false：关闭晨昏线。默认值：true，异常值按默认值处理。说明：晨昏线是地球表面上太阳光照范围的分界线，将地球分为白天和黑夜两个区域。晨昏线在地球上的位置会随着地球自转和公转而不断变化。
cityLightEnabled	boolean	否	是	是否启用城市灯光，默认值：true，异常值按默认值处理。 - true：启用城市灯光。 - false：关闭城市灯光。
animateDuration	number	否	是	动画持续时间，单位ms，取值范围：不小于0，异常值按默认值处理。
backgroundImage	ResourceStr \| image.PixelMap	否	是	3D地球的背景。
coverageImage	ResourceStr \| image.PixelMap	否	是	3D地球的覆盖物。

MapSignalParams

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+Wearable26.0.0+

信号路线的属性，继承BaseOverlayOptions。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 26.0.0

展开

名称	类型	只读	可选	说明
signalId	string	否	否	信号路线ID，空值不处理。说明：成功添加信号路线后，Map Kit会在应用进程内存中缓存signalId。删除路线时，默认保留该缓存，以便在应用进程存活期间，可无需网络直接重新添加已缓存的信号路线。如果需要删除缓存的signalId，请调用removeSignalLineCache接口。
points	LatLng[]	否	是	信号路线的顶点，长度范围为[0, 10000]，路线长度小于200km，空值返回401。
colors	number[]	否	是	信号路线的颜色，长度必须为3。三段颜色依次对应弱、中、强信号，ARGB格式，默认值：[0xFFFC3C11, 0xFFFFDF42, 0xFF42B0FF]（红、黄、蓝），数组长度必须为3，异常值按照默认值处理。
width	number	否	是	信号路线的宽度，范围为[0, 512]，默认值：10，单位：px，传入值大于512按512处理，小于0按10处理，空值按默认值处理。
coordinateType	CoordinateType	否	是	表示坐标系类型，默认值CoordinateType.GCJ02，异常值按默认值处理。

MapType

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

地图类型。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	值	说明
STANDARD	0	标准地图，展示道路、建筑物以及河流等重要的自然特征。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
NONE	1	空地图，没有加载任何数据的地图。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
TERRAIN	2	地形图，在保留了行政区划边界、POI、楼块等地图要素的基础上，呈现完整清晰描绘地形走势的标准地图。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。说明： - 地图缩放层级在大于5且小于14的区间内才能看到地形图效果。 - 地形图在智能表设备上不显示效果。
SATELLITE	3	卫星图，显示卫星照片的地图，只支持中国。起始版本： 6.0.0(20) 元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。
HYBRID	4	混合地图，在显示卫星照片的同时也显示路网信息。起始版本： 6.0.0(20) 元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。

PatternItemType

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

描述圆、多边形或折线的边框样式类型。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	值	说明
DASH	0	表示折线、多边形或圆的边框中的短划线。
DOT	1	表示折线、多边形或圆的边框的点。
GAP	2	表示折线、多边形或圆中边框的间隙。

JointType

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

折线、多边形的拐角绘制样式。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	值	说明
DEFAULT	0	使用尖角连接路径段。
BEVEL	1	使用斜角连接路径段。
ROUND	2	使用圆角连接路径段。

LogoAlignment

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

地图Logo的对齐方式。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	值	说明
BOTTOM_START	0	将Logo放置在左下角位置。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
BOTTOM_END	1	将Logo放置在右下角位置。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
TOP_START	2	将Logo放置在左上角位置。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
TOP_END	3	将Logo放置在右上角位置。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
TOP_CENTER	4	将Logo放置在上方居中位置。起始版本： 5.1.1(19) 元服务API：从版本5.1.1(19)开始，该接口支持在元服务中使用。
BOTTOM_CENTER	5	将Logo放置在底部居中位置。起始版本： 5.1.1(19) 元服务API：从版本5.1.1(19)开始，该接口支持在元服务中使用。

CapStyle

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

用于自定义折线端点（起始顶点和末端顶点）样式。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	值	说明
BUTT	0	线的两端是平行线。
ROUND	1	在线的两端延长半圆。
SQUARE	2	在线的两端延伸一个矩形。

CollisionRule

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

地图POI之间的碰撞规则。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	值	说明
NONE	0	名称和图标都不参与碰撞。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
NAME	1	仅名称参与碰撞。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
ALL	2	图标和名称都参与碰撞。元服务API：从版本4.1.0(11)开始，该接口支持在元服务中使用。
ICON_CASCADE	3	图标碰撞规则。只有标记（Marker）支持此规则。起始版本： 6.1.0(23) 元服务API：从版本6.1.0(23)开始，该接口支持在元服务中使用。

FontStyle

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

点注释标题的字体样式。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	值	说明
REGULAR	0	regular（常规粗细）。
BOLD	1	bold（加粗）。
ITALIC	2	italic（斜体）。
BOLD_ITALIC	3	bold and italic（斜体加粗）。
MEDIUM	4	medium（中等粗细）。
MEDIUM_ITALIC	5	medium and italic（斜体，中等粗细）。

CoordinateType

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

坐标系类型。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本4.1.0(11)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 4.1.0(11)

展开

名称	值	说明
WGS84	0	WGS84坐标系。
GCJ02	1	GCJ02坐标系。

MyLocationDisplayType

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

定位图标的展示模式。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.0(12)

展开

名称	值	说明
DEFAULT	0	连续定位，相机不移动到我的位置，定位蓝点跟踪设备移动。元服务API：从版本5.0.0(12)开始，该接口支持在元服务中使用。
LOCATE	1	定位一次，且将相机移动到地图中心点。元服务API：从版本5.0.0(12)开始，该接口支持在元服务中使用。
FOLLOW	2	连续定位，且将相机移动到地图中心点，定位蓝点跟随设备移动。元服务API：从版本5.0.0(12)开始，该接口支持在元服务中使用。
FOLLOW_ROTATE	3	连续定位，且将相机移动到地图中心点，定位蓝点依照设备方向旋转，并且会跟随设备移动。元服务API：从版本5.0.0(12)开始，该接口支持在元服务中使用。说明：需要权限：ohos.permission.ACCELEROMETER。
TRACK_ROTATE	4	连续定位，位置图标会跟随设备的移动并根据设备方向旋转，但不会移动到地图中心。起始版本： 6.0.0(20) 元服务API：从版本6.0.0(20)开始，该接口支持在元服务中使用。说明：需要权限：ohos.permission.ACCELEROMETER。
MAP_ROTATE	5	持续获取定位，相机移动到地图的中心点。定位的蓝点会随着设备移动，地图也会根据设备的方向进行旋转。起始版本： 26.0.0 元服务API：从API版本26.0.0开始，该接口支持在元服务中使用。说明：需要权限：ohos.permission.ACCELEROMETER。
MAP_ROTATE_NO_CENTER	6	持续获取定位，相机不会移动到地图中心点。定位的蓝点会随着设备移动，地图也会根据设备的方向进行旋转。起始版本： 26.0.0 元服务API：从API版本26.0.0开始，该接口支持在元服务中使用。说明：需要权限：ohos.permission.ACCELEROMETER。

DayNightMode

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

地图日间夜间模式。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.0(12)

展开

名称	值	说明
DAY	0	日间模式。
NIGHT	1	夜间模式。
AUTO	2	自动模式，如果系统打开深色开关，显示夜间模式，否则显示日间模式。

ScaleUnit

Phone5.1.1(19)+PC/2in15.1.1(19)+Tablet5.1.1(19)+Wearable5.1.1(19)+

地图比例尺公英制单位。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.1.1(19)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.1.1(19)

展开

名称	值	说明
METRIC_UNIT	0	公制单位。
IMPERIAL_UNIT	1	英制单位。

TextPosition

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

设置点注释的文本位置。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.0(12)

展开

名称	值	说明
DEFAULT	0	默认模式。
TOP	1	文本显示在图标上方。
BOTTOM	2	文本显示在图标下方。
LEFT	3	文本显示在图标的左侧。
RIGHT	4	文本显示在图标的右侧。

MapElementType

Phone5.0.0(12)+PC/2in15.0.1(13)+Tablet5.0.0(12)+Wearable5.1.0(18)+

地图元素类型。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.0(12)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Map.Core

起始版本： 5.0.0(12)

展开

名称	值	说明
OVERLAY	1	覆盖物，包括MapCircle、MapPolygon、MapPolyline、MapArc、ImageOverlay、TraceOverlay。
POI	2	底图Poi。
CUSTOM_POI	3	支持碰撞的覆盖物，包括PointAnnotation、Bubble。
MARKER	4	包括Marker、ClusterOverlay。