Query

require(["esri/tasks/support/Query"], function(Query) { /* code goes here */ });

这个类定义了用于从层或层视图执行特性查询的参数。定义了查询对象的属性之后，就可以将其传递到可执行函数中，该函数将返回FeatureSet中的特性。
查询有三种类型:属性查询、空间查询和统计查询。你可以查询其中一个类别中的特性，或者在单个查询中使用每个类别的元素。

（1）属性查询

要根据属性值查询特性，请在where属性中指定一个SQL where子句。你可以选择对LIKE语句使用text属性。设置查询的外域将限制从查询返回的属性。如果你的应用程序不需要每个特性的所有属性，这可以提高查询的速度。
例如，你可以使用where从一个代表美国县的层查询华盛顿州的所有县:

var query = featureLayer.createQuery();
query.where = "STATE_NAME = 'Washington'";
query.outFields = [ "STATE_NAME", "COUNTY_NAME", "POPULATION", "(POPULATION / AREA) as 'POP_DENSITY'" ];featureLayer.queryFeatures(query).then(function(response){// 返回包含以下属性STATE_NAME, COUNTY_NAME, POPULATION, POP_DENSITY的特性集});

（2）空间查询

您可以通过几何/位置查询特性。虽然在此工作流中不需要where，但是您可以使用where作为查询的一部分来获得更精确的结果。
要执行空间查询，必须将几何参数设置为几何对象并指定有效的空间关系。您可以选择提供查询距离和单位来针对给定几何图形周围的缓冲区查询特性。
例如，要查询鼠标移动2英里内的所有功能，您可以执行以下操作:

view.on("pointer-move", function(event){var query = featureLayer.createQuery();query.geometry = view.toMap(event);  // 指针的点位置query.distance = 2;query.units = "miles";query.spatialRelationship = "intersects";  // 这是默认的query.returnGeometry = true;query.outFields = [ "POPULATION" ];featureLayerView.queryFeatures(query).then(function(response){// 返回一个特性集，其中的特性包含填充属性和每个特性的几何形状});
});

（3）统计查询

你可以返回字段属性和表达式的统计信息，而不是从查询中返回单个特性。统计查询由outStatistics参数定义，该参数需要统计定义对象数组。
例如，你可以通过以下方式查询上述层的平均县人口和总县人口:

// 查询所有特性中人口的总和
var sumPopulation = {onStatisticField: "POP_2015",  // 2015年人口服务领域outStatisticFieldName: "Pop_2015_sum",statisticType: "sum"
};// 查询所有特性中的平均人口
var avgPopulation = {onStatisticField: "POP_2015", outStatisticFieldName: "Pop_2015_avg",statisticType: "avg"
};// 注意，可以传递一个SQL表达式作为字段名来计算统计信息
var populationChangeDefinition = {onStatisticField: "POP_2015 - POP_2010",  outStatisticFieldName: "avg_pop_change_2015_2010",statisticType: "avg"
};var query = layer.createQuery();
query.where = "STATE_NAME = 'Washington'";
query.outStatistics = [ sumPopulation, avgPopulation, populationChangeDefinition ];
layer.queryFeatures(query).then(function(response){var stats = response.features[0].attributes;console.log("Total Population in WA": stats.Pop_2015_sum);console.log("Average Population in WA counties": stats.Pop_2015_avg);console.log("Average Population change in WA counties": stats.avg_pop_change_2015_2010);});

（4）distance

在空间查询中指定与给定几何图形的搜索距离。单位属性表示测量单位。实际上，设置此属性将在输入几何图形周围创建指定大小的缓冲区。查询将使用该缓冲区返回层或层视图中符合指定空间关系的特性。
如果查询功能服务，supportsQueryWithDistance能力必须为true。

（5）geometry

要应用到空间过滤器的几何图形。由spatialRelationship指定的空间关系将指示如何使用几何图形来查询特性。

（6）returnGeometry

如果为true，则返回的feature集中的每个特性都包括几何图形。
已知的限制：
对于FeatureLayerView查询，返回几何图形的精度将只与视图的比例分辨率一样高，因为几何图形被量化以提高视图的性能。尺度越小，几何图形的分辨率就越低。
这个限制不适用于FeatureLayer、CSVLayer和CSVLayerView查询。

（7）units

当空间查询中指定了距离时，用于计算缓冲区距离的单元。如果未指定单元，则单元从几何空间引用派生。如果未指定几何空间引用，则单元从特征服务数据空间引用派生。对于基于服务的查询，此参数仅适用于该层的capability .query。supportsDistance为true的。
可能的值:“feet”|“miles”|“nautical-miles”|“us-nautical-miles”|“meters”|“kilometers”

// 以查询几何图形的像素为单位进行查询。
// 使用查询几何图形的空间引用的单位。
layerView.queryFeatures({geometry: event.mapPoint,distance: 2 * view.resolution,returnGeometry: true
}).then(processResults);

（8）outFields

特性集中要包含的属性字段。字段必须存在于服务层中。必须列出实际的字段名称，而不是字段别名。但是，在显示查询结果时可以使用字段别名。
在指定输出字段时，应该将字段限制为仅希望在查询或结果中使用的字段。包含的字段越少，有效负载大小就越小，因此查询的响应就越快。
还可以将SQL表达式指定为外部字段，以便在服务器端为查询结果计算新值。请参阅下面的示例代码片段以获得一个示例。
每个查询必须能够访问层的Shape和ObjectId字段。但是，外域列表不需要包括这两个字段。
已知的限制：如果将外域指定为基于特性服务的特性执行层上的表达式，则服务功能将升级为querycapabilities。supportsOutFieldSQLExpression和useStandardizedQueries都必须为true。
例子：

// 查询字段属性
query.outFields = [ "NAME", "STATE_ABBR", "POP04" ];

// 查询从表达式和其他字段返回的数据，如以下字段名POP_CHANGE_2020, NAME, POP2020
//其中POP_CHANGE_2020表示2010 - 2020年的人口变化
query.outFields = [ "( (POP2020 - POP2010) / POP2010 ) * 100 as POP_CHANGE_2020", "NAME", "POP2020" ]

（9）spatialRelationship

对于空间查询，此参数定义了针对输入几何图形在层或层视图中查询特性的空间关系。空间关系发现特征是如何在空间上相互关联的。例如，你可能想知道表示县的多边形是否完全包含表示定居点的点。

空间关系是由几何图形的边界或内部是否相交决定的。
（1）边界-线特征的所有线性部分的端点，或多边形的线性轮廓。只有线和多边形有边界。
（2）内点完全是内部的，没有边界。对于线和多边形，内部是不属于边界的几何部分。

可能的值：
“intersects”|“contains”|“crosses”|“disjoint”|“envelope-intersects”|“index-intersects”|“overlaps”|“touches”|“within”|“relation”

var query = new Query({spatialRelationship: "contains"
});

（10）outStatistics

要计算的一个或多个基于字段的统计信息的定义。如果指定了outStatistics，则应该使用的其他查询参数只有groupByFieldsForStatistics、orderByFields、text和where。
已知的限制:对于基于服务的查询，outStatistics仅在supportsStatistics = true的层上得到支持。

var query = new Query();
var statisticDefinition: new StatisticDefinition({statisticType: "sum",onStatisticField: "POP2000",outStatisticFieldName: "TotalPop"
});query.outStatistics [ statisticsDefinition ];

（10）where

查询的where子句。允许在层中的字段上操作任何合法的SQL where子句。在JavaScript中编写where子句时，确保单引号和双引号的顺序正确。

query.where = "NAME = '" + stateName + "'";
query.where = "POP04 > " + population;

（11）timeExtent

针对可感知时间的层进行时态查询的时间范围。例如，它可以用来发现在特定日期晚上10点到早上6点的夜班期间发生的所有犯罪。

var layer = new FeatureLayer( ... );
var timeExtent = new TimeExtent( ... );
var timeQuery = new Query({timeExtent: timeExtent
});
layerView.queryFeatures(timeQuery).then(function(featureSet) { ... });