探索 ArcGIS API for JavaScript 中的 basemap 地图标注285

在 ArcGIS API for JavaScript 中，basemap 地图标注是一种在底图上显示标识特定兴趣点或位置的文本或符号的方式。通过添加地图标注，您可以为用户提供有关地图上重要位置的额外信息和上下文，从而增强他们的地图体验。

创建地图标注

要在地图上创建地图标注，您可以使用 MapLabelLayer 类。该类允许您向地图添加文本和符号标注，并对它们的样式和位置进行控制。

创建 MapLabelLayer 的基本语法如下：```javascript
const mapLabelLayer = new MapLabelLayer({
map: map,
labels: {
source: labelsSource,
symbol: labelSymbol
}
});
```
* map：要将地图标注添加到的地图。
* ：包含地图标注数据的要素图层或要素服务。
* ：可用于在地图上绘制地图标注的符号。
要创建文本标注，您可以使用 TextSymbol 符号，该符号允许您设置文本内容、字体和颜色。而要创建符号标注，您可以使用 PictureMarkerSymbol 符号，该符号允许您加载图像或图标作为地图标注符号。

设置地图标注样式

设置地图标注样式涉及控制文本和符号的字体、颜色、大小和对齐方式。您可以使用 MapLabelLayer 类的 labelOptions 属性来设置这些选项。

以下代码演示如何设置地图标注的字体、大小和对齐方式：```javascript
= {
font: "12px Arial",
horizontalAlignment: "right",
verticalAlignment: "bottom"
};
```

控制地图标注位置

您可以使用 MapLabelLayer 类的 labelPlacement 属性来控制地图标注的位置。该属性允许您设置标注相对于其源要素放置的方式。

以下代码演示如何将地图标注放置在源要素的顶部：```javascript
= "above-right";
```

使用图层过滤

图层过滤允许您根据某些条件显示或隐藏地图标注。您可以使用 MapLabelLayer 类的 labelExpressionInfo 属性来设置图层过滤器。

以下代码演示如何过滤仅显示名为 "公园" 的要素的地图标注：```javascript
= {
expression: "Name = '公园'"
};
```

事件处理

您可以使用 MapLabelLayer 类的事件来处理与地图标注相关的事件。以下是最常用的事件：* label-add：触发的新地图标注添加时。
* label-remove：触发现有地图标注移除时。
* label-update：触发现有地图标注更新时。

以下代码演示如何处理 label-add 事件：```javascript
("label-add", function(event) {
("新地图标注已添加。");
});
```