目录

Interface (MassPointOverlay)

导入模块

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

MassPointOverlay

海量点的管理对象。在调用map.MapComponentController类的addMassPointOverlay方法时会返回该类型的实例。

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

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

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

示例：

let items: mapCommon.MassPointItem[] = [];
for (let i = 0; i < 1000; i++) {
  // 将海量点存入items
  items.push({
    // itemId为开发者自定义标识符
    itemId: 'test' + i,
    // 经纬度坐标
    position: {
      longitude: 118.11111 + Math.random() * 1 - 0.5,
      latitude: 32.11111 + Math.random() * 1 - 0.5
    },
    snippet: 'test' + i,
    title: 'test' + i
  })
}
let params: mapCommon.MassPointOverlayParams = {
  id: 'test',
  items: items,
  // 图标存放在resources/rawfile，icon参数传入rawfile文件夹下的相对路径
  icon: 'icon/maps_blue_dot.png'
}
let massPointOverlay = await this.mapController?.addMassPointOverlay(params);

[h2]getId

getId(): string

获取海量点的ID。

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

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

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

返回值：

类型 说明
string 海量点的ID。

示例：

let Id = massPointOverlay.getId();

[h2]setItems

setItems(items: mapCommon.MassPointItem[]): void

更新海量点列表。

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

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

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

参数：

参数名 类型 必填 说明
items mapCommon.MassPointItem[] 是 海量点列表（建议数据量小于100000条）。

示例：

let items: mapCommon.MassPointItem[] = [
  {
    itemId: '1',
    position: { latitude: 32.11111, longitude: 118.11111 }
  },
  {
    itemId: '2',
    position: { latitude: 32.22222, longitude: 118.22222 }
  }
];
massPointOverlay.setItems(items);

[h2]getItems

getItems(): mapCommon.MassPointItem[]

获取海量点列表。

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

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

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

返回值：

类型 说明
mapCommon.MassPointItem[] 海量点列表。

示例：

let MassPointItem: mapCommon.MassPointItem[] = this.massPointOverlay.getItems();

[h2]setAnchorU

setAnchorU(anchorU: number): void

更新图标锚点在水平方向上的位置。

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

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

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

参数：

参数名 类型 必填 说明
anchorU number 是 更新图标锚点在水平方向上的位置，取值范围：[0, 1]。

示例：

massPointOverlay.setAnchorU(0.6);

[h2]getAnchorU

getAnchorU(): number

获取图标锚点在水平方向上的位置。

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

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

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

返回值：

类型 说明
number 图标锚点在水平方向上的位置。

示例：

let AnchorU: number = this.massPointOverlay.getAnchorU();

[h2]setAnchorV

setAnchorV(anchorV: number): void

更新图标锚点在垂直方向上的位置。

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

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

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

参数：

参数名 类型 必填 说明
anchorV number 是 更新图标锚点在垂直方向上的位置，取值范围：[0, 1]。

示例：

massPointOverlay.setAnchorV(0.6);

[h2]getAnchorV

getAnchorV(): number

获取图标锚点在垂直方向上的位置。

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

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

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

返回值：

类型 说明
number 图标锚点在垂直方向上的位置。

示例：

let AnchorV: number = this.massPointOverlay.getAnchorV();

[h2]setVisible

setVisible(visible: boolean): void

设置海量点是否可见。

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

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

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

参数：

参数名 类型 必填 说明
visible boolean 是

海量点是否可见。

- true：可见。

- false：不可见。

示例：

massPointOverlay.setVisible(true);

[h2]isVisible

isVisible(): boolean

获取海量点是否可见。

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

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

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

返回值：

类型 说明
boolean

海量点是否可见。

- true：可见。

- false：不可见。

示例：

let isVisible: boolean = massPointOverlay.isVisible();

[h2]remove

remove(): void

删除海量点。

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

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

系统能力： SystemCapability.Map.Core

起始版本： 6.0.0(20)

示例：

massPointOverlay.remove();