場景介紹

本章節(jié)將向您介紹如何在地圖的指定位置添加點注釋以標識位置、商家、建筑等，并可以通過信息窗口展示詳細信息。

點注釋支持功能：

• 支持設置圖標、文字、碰撞規(guī)則等。
• 支持添加點擊事件。

PointAnnotation有默認風格，同時也支持自定義。由于內容豐富，以下只展示一些基礎功能的使用，詳細內容可分參見接口文檔。

接口說明

添加點注釋功能主要由PointAnnotationParams、addPointAnnotation和PointAnnotation提供，更多接口及使用方法請參見接口文檔。

接口名	描述
PointAnnotationParams	點注釋相關屬性。
addPointAnnotation(params:?mapCommon.PointAnnotationParams): Promise<PointAnnotation>	在地圖上添加點注釋。
PointAnnotation	點注釋，支持更新和查詢相關屬性。

開發(fā)步驟

添加點注釋

1. 導入相關模塊。

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

2. 添加點注釋，在Callback方法中創(chuàng)建初始化參數并新建點注釋。

   @Entry
   @Component
   struct PointAnnotationDemo {
   private mapOption?: mapCommon.MapOptions;
   private mapController?: map.MapComponentController;
   private callback?: AsyncCallback<map.MapComponentController>;
   private pointAnnotation?: map.PointAnnotation;
   aboutToAppear(): void {
   this.mapOption = {
   position: {
   target: {
   latitude: 32.020750,
   longitude: 118.788765
   },
   zoom: 14
   }
   };
   this.callback = async (err, mapController) => {
   if (!err) {
   this.mapController = mapController;
   let pointAnnotationOptions: mapCommon.PointAnnotationParams = {
   // 定義點注釋圖標錨點
   position: {
   latitude: 32.020750,
   longitude: 118.788765
   },
   // 定義點注釋名稱與地圖poi名稱相同時，是否支持去重
   repeatable: true,
   // 定義點注釋的碰撞規(guī)則
   collisionRule: mapCommon.CollisionRule.NAME,
   // 定義點注釋的標題，數組長度最小為1，最大為3
   titles: [{
   // 定義標題內容
   content: "南京夫子廟",
   // 定義標題字體顏色
   color: 0xFF000000,
   // 定義標題字體大小
   fontSize: 15,
   // 定義標題描邊顏色
   strokeColor: 0xFFFFFFFF,
   // 定義標題描邊寬度
   strokeWidth: 2,
   // 定義標題字體樣式
   fontStyle: mapCommon.FontStyle.ITALIC
   }
   ],
   // 定義點注釋的圖標，圖標存放在resources/rawfile
   icon: "",
   // 定義點注釋是否展示圖標
   showIcon: true,
   // 定義點注釋的錨點在水平方向上的位置
   anchorU: 0.5,
   // 定義點注釋的錨點在垂直方向上的位置
   anchorV: 1,
   // 定義點注釋的顯示屬性，為true時，在被碰撞后仍能顯示
   forceVisible: false,
   // 定義碰撞優(yōu)先級，數值越大，優(yōu)先級越低
   priority: 3,
   // 定義點注釋展示的最小層級
   minZoom: 2,
   // 定義點注釋展示的最大層級
   maxZoom: 22,
   // 定義點注釋是否可見
   visible: true,
   // 定義點注釋疊加層級屬性
   zIndex: 10
   }
   this.pointAnnotation = await this.mapController.addPointAnnotation(pointAnnotationOptions);
   }
   };
   }
   build() {
   Stack() {
   Column() {
   MapComponent({ mapOptions: this.mapOption, mapCallback: this.callback });
   }.width('100%')
   }.height('100%')
   }
   }

   

3. 在添加點注釋之后，修改已經設置的標記屬性。

   // 設置點注釋的顯示層級為3~14級
   this.pointAnnotation.setZoom(3,14);
   // 設置點注釋的碰撞優(yōu)先級為10
   this.pointAnnotation.setPriority(10);

設置監(jiān)聽點注釋點擊事件

this.mapController?.on("pointAnnotationClick", (pointAnnotation) => {
console.info("pointAnnotationClick", `on-PointAnnotationClick pointAnnotation = ${pointAnnotation.getId()}`);
});

點注釋動畫

PointAnnotation調用setAnimation(animation:?Animation)設置動畫。

PointAnnotation調用startAnimation啟動動畫。

let animation: map.ScaleAnimation = new map.ScaleAnimation(1, 3, 1, 3);
// 設置動畫單次的時長
animation.setDuration(3000);
// 設置動畫的開始監(jiān)聽
animation.on("start", () => {
console.info('start ScaleAnimation');
});
animation.on("end", () => {
console.info('end ScaleAnimation');
});
// 設置動畫執(zhí)行完成的狀態(tài)
animation.setFillMode(map.AnimationFillMode.BACKWARDS);
// 設置動畫重復的方式
animation.setRepeatMode(map.AnimationRepeatMode.REVERSE);
// 設置動畫插值器
animation.setInterpolator(Curve.Linear);
// 設置動畫的重復次數
animation.setRepeatCount(100);
this.pointAnnotation.setAnimation(animation);
this.pointAnnotation.startAnimation();

點注釋標題動畫

PointAnnotation調用setTitleAnimation(animation:FontSizeAnimation?)設置標題動畫。

PointAnnotation調用startTitleAnimation啟動標題動畫。

let animation: map.FontSizeAnimation = new map.FontSizeAnimation(15, 45);
// 設置動畫單次的時長
animation.setDuration(3000);
// 設置動畫的開始監(jiān)聽
animation.on("start", () => {
console.info('start FontSizeAnimation');
});
animation.on("end", () => {
console.info('end FontSizeAnimation');
});
// 設置動畫執(zhí)行完成的狀態(tài)
animation.setFillMode(map.AnimationFillMode.FORWARDS);
// 設置動畫重復的方式
animation.setRepeatMode(map.AnimationRepeatMode.REVERSE);
// 設置動畫插值器
animation.setInterpolator(Curve.Linear);
// 設置動畫的重復次數
animation.setRepeatCount(100);
this.pointAnnotation.setTitleAnimation(animation);
this.pointAnnotation.startTitleAnimation();