| 标注 | 说明 | 数据类型 |
点图层 | 将聚合到面或图格的点要素。 | Feature Layer |
输出要素类 | 包含聚合面结果的新要素类。 | Feature Class |
面或图格 | 指定如何聚合点图层参数值。
| String |
面图层 (可选) | 输入点将聚合到的面要素。 | Feature Layer |
图格类型 (可选) | 指定用于容纳聚合点的图格形状。
| String |
图格大小 (可选) | 表示点图层值将聚合到的条柱大小和单位的距离间隔。 距离间隔必须为线性单位。 | Linear Unit |
时间步长间隔 (可选) | 用来指定时间步长持续时间的值。 只有在输入点启用了时间且表示时刻时，此参数才可用。 只有对输入启用了时间的情况下，才可应用时间步长。 | Time Unit |
时间步长重复 (可选) | 用来指定时间步长间隔发生频率的值。 只有在输入点启用了时间且表示时刻时，此参数才可用。 | Time Unit |
时间步长参考 (可选) | 用来指定时间步长所要对齐的参考时间的日期。 默认情况下为 1970 年 1 月 1 日 12:00 a.m.。只有在输入点启用了时间且表示时刻时，此参数才可用。 | Date |
汇总字段 (可选) | 将根据指定字段进行计算的统计数据。 | Value Table |
图格分辨率 (可选) | H3 图格的分辨率。 取值范围为 0 到 15，其中 0 表示生成最大的 H3 图格，15 表示生成最小的 H3 图格。 | Long |
插图
使用情况
可以使用以下任一方式指定点将聚合的区域：
- 使用面图层。
- 使用在运行分析时生成的指定大小的正方形、六边形或 H3 图格。
您可以提供要用于分析的区域图层，也可以生成点要聚合到的指定大小和形状（六边形、正方形或 H3）的图格。 图格大小参数用于指定正方形和六边形图格的大小。
- 如果聚合到六边形，则大小为每个六边形的高度，而所生成六边形的宽度为高度除以根号 3 再乘以 2。
- 如果要聚合到正方形，则图格大小为正方形的高度（等于宽度）。
- 如果聚合到 H3 图格中，则图格大小由指定的 H3 图格分辨率确定。 H3 图格分辨率的取值范围为 0 到 15，其中 0 表示生成最大的图格，15 表示生成最小的图格。
使用条柱的分析要求您的输入已投影或输出坐标系设置为投影坐标系。 如果您的数据不在投影坐标系中，并且未设置投影坐标系，则将根据您分析的数据范围使用投影。
输出要素图层始终是面图层。 仅将返回包含点的面，生成的面将完全从结果图层中移除。
第一张图像显示了输入点和面要素，第二张图像显示了“聚合点”工具生成的面要素。 如果对输入启用了时间，便可以在分析中应用时间步长。 每个时间步长将独立于时间步长外的要素进行分析。 要使用时间步长，输入数据必须已启用时间且能够表示时刻。 应用时间步长后，输出要素将为 START_DATETIME 和 END_DATETIME 字段表示的时间间隔。
通过最基本的聚合，对每个面中的点的数量计数进行计算。 统计数据（计数、总和、最小值、最大值、范围、平均值、标准差和方差）还可以根据数值字段进行计算；统计数据（计数、任意）可根据字符串字段进行计算。 将分别计算每个区域的统计数据。 如果指定了无效的统计数据（例如字符串字段的平均值），则将被跳过。
注：
将计数应用于字段时，其将返回存在于字段中的非空值的计数。 将任意应用于字段时，其将返回存在于字段中的单个字符串。
如果对输入启用了时间，便可以在分析中应用时间步长。 每个时间步长将独立于时间步长外的要素进行分析。 要使用时间步长，输入数据必须已启用时间且能够表示时刻。 应用时间步长后，输出要素将为 START_DATETIME 和 END_DATETIME 字段表示的时间间隔。
如果指定了时间步长间隔、时间步长重复或参考时间，但数据未启用时间，将会发生错误。
时间步长参考参数可以是日期和时间值或仅为日期值，但不可仅为时间值。
下列字段将包含在输出要素中：
字段名 描述 count
每个面内的要素计数。
statistic_fieldname
指定的统计数据将分别创建一个属性字段，名称格式如下：statistic_fieldname。 例如，id 字段的最大值和标准差分别为 MAX_id 和 SD_id。
start_date
如果指定了时间步长，输出面将具有时间间隔。 该字段表示开始时间。
end_date
如果指定了时间步长，输出面将具有时间间隔。 该字段表示结束时间。
bin_id
数值型 H3 图格 ID。 仅在聚合到 H3 图格时包括此字段。
您可以通过以下提示来提高聚合点工具的性能：
- 设置范围环境，以便仅分析感兴趣的数据。
- 与较小的图格相比，较大的图格性能更佳。 如果对图格大小不确定，可以先使用较大的图格进行原型设计。
- 与图格类似，与较小的时间步长相比，较大的时间步长性能更佳。
- 将本地数据用于分析运行的位置。
此地理处理工具由 Spark 作为支持。 可在台式计算机上并行使用多个核来完成分析。 要了解有关运行分析的详细信息，请参阅 GeoAnalytics Desktop 工具的注意事项。
运行 GeoAnalytics Desktop 工具时，将在台式计算机上完成分析。 为获得最佳性能，应在桌面上提供数据。 如果使用的是托管要素图层，则建议您使用 ArcGIS GeoAnalytics Server。 如果您的数据不是本地数据，则运行工具需要更长时间。 要使用 ArcGIS GeoAnalytics Server 执行分析，请参阅 GeoAnalytics Tools。
还可以使用“标准要素分析”工具箱中的聚合点工具完成类似性分析。
参数
arcpy.geoanalytics.AggregatePoints(point_layer, out_feature_class, polygon_or_bin, {polygon_layer}, {bin_type}, {bin_size}, {time_step_interval}, {time_step_repeat}, {time_step_reference}, {summary_fields}, {bin_resolution})| 名称 | 说明 | 数据类型 |
point_layer | 将聚合到面或图格的点要素。 | Feature Layer |
out_feature_class | 包含聚合面结果的新要素类。 | Feature Class |
polygon_or_bin | 指定如何聚合 point_layer 参数值。
| String |
polygon_layer (可选) | 输入点将聚合到的面要素。 | Feature Layer |
bin_type (可选) | 指定用于容纳聚合点的图格形状。
| String |
bin_size (可选) | 表示 point_layer 值将聚合到的图格大小和单位的距离间隔。 距离间隔必须为线性单位。 | Linear Unit |
time_step_interval (可选) | 用来指定时间步长持续时间的值。 只有在输入点启用了时间且表示时刻时，此参数才可用。 只有对输入启用了时间的情况下，才可应用时间步长。 | Time Unit |
time_step_repeat (可选) | 用来指定时间步长间隔发生频率的值。 只有在输入点启用了时间且表示时刻时，此参数才可用。 | Time Unit |
time_step_reference (可选) | 用来指定时间步长所要对齐的参考时间的日期。 默认情况下为 1970 年 1 月 1 日 12:00 a.m.。只有在输入点启用了时间且表示时刻时，此参数才可用。 | Date |
summary_fields [summary_fields,...] (可选) | 将根据指定字段进行计算的统计数据。
| Value Table |
bin_resolution (可选) | H3 图格的分辨率。 取值范围为 0 到 15，其中 0 表示生成最大的 H3 图格，15 表示生成最小的 H3 图格。 | Long |
代码示例
以下 Python 窗口脚本演示了如何使用 AggregatePoints 函数。
# Name: AggregatePoints.py
# Description: Aggregate 311 events into 1 KM Bins.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/CityData.gdb"
# Set local variables
inFeatures = "SF311"
summaryFields = ["Year", "Beat"]
summaryStatistics = [["Arrest", "COUNT"], ["District", "COUNT"]]
out = "AggregateWildfires"
# Run Aggregate Points
arcpy.gapro.AggregatePoints(inFeatures, out, "BIN", None, "HEXAGON",
"1 Kilometers")