你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

SymbolLayerOptions interface

在 SymbolLayer 中呈现几何图形时使用的选项。

Extends

属性

iconOptions

用于自定义符号图标的选项。

有关默认值,请参阅 IconOptions。

lineSpacing

沿一条线的两个符号定位点之间的距离(以像素为单位)。 必须大于或等于 1。 默认为 250

placement

指定相对于其几何形状的标签放置。

“point”:标签放置在几何图形所在的点。

“”line“:标签沿几何图形的线条放置。 只能在 LineString 和 Polygon 几何图形上使用。

“line-center”:标签放置在几何图形线条的中心。 只能在“LineString”和“Polygon”几何图形上使用

默认为“”point”。
sortKey

根据此值按升序对特征进行排序。 先绘制并放置排序键较低的特征。 默认为 undefined

source

层将呈现的数据源的 ID 或实例。

sourceLayer

当层的源为 VectorTileSource 时是必需的。 向量源中可以有多个层,这标识了要在此层中呈现的层。 禁止用于所有其他类型的源。

textOptions

用于自定义符号文本的选项。

有关默认值,请参阅 TextOptions。

zOrder

确定同一层中的重叠符号是按它们在数据源中的显示顺序呈现,还是按其相对于视区的 y 位置呈现。 若要控制符号的顺序和优先顺序,请使用 sortKey

“”auto“:如果已设置,则按”sortKey“对符号进行排序。 否则的行为类似于“viewport-y”。

“viewport-y”:如果“allowOverlap”为“true”或“ignorePlacement”为“false”,则按符号的 y 位置排序。

“source”:如果已设置,则按“sortKey”对符号进行排序。 否则,符号的呈现顺序与源数据相同。 默认为“”auto”

继承属性

filter

指定源特征条件的表达式。 仅显示与筛选器匹配的功能。

maxZoom

一个整数,指定要呈现层的最大缩放级别。 此值是独占的,即层将在 上可见 maxZoom > zoom >= minZoom。 默认为 24

minZoom

一个整数,指定要呈现层的最小缩放级别。 此值是非独占的,即层将在 中可见 maxZoom > zoom >= minZoom。 默认为 0

visible

指定层是否可见。 默认为 true

属性详细信息

iconOptions

用于自定义符号图标的选项。

有关默认值,请参阅 IconOptions。

iconOptions?: IconOptions

属性值

lineSpacing

沿一条线的两个符号定位点之间的距离(以像素为单位)。 必须大于或等于 1。 默认为 250

lineSpacing?: number | PropertyValueSpecification<number>

属性值

number | PropertyValueSpecification<number>

placement

指定相对于其几何形状的标签放置。

“point”:标签放置在几何图形所在的点。

“”line“:标签沿几何图形的线条放置。 只能在 LineString 和 Polygon 几何图形上使用。

“line-center”:标签放置在几何图形线条的中心。 只能在“LineString”和“Polygon”几何图形上使用

默认为“”point”。
placement?: "point" | "line" | "line-center"

属性值

"point" | "line" | "line-center"

sortKey

根据此值按升序对特征进行排序。 先绘制并放置排序键较低的特征。 默认为 undefined

sortKey?: number | DataDrivenPropertyValueSpecification<number>

属性值

number | DataDrivenPropertyValueSpecification<number>

source

层将呈现的数据源的 ID 或实例。

source?: string | Source

属性值

string | Source

sourceLayer

当层的源为 VectorTileSource 时是必需的。 向量源中可以有多个层,这标识了要在此层中呈现的层。 禁止用于所有其他类型的源。

sourceLayer?: string

属性值

string

textOptions

用于自定义符号文本的选项。

有关默认值,请参阅 TextOptions。

textOptions?: TextOptions

属性值

zOrder

确定同一层中的重叠符号是按它们在数据源中的显示顺序呈现,还是按其相对于视区的 y 位置呈现。 若要控制符号的顺序和优先顺序,请使用 sortKey

“”auto“:如果已设置,则按”sortKey“对符号进行排序。 否则的行为类似于“viewport-y”。

“viewport-y”:如果“allowOverlap”为“true”或“ignorePlacement”为“false”,则按符号的 y 位置排序。

“source”:如果已设置,则按“sortKey”对符号进行排序。 否则,符号的呈现顺序与源数据相同。 默认为“”auto”

zOrder?: "auto" | "viewport-y" | "source"

属性值

"auto" | "viewport-y" | "source"

继承属性详细信息

filter

指定源特征条件的表达式。 仅显示与筛选器匹配的功能。

filter?: Expression

属性值

继承自LayerOptions.filter

maxZoom

一个整数,指定要呈现层的最大缩放级别。 此值是独占的,即层将在 上可见 maxZoom > zoom >= minZoom。 默认为 24

maxZoom?: number

属性值

number

继承自LayerOptions.maxZoom

minZoom

一个整数,指定要呈现层的最小缩放级别。 此值是非独占的,即层将在 中可见 maxZoom > zoom >= minZoom。 默认为 0

minZoom?: number

属性值

number

继承自LayerOptions.minZoom

visible

指定层是否可见。 默认为 true

visible?: boolean

属性值

boolean

继承自LayerOptions.visible