标注

概览

API 中的许多类都支持标注功能。但是，根据图层类型、几何类型以及是在 2D 还是 3D 模式下工作，可以使用不同的属性和资源。

SceneView

所有具有 labelingInfo 属性的图层类型 (例如 FeatureLayer) 均支持标注。此属性被指定为 LabelClass 对象数组，其中包含 labelExpressionInfo、labelPlacement 和 TextSymbol3DLayer。TextSymbol3DLayer 类支持更改标注图形的 material、font、halo 和其他属性。点、折线和面均支持标注。

已知限制 (SceneView)

目前，一个要素只能有一个标注。如果要素满足多个 LabelClasses 的 where 条件，则仅显示第一个匹配 LabelClass 所对应的标注。
标注放置仅适用于点图层。
如果设置了 TextSymbol3DLayer.size 属性，它将覆盖 Font.size 属性。

SceneView 的字体

3D SceneViews 支持的字体系列取决于安装在用户计算机和 Web 浏览器上的字体。如果应用程序使用了未安装的字体，则 Font 类将实现一个回退机制，该机制将使用默认字体系列值，即 sans-serif。有关如何在 Windows 或 Mac 上安装新字体的说明，请参阅这些参考资料。

本地未安装的字体也可通过在 css 文件中定义 @font-face 来从 url 加载。

代码块使用深色复制
@font-face {
   font-family: "MyFont";
   font-style: normal;
   font-weight: 400;
   font-display: auto;
   src: url("./my-font.ttf") format("truetype");
} 

并从符号图层的 Font.family 属性中引用它：

代码块使用深色复制
const labelSymbol = {
  type: "label-3d",
  symbolLayers: [
    {
      type: "text",
      material: {
        color: [0, 0, 0, 0.8]
      },
      font: {
        size: 30,
        family: "MyFont"
      }
    }
  ],
} 

MapView

FeatureLayer、CSVLayer 和 StreamLayer

在 2D MapViews 中，FeatureLayer、CSVLayer、StreamLayer、OGCFeatureLayer 和 Sublayer 均支持标注。labelingInfo 属性被指定为 LabelClass 对象数组，其中包含 labelExpressionInfo、labelPlacement 和 TextSymbol。TextSymbol 类支持更改标注图形的 color、font、halo 和其他属性。点、折线和面均支持标注。

示例：多行标注

已知限制 (MapView)

对 Font.family、Font.style 和 Font.weight 属性的支持基于 .pbf 格式的托管字体文件。默认情况下，可从以下地址获取字体：https://doc.geoscene.cn/resources/fonts。可通过设置 geosceneConfig.fontsUrl 属性来配置 URL。请参阅以下可用的字体系列。

FeatureLayer、CSVLayer 和 StreamLayer 的字体

对 Font.family、Font.style 和 Font.weight 属性的支持基于 .pbf 格式的托管字体文件。默认情况下，可用字体大多与 GeoScene 矢量底图使用的字体相同。这些字体可通过 https://doc.geoscene.cn/resources/fonts 获得。通过设置 geosceneConfig.fontsUrl 属性，可以将 URL 配置为指向您自己的字体资源。

如果 Font 不可用，则将使用默认字体系列，即 sans-serif。这使用 Arial Unicode MS 字体文件。

具有 bold、italic 或两者的字体需要在 Font.style 和 Font.weight 属性中设置这些属性，而不是在 Font.family 中进行设置。要查看字体所支持的字符类型 (例如 Latin、Cyrillic、CJKV)，可在 Microsoft Typography 或 Google Fonts 中搜索字体名称。

注意，这些字体也适用于 TextSymbol，无论是将其用作 2D MapView 中的图形还是用作标注。

2D MapView 中当前支持的字体列表：

