标注 | 说明 | 数据类型 |
输入要素 | 将进行缓冲的点、线或面要素。 这些缓冲区将用于汇总输入汇总要素。 | Feature Layer |
输入汇总要素 | 将要汇总的点、线或面要素。 | Feature Layer |
输出要素类 | 输出面要素类,包括缓冲的输入要素、输入要素的属性和关于各缓冲区中数量点、线的长度及面的面积等新属性以及有关这些要素的统计数据。 | Feature Class |
距离测量 | 指定将用于生成缓冲区的距离测量类型。 行驶距离和行驶时间都将使用道路网络,并遵守诸如单行道等限制。 行驶时间遵守当前发布的限速要求。 要使用行驶时间和行驶距离测量选项,您必须登录到具有网络分析权限的 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 值计算您选择的统计数据。
空值将被排除在所有统计计算之外。 例如,10、5 和空值的平均值为 7.5 ((10+5)/2)。
许可:
要使用行驶时间和行驶距离测量选项,您必须登录到具有网络分析权限的 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 路径和网络服务(直线距离除外)。
| 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 (可选) | 指定是否将每个输入要素缓冲区内的少数(所占比例最小)和众数(所占比例最大)组字段值添加至输出。 如果指定了 group_field 参数值,则将启用此参数。
| Boolean |
add_group_percent (可选) | 指定是否将每个组中每个属性值的百分比添加至输出。 使用此参数,您可以确定各组内各个属性值的百分比。 如果指定了 group_field 参数值,则将启用此参数。
| Boolean |
Output_Grouped_Table (可选) | 各个输入要素缓冲区各汇总要素组的汇总字段的输出表。 如果指定了组字段,则需要输出分组表。 该表将具有以下属性字段:
| Table |
代码示例
以下 Python 窗口脚本演示了如何使用 SummarizeNearby 函数。
import arcpy
arcpy.env.workspace = "C:/data/city.gdb"
arcpy.analysis.SummarizeNearby("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.analysis.SummarizeNearby(newStore, censusInfo, outFeatureClass,
distanceType, distance, distanceUnit,
time, timeZone, keepPolys, sumFields,
addShapeSum)
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是