| 标注 | 说明 | 数据类型 |
输入要素 | 将进行缓冲的点、线或面要素，以及用于汇总输入汇总要素的缓冲区。 | Feature Layer |
输入汇总要素 | 将要汇总的点、线或面要素。 | Feature Layer |
输出要素类 | 输出面要素类，包括缓冲的输入要素、输入要素的属性和关于各缓冲区中数量点、线的长度及面的面积等新属性以及有关这些要素的统计数据。 | Feature Class |
距离测量 | 定义在输入要素周围生成缓冲区域中使用的距离测量的方式。行驶距离和行驶时间均使用道路网络，并遵守交通规则，例如单行道。行驶时间遵守当前发布的限速要求。 要使用行驶时间和行驶距离测量选项，您必须先使用网络分析权限登录 ArcGIS Online 组织帐户。每次工具成功运行，都会根据使用的服务和从服务返回的结果从您的订阅中扣除服务配额。ArcGIS Online 服务配额页面会提供有关服务配额的详细信息。 所有距离类型均使用 ArcGIS Online 路径和网络服务（直线距离除外）。
| String |
距离 | 距离值可定义搜索距离（例如直线、行驶、货运或步行距离）或行驶时间（行驶、货运或步行时间）。汇总处于您所输入距离内（包含该距离）的要素。 可以指定多个值。将为每个距离在每个输入要素周围生成一个区域。 | Double |
距离单位
(可选) | 距离值单位。
| String |
时间 (可选) | 指定行驶时间是否应该考虑交通状况。交通状况，尤其是城市化地区的交通状况，可以显著影响指定行驶时间内涉及的区域。如果未指定日期或时间，在某一特定行驶时间内行驶的距离将不受交通影响。 根据为此参数指定的日期和时间，交通状况可能是实时的，也可能是典型的（历史状况）。Esri 会保存 12 小时的实时交通数据并参考 12 小时以后的预测数据。如果您指定的时间和日期为 24 小时时间窗之内的时间和日期，则使用实时交通。如果超出了时间窗范围，则使用典型或历史交通。 | Date |
时区 (可选) | 指定时间的时区。可以将时区指定为本地时间或协调世界时间 (UTC)。
| String |
保留不含点要素的面 (可选) | 确定是输入要素的所有缓冲区还是仅那些相交或包括至少一个输入汇总要素的缓冲区将会复制到输出要素类。
| Boolean |
汇总字段 (可选) | 输入汇总要素中的属性字段名称及您想要为各输入要素缓冲区内全部点计算属性字段的统计汇总类型的列表。 汇总字段必须为数值型。不支持文本和其他属性字段类型。 统计类型如下：
| Value Table |
添加形状汇总属性 (可选) | 确定是否输出要素类将包括各输入要素缓冲区中汇总得出的点数量、线长度及面要素面积等属性。
| Boolean |
形状单位
(可选) | 用以计算形状汇总属性的单位。如果输入汇总要素为点，则不使用形状单位，因为仅添加各输入要素缓冲区内点的计数。 如果输入汇总要素为线，则指定一个线性单位。如果输入汇总要素为面，则指定一个面积单位。
| String |
组字段 (可选) | 用于分组的输入汇总要素中的属性字段。具有相同组字段值的要素将合并与具有相同组字段值的其他要素汇总。 如果选择一个组字段，则需要创建一个附加输出分组表格并必须指定其位置。使用组字段时需要使用该输出分组表格。 | Field |
添加少数和众数属性 (可选) | 仅当选定组字段时，才启用此选项。通过该选项，您可以确定各输入要素缓冲区中哪个组字段值为少数（所占比例最小），哪个为众数（所占比例最大）。
| Boolean |
添加组百分比 (可选) | 仅当选定组字段时，才启用此选项。您可以确定各组内各个属性值的百分比。
| Boolean |
输出分组表 (可选) | 如果指定了组字段，则需要输出分组表。 各个输入要素缓冲区各汇总要素组的汇总字段的输出表。该表将具有以下属性字段：
| Table |
摘要
无论时区如何，所有点的开始时间均应同步。距离的测量方式可采用直线距离、行驶时间距离（例如，10 分钟内）或行驶距离（5 公里内）。行驶时间和行驶距离的测量要求您先使用网络分析权限登录到 ArcGIS Online 组织帐户，然后消耗配额。
使用邻近汇总的示例情景：
- 计算在建议的新商店位置 5 分钟车程内的总人口数。
- 计算在建议的新商店位置的 1 英里行驶距离内的高速公路匝道数，以便测量商店的可达性。
插图
使用情况
您可以指定多个距离，并且各距离值将在各输入要素周围生成一片区域。例如，如果您指定两个距离，则每个输入要素将被缓冲两次，并且输出将包括两个区域（每个输入要素一个区域）。
范围内汇总和邻近汇总在概念上是相同的。使用范围内汇总工具，您可以在现有面内汇总要素，而使用邻近汇总工具，您可以在点、线或面周围生成区域并在那些派生的区域内汇总要素。
您可以通过从输入点中指定分组字段来创建组。例如，如果要将犯罪事件汇总在邻近地区边界距离内，可能会有一个含有五种不同犯罪类型的属性 Crime_type。各种唯一的犯罪类型构成一组，并将针对 Crime_type 的每个唯一值计算您选择的统计数据。
许可：
要使用行驶时间和行驶距离测量选项，您必须先使用网络分析权限登录 ArcGIS Online 组织帐户。每次工具成功运行，都会根据使用的服务和从服务返回的结果从您的订阅中扣除服务配额。ArcGIS Online 服务配额页面会提供有关服务配额的详细信息。
参数
arcpy.analysis.SummarizeNearby(in_features, in_sum_features, out_feature_class, distance_type, distances, {distance_units}, {time_of_day}, {time_zone}, {keep_all_polygons}, {sum_fields}, {sum_shape}, {shape_unit}, {group_field}, {add_min_maj}, {add_group_percent}, {Output_Grouped_Table})| 名称 | 说明 | 数据类型 |
in_features | 将进行缓冲的点、线或面要素，以及用于汇总输入汇总要素的缓冲区。 | Feature Layer |
in_sum_features | 将要汇总的点、线或面要素。 | Feature Layer |
out_feature_class | 输出面要素类，包括缓冲的输入要素、输入要素的属性和关于各缓冲区中数量点、线的长度及面的面积等新属性以及有关这些要素的统计数据。 | Feature Class |
distance_type | 定义在输入要素周围生成缓冲区域中使用的距离测量的方式。行驶距离和行驶时间均使用道路网络，并遵守交通规则，例如单行道。行驶时间遵守当前发布的限速要求。 要使用行驶时间和行驶距离测量选项，您必须先使用网络分析权限登录 ArcGIS Online 组织帐户。每次工具成功运行，都会根据使用的服务和从服务返回的结果从您的订阅中扣除服务配额。ArcGIS Online 服务配额页面会提供有关服务配额的详细信息。 所有距离类型均使用 ArcGIS Online 路径和网络服务（直线距离除外）。
| String |
distances [distance,...] | 距离值可定义搜索距离（例如直线、行驶、货运或步行距离）或行驶时间（行驶、货运或步行时间）。汇总处于您所输入距离内（包含该距离）的要素。 可以指定多个值。将为每个距离在每个输入要素周围生成一个区域。 | Double |
distance_units (可选) | 距离值单位。
| String |
time_of_day (可选) | 指定行驶时间是否应该考虑交通状况。交通状况，尤其是城市化地区的交通状况，可以显著影响指定行驶时间内涉及的区域。如果未指定日期或时间，在某一特定行驶时间内行驶的距离将不受交通影响。 根据为此参数指定的日期和时间，交通状况可能是实时的，也可能是典型的（历史状况）。Esri 会保存 12 小时的实时交通数据并参考 12 小时以后的预测数据。如果您指定的时间和日期为 24 小时时间窗之内的时间和日期，则使用实时交通。如果超出了时间窗范围，则使用典型或历史交通。 | Date |
time_zone (可选) | 指定时间的时区。可以将时区指定为本地时间或协调世界时间 (UTC)。
| String |
keep_all_polygons (可选) | 确定是输入要素的所有缓冲区还是仅那些相交或包括至少一个输入汇总要素的缓冲区将会复制到输出要素类。
| Boolean |
sum_fields [[summary_field, statistic_type],...] (可选) | 输入汇总要素中的属性字段名称及您想要为各输入要素缓冲区内全部点计算属性字段的统计汇总类型的列表。 汇总字段必须为数值型。不支持文本和其他属性字段类型。 统计类型如下：
| Value Table |
sum_shape (可选) | 确定是否输出要素类将包括各输入要素缓冲区中汇总得出的点数量、线长度及面要素面积等属性。
| Boolean |
shape_unit (可选) | 用以计算形状汇总属性的单位。如果输入汇总要素为点，则不使用形状单位，因为仅添加各输入要素缓冲区内点的计数。 如果输入汇总要素为线，则指定一个线性单位。如果输入汇总要素为面，则指定一个面积单位。
| String |
group_field (可选) | 用于分组的输入汇总要素中的属性字段。具有相同组字段值的要素将合并与具有相同组字段值的其他要素汇总。 如果选择一个组字段，则需要创建一个附加输出分组表格并必须在 out_grouped_table 参数中指定其位置。 | Field |
add_min_maj (可选) | 仅当选定组字段时，才启用此选项。通过该选项，您可以确定各输入要素缓冲区中哪个组字段值为少数（所占比例最小），哪个为众数（所占比例最大）。
| Boolean |
add_group_percent (可选) | 仅当选定组字段时，才启用此选项。您可以确定各组内各个属性值的百分比。
| Boolean |
Output_Grouped_Table (可选) | 如果指定了组字段，则需要输出分组表。 各个输入要素缓冲区各汇总要素组的汇总字段的输出表。该表将具有以下属性字段：
| Table |
代码示例
以下 Python 窗口脚本演示了如何使用 SummarizeNearby 函数。
import arcpy
arcpy.env.workspace = "C:/data/city.gdb"
arcpy.SummarizeNearby_analysis("new_store_location", "census_blocks",
"new_store_population", "STRAIGHT_LINE", "1;2",
"Miles", "", "", "KEEP_ALL", "Pop2014 SUM")下面的独立脚本演示了如何在脚本环境中使用 SummarizeNearby 函数。
# Description: Use SummarizeNearby to summarize population
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/city.gdb"
# Set local variables
newStore = "new_store_location"
censusInfo = "census_blocks"
outFeatureClass = "crimes_aggregated"
distanceType = "TRAVEL_TIME"
distance = "10;20"
distanceUnit = "Minutes"
time = "10/15/2014 2:14:19 PM"
timeZone = "GEOLOCAL"
keepPolys = True
sumFields = [["Pop2010", "Sum"],["OWNERS", "Sum"]]
addShapeSum = True
arcpy.SummarizeNearby_analysis(newStore, censusInfo, outFeatureClass,
distanceType, distance, distanceUnit,
time, timeZone, keepPolys, sumFields,
addShapeSum)环境
特殊情况
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是