文档管理中心

覆盖物

场景介绍

地图覆盖物是固定在地图上的图片,本章节将向您介绍如何为地图增加覆盖物。

覆盖物是一种显示在地图表面的图像图层,它不会遮挡地图上的文字和图标标注,这种图层类型允许图片随地图操作自动调整位置和大小。通过ImageOverlayParams类来设置,开发者可以通过ImageOverlayParams类设置一张图片,该图片可随地图的平移、缩放、旋转等操作做相应的变换。

接口说明

增加覆盖物功能主要由ImageOverlayParamsaddImageOverlayImageOverlay提供,更多接口及使用方法请参见接口文档

展开
接口名 描述
ImageOverlayParams 覆盖物参数。
addImageOverlay(params: mapCommon.ImageOverlayParams): Promise<ImageOverlay> 为地图增加覆盖物。
ImageOverlay 覆盖物,支持更新和查询相关属性。

开发步骤

  1. 导入相关模块。

    收起
    自动换行
    深色代码主题
    复制
    1. import { map, mapCommon, MapComponent } from '@kit.MapKit';
    2. import { AsyncCallback } from '@kit.BasicServicesKit';
  2. 增加覆盖物。

    收起
    自动换行
    深色代码主题
    复制
    1. @Entry
    2. @Component
    3. struct ImageOverlayDemo {
    4. private mapOptions?: mapCommon.MapOptions;
    5. private mapController?: map.MapComponentController;
    6. private callback?: AsyncCallback<map.MapComponentController>;
    7. private mapEventManager?: map.MapEventManager;
    8. aboutToAppear(): void {
    9. this.mapOptions = {
    10. position: {
    11. target: {
    12. latitude: 32.2,
    13. longitude: 118.2
    14. },
    15. zoom: 10
    16. }
    17. }
    18. this.callback = async (err, mapController) => {
    19. if (!err) {
    20. this.mapController = mapController;
    21. this.mapEventManager = this.mapController.getEventManager();
    22. let imageOverlayParams: mapCommon.ImageOverlayParams = {
    23. // 覆盖物范围
    24. bounds: {
    25. southwest: {
    26. latitude: 32,
    27. longitude: 118
    28. },
    29. northeast: {
    30. latitude: 32.4,
    31. longitude: 118.4
    32. }
    33. },
    34. // 覆盖物图片,图标需存放在resources/rawfile目录下
    35. image: 'icon/icon.png',
    36. transparency: 0.3,
    37. zIndex: 101,
    38. anchorU: 0.5,
    39. anchorV: 0.5,
    40. clickable: true,
    41. visible: true,
    42. bearing: 0
    43. };
    44. // 添加覆盖物
    45. try {
    46. let imageOverlay = await this.mapController?.addImageOverlay(imageOverlayParams);
    47. } catch (e) {
    48. console.error(`Failed to create the imageOverlay, code is:${e.code}, message is ${e.message}`);
    49. }
    50. } else {
    51. console.error(`Failed to initialize the map, code is:${err.code}, message is ${err.message}`);
    52. }
    53. }
    54. }
    55. build() {
    56. Stack() {
    57. Column() {
    58. MapComponent({
    59. mapOptions: this.mapOptions,
    60. mapCallback: this.callback,
    61. })
    62. .width('100%')
    63. .height('100%');
    64. }.width('100%')
    65. }.height('100%')
    66. }
    67. }
  3. 设置覆盖物点击监听事件。

    收起
    自动换行
    深色代码主题
    复制
    1. let imageOverlayCallback: Callback<map.ImageOverlay> = (imageOverlay: map.ImageOverlay) => {
    2. console.info("imageOverlay callback");
    3. }
    4. // 打开覆盖物的点击监听
    5. this.mapEventManager.on("imageOverlayClick", imageOverlayCallback);
    6. // 关闭覆盖物的点击监听
    7. this.mapEventManager.off("imageOverlayClick", imageOverlayCallback);
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词