uniqueValues

方法概述

方法详细说明

uniqueValues(params){Promise<UniqueValuesResult>}

返回一个对象，包含从图层中的给定字段 (或从表达式返回的值) 查询的唯一值数组以及属于给定类别的要素总数。

参数

规范

params Object 各参数的详细信息见下表。 规范 layer FeatureLayer|SceneLayer|CSVLayer|PointCloudLayer|GeoJSONLayer|WFSLayer|OGCFeatureLayer 要从中查询唯一值的图层。 field String optional 将从中获取唯一值的数字或字符串字段的名称。如果使用 valueExpression，则忽略此属性。 valueExpression String optional 遵循 Arcade 可视化配置文件定义的规范的 Arcade 表达式 表达式。表达式可能使用 $feature 配置变量来引用字段值，并且必须返回一个字符串或数字。此属性覆盖 field 属性，因此用于代替输入 field 值。 sqlExpression String optional 一个 SQL 表达式，其计算结果为数字或字符串。 sqlWhere String optional SQL where 子句，用于过滤统计查询的要素。例如，当您希望避免除以 0 的情况时 (像创建优势可视化的情况那样)，这很有用。 returnAllCodedValues Boolean optional 表示如果给定字段具有域值，则应返回所有域代码。 view View optional 当指定 valueExpression 时，需要 SceneView 或 MapView 实例。 filter FeatureFilter optional 用于按几何过滤统计查询的要素过滤器。此参数仅用于按几何过滤统计信息。忽略 FeatureFilter.where 属性上设置的任何属性过滤器。目前，仅支持 intersects 空间关系。如果您已按图层上的几何定义了要素过滤器，并且希望计算包含要素的统计信息，则此选项非常有用。从 4.25 版开始。 features Graphic[] 已弃用从 4.23 版开始。请改为使用 useFeaturesInView。 optional 生成唯一值的要素子集。 useFeaturesInView Boolean optional 仅当输入 layer 是服务支持的 FeatureLayer 时才适用。当为 true，将根据视图中可见的要素在客户端上计算统计信息。如果为 false，则将从服务请求统计信息。从 4.23 版开始。 forBinning Boolean optional 指示生成的统计信息是用于图格可视化还是用于聚类可视化。如果为 true，则此方法中的输入字段应引用该图层的 featureReduction 属性中定义的聚合字段。 signal AbortSignal optional 允许可取消的请求。如果取消，则承诺将被拒绝，并返回一个名为 AbortError 的错误。另请参见 AbortController。

返回

类型	描述
Promise<UniqueValuesResult>	返回解析为 UniqueValuesResult 的承诺。

示例

let layer = new FeatureLayer({
  portalItem: { id: "5ce5374a461e45bab714b43ffedf151d" }
});

uniqueValues({
  layer: layer,
  field: "Candidate"
}).then(function(response){
  // prints each unique value and the count of features containing that value
  let infos = response.uniqueValueInfos;
  infos.forEach(function(info){
    console.log("CANDIDATE: ", info.value, " # OF CAMPAIGN STOPS: ", info.count);
  });
});

类型定义

UniqueValuesResult

包含从图层字段的 uniqueValues() 查询返回的唯一值的对象。

属性

uniqueValueInfos Object[] 一个对象数组，每个对象都包含一个唯一值/类型/类别，存在于 uniqueValues() 查询的指定字段中。每个对象的规范见下表。 规范 value String|Number 表示图层中要素类型或类别的唯一值。 count Number 分配给定 value (或属于给定类别) 的要素数。