• geoscene/smartMapping

dotDensity

AMD: require(["geoscene/smartMapping/symbology/dotDensity"], (dotDensitySchemes) => { /* code goes here */ });
ESM: import * as dotDensitySchemes from "@geoscene/core/smartMapping/symbology/dotDensity";
类: geoscene/smartMapping/symbology/dotDensity
起始版本:GeoScene Maps SDK for JavaScript 4.12

此对象包含辅助方法,用于获取可创建点密度可视化的最佳符号方案。getSchemes() 可返回最适合此可视化样式的给定底图的配色方案。

方法概述

名称 返回值类值 描述 对象
DotDensityScheme

克隆一个点密度方案对象。

更多详情
dotDensity
DotDensityScheme

返回具有提供名称的点密度方案。

更多详情
dotDensity
DotDensitySchemes

返回主要方案和次要方案,这些方案定义了图层中基于点密度的数据驱动型可视化的符号属性。

更多详情
dotDensity
DotDensityScheme[]

返回具有所提供标签的点密度方案数组。

更多详情
dotDensity

方法详细说明

cloneScheme(scheme){DotDensityScheme}

克隆一个点密度方案对象。

参数

要克隆的点密度方案对象。

返回
类型 描述
DotDensityScheme 返回给定点密度方案对象的克隆。
示例
// clones the primary scheme returned from the getSchemes() method
const dotDensityScheme = primaryScheme.clone();
getSchemeByName(params){DotDensityScheme}

返回具有提供名称的点密度方案。

参数
规范
params Object

有关可能传递给此函数的每个参数的详细信息,请参阅下表。

规范
name String

要检索的方案的名称。

basemap String|Basemap
optional

与可视化配对的底图。此值表示使用给定底图进行可视化要素的最佳符号颜色。

basemapTheme String
optional

如果您具有非 GeoScene 底图 (例如,具有自定义样式的 VectorTileLayer 底图) 或根本没有底图,则可使用此参数来表示可视化的背景是 light 还是 dark

可能值"light"|"dark"

numColors Number

要可视化的颜色数量。

返回
类型 描述
DotDensityScheme 返回具有给定名称的点密度方案。
示例
// Returns the Galaxy Berries scheme
let galaxyBerriesScheme = dotDensitySchemes.getSchemeByName({
  basemap: map.basemap,
  numColors: 3,
  name: "Galaxy Berries"
});
getSchemes(params){DotDensitySchemes}

返回主要方案和次要方案,这些方案定义了图层中基于点密度的数据驱动型可视化的符号属性。basemap 参数可确定用于可视化每个属性的点的颜色。geometryType 可确定要返回的符号类型。

参数
规范
params Object

有关可能传递给此函数的每个参数的详细信息,请参阅下表。

规范
basemap String|Basemap
optional

与可视化配对的底图。此值表示针对给定底图进行可视化要素的最佳符号颜色。如果您具有非 GeoScene 底图 (例如,具有自定义样式的 VectorTileLayer 底图) 或根本没有底图,则可使用 basemapTheme 参数而不是此参数。

basemapTheme String
optional

如果您具有非 GeoScene 底图 (例如,具有自定义样式的 VectorTileLayer 底图) 或根本没有底图,则可使用此参数来表示可视化的背景是 light 还是 dark

可能值"light"|"dark"

numColors Number

要可视化的颜色数量。

返回
类型 描述
DotDensitySchemes 返回一个对象,其中包含要用于给定底图的最佳类型方案;它还包含次要方案。
示例
// gets the primary scheme for the features of the given geometry type and basemap
const schemes = dotDensitySchemes.getSchemes({
  basemap: map.basemap,
  geometryType: featureLayer.geometryType
});

// the best default scheme for the layer and basemap
const primaryScheme = schemes.primaryScheme;
getSchemesByTag(params){DotDensityScheme[]}

返回具有所提供标签的点密度方案数组。这些方案定义了可使用 DotDensityRenderer 渲染的任何图层中的点密度可视化的符号属性。

参数
规范
params Object

有关可能传递给此函数的每个参数的详细信息,请参阅下表。

规范
includedTags String[]
optional

提供后,将仅返回包含所有匹配标记的方案。

已知标签: light | dark | reds | yellows | oranges | greens | blues | purples | pinks | browns | grays | bright | subdued | deuteranopia | protanopia | tritanopia | grayscale | types | dot-density

excludedTags String[]
optional

提供后,将仅返回缺少所有已提供标记的方案。

已知标签: light | dark | reds | yellows | oranges | greens | blues | purples | pinks | browns | grays | bright | subdued | deuteranopia | protanopia | tritanopia | grayscale | types | dot-density

basemap String|Basemap
optional

与可视化配对的底图。此值表示使用给定底图进行可视化要素的最佳符号颜色。

basemapTheme String
optional

如果您具有非 GeoScene 底图 (例如,具有自定义样式的 VectorTileLayer 底图) 或根本没有底图,则可使用此参数来表示可视化的背景是 light 还是 dark

可能值"light"|"dark"

numColors Number

要可视化的颜色数量。

返回
类型 描述
DotDensityScheme[] 返回包含或排除所提供标记的点密度方案数组。
示例
// Returns all the red dot density schemes
let schemes = dotDensitySchemes.getSchemesByTag({
  basemap: map.basemap,
  numColors: 2,
  includedTags: [ "reds", "dot-density" ]
});

类型定义

DotDensityScheme

定义符号系统方案的属性,该方案用于可视化多边形要素的优势。

属性
name String

方案的唯一名称。

与方案相关的标签。

colors Color[]

每个属性的点颜色。

outline Object

用于定义符号轮廓的属性。

规范
color Color

符号的轮廓颜色。

width Number

符号轮廓的宽度,以磅为单位。

opacity Number

符号的不透明度 (0-1)。

DotDensitySchemes

getSchemes() 方法返回的对象。

属性
primaryScheme DotDensityScheme

最适合给定底图和几何类型的点密度方案。

secondarySchemes DotDensityScheme[]

可用于可视化给定几何类型数据 (叠加在给定底图上) 的其他点密度方案。

basemapId String

与给定方案相关联的底图 ID。

basemapTheme String

表示平均底图颜色是 light 还是 dark

您的浏览器不再受支持。请升级您的浏览器以获得最佳体验。请参阅浏览器弃用帖子以获取更多信息