字体	预览	代码
Abril Fatface Regular		复制
Alegreya Bold		复制
Alegreya Bold Italic		复制
Alegreya Italic		复制
Alegreya Regular		复制
Alegreya SC Bold		复制
Alegreya SC Italic		复制
Alegreya SC Regular		复制
Alegreya Sans Italic		复制
Amarante Regular		复制
Amatic SC Bold		复制
Arial Bold		复制
Arial Bold Italic		复制
Arial Italic		复制
Arial Regular		复制
Arial Unicode MS Bold		复制
Arial Unicode MS Regular		复制
Atomic Age Regular		复制
Audiowide Regular		复制
Avenir Next LT Pro Bold		复制
Avenir Next LT Pro Bold Italic		复制
Avenir Next LT Pro Demi Italic		复制
Avenir Next LT Pro Italic		复制
Avenir Next LT Pro Light		复制
Avenir Next LT Pro Light Italic		复制
Avenir Next LT Pro Medium		复制
Avenir Next LT Pro Medium Bold		复制
Avenir Next LT Pro Medium Bold Italic		复制
Avenir Next LT Pro Medium Italic		复制
Avenir Next LT Pro Regular		复制
Avenir Next LT Pro Regular Bold		复制
BellTopo Sans Bold		复制
BellTopo Sans Bold Italic		复制
BellTopo Sans Italic		复制
BellTopo Sans Regular		复制
Belleza Regular		复制
Black Ops One Regular		复制
Cabin Sketch Bold		复制
Cabin Sketch Regular		复制
Coming Soon Regular		复制
FGDC GeoAge Regular		复制
Homemade Apple Regular		复制
IM FELL DW Pica PRO Italic		复制
IM FELL DW Pica PRO Regular		复制
Josefin Sans Regular		复制
Josefin Sans Semibold Italic		复制
Josefin Slab Bold		复制
Josefin Slab Bold Italic		复制
Josefin Slab Italic		复制
Josefin Slab Light Italic		复制
Josefin Slab Regular		复制
Josefin Slab Semibold Italic		复制
Josefin Slab Thin Italic		复制
Just Another Hand Regular		复制
Kranky Regular		复制
Life Savers Bold		复制
Loved by the King Regular		复制
Merriweather Bold		复制
Merriweather Bold Italic		复制
Merriweather Italic		复制
Merriweather Regular		复制
Meta Pro Bold		复制
Meta Pro Bold Italic		复制
Meta Pro Book		复制
Meta Pro Book Italic		复制
Meta Pro Cond Xbold		复制
Meta Pro Cond Xbold Italic		复制
Meta Pro Medium		复制
Meta Pro Medium Italic		复制
Montserrat Bold		复制
Montserrat Italic		复制
Montserrat Medium Italic		复制
Montserrat Regular		复制
Montserrat Semibold Italic		复制
Noto Sans Bold		复制
Noto Sans Bold Italic		复制
Noto Sans Italic		复制
Noto Sans Regular		复制
Noto Serif Bold		复制
Noto Serif Bold Italic		复制
Noto Serif Italic		复制
Noto Serif Regular		复制
Old Standard TT Bold		复制
Old Standard TT Italic		复制
Old Standard TT Regular		复制
Orbitron Bold		复制
Orbitron Regular		复制
Oregano Italic		复制
Oregano Regular		复制
Oswald Bold		复制
Oswald Regular		复制
Pacifico Regular		复制
Palatino Linotype Regular		复制
Playfair Display Black		复制
Playfair Display Bold		复制
Playfair Display Bold Italic		复制
Playfair Display Italic		复制
Playfair Display Regular		复制
Playfair Display SC Bold		复制
Playfair Display SC Regular		复制
Redressed Regular		复制
Risque Regular		复制
Roboto Condensed Italic		复制
Roboto Condensed Light Italic		复制
Rye Regular		复制
Special Elite Regular		复制
Syncopate Bold		复制
Syncopate Regular		复制
Tangerine Regular		复制
Ubuntu Bold		复制
Ubuntu Bold Italic		复制
Ubuntu Condensed Regular		复制
Ubuntu Italic		复制
Ubuntu Light		复制
Ubuntu Light Bold		复制
Ubuntu Light Bold Italic		复制
Ubuntu Light Italic		复制
Ubuntu Medium Italic		复制
Ubuntu Mono Bold		复制
Ubuntu Mono Bold Italic		复制
Ubuntu Mono Italic		复制
Ubuntu Mono Regular		复制
Ubuntu Regular		复制
UnifrakturCook Bold		复制
Vast Shadow Regular		复制
Walter Turncoat Regular		复制

MapImageLayer

通过在 Sublayer 类上设置 labelingInfo 属性，MapImageLayer 可支持标注。labelingInfo 属性被指定为 LabelClass 对象数组，其中包含 labelExpression、labelPlacement 和 TextSymbol。TextSymbol 类支持更改标注图形的 color、font、halo 和其他属性。点、折线和面均支持标注。

示例：MapImageLayer - 标注子图层要素

MapImageLayer 的字体

MapView 中的 MapImageLayers 支持的字体系列取决于安装在发布图层的 GeoScene Server 上的字体。要检查 GeoScene Server 上的可用字体，请运行 Home > services > System > PublishingTools (GPServer) 下的 Available Fonts 任务 (需要管理员访问)。要添加新字体，该字体必须安装在您的计算机上，并可通过使用 GeoScene Desktop 注册它来访问 GeoScene Server。如果应用程序使用了未安装的字体，则 Font 类将实现一个回退机制，该机制将使用默认字体系列值，即 sans-serif。

GeoScene Maps SDK for JavaScript

标注