开发 HarmonyOS NEXT 地图SDK 开发指南 在地图上绘制 绘制图片图层

绘制图片图层 最后更新时间: 2026年05月26日

简介

定义在地图上绘制一个 Ground 覆盖物(一张图片以合适的大小贴在地图上的图片层)

  • 位置: 可以通过设置中心点或者图片区域来确定图片层的位置。
  • 图片: 覆盖物的贴图。
  • 角度: 图片从正北开始,顺时针方向旋转,中心点为锚点。
  • Z轴 : Z轴是控制地图覆盖物(overlay)之间的绘制层次的参数。这个参数能够控制Circles、Polygons、Polyline的绘制层次,但不会影响marker。Z轴数值越大的覆盖物(overlay)将会绘制在更上层。如果两个及两个以上覆盖物(overlay)的Z轴数值相同,则最后的绘制结果是随机的 。覆盖物(overlay)的默认为Z轴为0。
  • 可见:这个属性表示了覆盖物是否可以显示在地图上。默认为可见。

展示Ground覆盖物

第1步 设置覆盖物属性

let options: GroundOverlayOptions = new GroundOverlayOptions();

let texture = await BitmapDescriptorFactory.fromRawfilePath(globalContext, 'groundoverlay.png');

if (texture) {
  options.image(texture); // 设置图片
}
options.position(new LatLng(39.936713,116.386475), 1); // 根据位置和宽设置ground覆盖物
let southwest: LatLng = new LatLng(39.935029, 116.384377)
let northeast: LatLng = new LatLng(39.939577, 116.388331)
let bounds: LatLngBounds = new LatLngBounds(southwest, northeast)
options.positionFromBounds(bounds); // 根据矩形区域设置ground覆盖物的位置
options
  .anchor(0.5, 0.5) // 设置图片的对齐方式
  .setTransparency(0.7) // 设置ground覆盖物的透明度

第2步 添加覆盖物

// 添加一个groundOverlay
aMap.addGroundOverlay(options);

绘制Ground覆盖物常用方法

名称

说明

anchor(anchorU: number, anchorV: number)

设置图片的对齐方式

position(location: LatLng | undefined, width: number, height?: number)

根据位置和宽高设置ground覆盖物

positionFromBounds(paramLatLngBounds: LatLngBounds)

根据矩形区域设置ground覆盖物的位置

setBearing(bearing: number)

设置ground覆盖物从正北顺时针的角度

setZIndex(zIndex: number)

设置ground覆盖物的z轴指数

visible(visible: boolean)

设置ground覆盖物是否可见

setTransparency(transparency: number)

设置ground覆盖物的透明度

返回顶部 示例中心 常见问题 智能客服 公众号
二维码