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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。

基本信息

用法說明

參數：

返回：

例子：