JavaScript ArcGIS classBreaks.classBreaks用法及代码示例

基本信息

以下是所在类或对象的基本信息。

AMD: require(["esri/smartMapping/statistics/classBreaks"], (classBreaks) => { /* code goes here */ });

ESM: import classBreaks from "@arcgis/core/smartMapping/statistics/classBreaks";

函数： esri/smartMapping/statistics/classBreaks

自从：用于 JavaScript 4.2 的 ArcGIS API

用法说明

classBreaks.classBreaks函数(或属性)的定义如下：

classBreaks (params) {Promise<ClassBreaksResult>}

根据给定的分类方法和规范化类型为 FeatureLayer 的输入字段(或表达式)生成分类分隔符。

参数：

规格：

类型说明

params Object

有关可以传递给此函数的参数的详细信息，请参见下表。

规格：

layer

从中生成分类间隔的层。

field

String

可选的

分类间隔将根据该字段的值生成。如果提供了字段，则将在服务中查询来自所有要素的给定字段的值。

normalizationField

String

可选的

用于规范化从给定 field 返回的值的字段。

classificationMethod

String

可选的

数据分类的方法。有关可能值的列表，请参见下表。

可能的值	说明
natural-breaks	聚类的数据值被放置在一个类中。类中断发生在簇之间存在间隙的地方。如果您的数据分布不均匀，则应使用此方法；也就是说，许多特征具有相同或相似的值，并且值组之间存在差距。
equal-interval	每个类都有相同的取值范围；换句话说，每个类别的高值和低值之间的差异是相等的。如果您的数据分布均匀，并且您想强调特征之间的值差异，则应使用此方法。
quantile	每个类都有大致相同数量的特征。如果你的数据是均匀分布的，并且你想强调特征之间相对位置的差异，你应该使用分位数分类方法。例如，如果将点值分为五个等级，则最高等级的点将落入所有点的前五分之一。
standard-deviation	以 `1` 、 `0.5` 或 `0.25` 标准差为间隔将分类分隔符放置在平均值上方和下方，直到所有数据值都包含在一个类中。

可能的值："equal-interval"|"natural-breaks"|"quantile"|"standard-deviation"

standardDeviationInterval

Number

可选的

当 classificationMethod = "standard-deviation" 时，这将设置应设置每个分类的间隔(例如 0.25 、 0.33 、 0.5 、 1 )。

minValue

Number

可选的

分类间隔定义的最小边界值。将此与 maxValue 结合使用以在下限和上限之间生成分类中断。

maxValue

Number

可选的

分类间隔定义的最大边界值。将此与 minValue 结合使用以在下限和上限之间生成分类中断。

numClasses

Number

可选的

指示要为分类中断定义生成的分类数。

valueExpression

String

可选的

遵循 Arcade Visualization Profile 定义的规范的 Arcade 表达式。表达式可以使用 $feature 全局变量引用字段值，并且必须返回一个数字。此属性覆盖 field 属性，因此用于代替输入 field 值。

sqlExpression

String

可选的

计算为数字的 SQL 表达式。

sqlWhere

String

可选的

用于过滤统计查询函数的 SQL where 子句。例如，这在您希望避免除以零的情况下很有用，就像创建优势可视化的情况一样。

view

View

可选的

当指定 valueExpression 时，需要 SceneView 或 MapView 实例。

features

Graphic []

已弃用从 4.23 版开始。请改用useFeaturesInView。

可选的

为其生成分类间隔的要素子集。

useFeaturesInView

Boolean

可选的

仅适用于输入layer是一个service-backed FeatureLayer。什么时候true，将根据视图中可见的函数在客户端上计算统计信息。如果false，将从服务中请求统计信息。从 4.23 版开始。

signal

AbortSignal

可选的

允许可取消的请求。如果取消，promise 将被拒绝，并出现名为 AbortError 的错误。另见AbortController。

类型	说明
Promise<ClassBreaksResult>	解析为 ClassBreaksResult 的实例。

例子：

classBreaks({
  layer: featureLayer,
  field: "COL_DEG",
  normalizationField: "TOT_POP",
  classificationMethod: "quantile",
  numClasses: 5
}).then(function(response){
  // class break infos that may be passed to the
  // constructor of a ClassBreaksRenderer
  let breakInfos = response.classBreakInfos;
});

相关用法

注：本文由纯净天空筛选整理自arcgis.com大神的英文原创作品 classBreaks.classBreaks。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。

基本信息

用法说明

参数：

返回：

例子：