邻近汇总 (标准要素分析)—ArcGIS Pro

摘要

在输入图层中查找处于指定要素距离内的要素。

距离可按直线距离或指定的出行模式进行测量。然后，计算邻近要素的统计数据，如下所示：

计算在建议的新商店位置 5 分钟车程内的总人口数。
计算在建议的新商店位置的 1 英里行驶距离内的高速公路匝道数，以便测量商店的可达性。

插图

使用情况

邻近汇总工具需要两个输入图层：用于测量距离的图层和要汇总的图层。两个图层均可为点、线或面。第一个输入图层最多可包含 1000 个要素。
邻近距离可基于直线距离或多种不同的出行模式，使用时间或距离作为测量单位。仅当您的第一个输入图层包含点要素时才启用出行模式。您可通过输入多个距离或时间来创建多个输出面。
一些出行模式具有使用交通状况的选项。使用交通状况时，结果可能取决于当周指定日期和时间的实时状况或典型状况。实时交通状况可能与当前时间偏移多达 12 小时。全天均可将典型状况的时间间隔设置为 15 分钟。
出行模式可由组织管理员进行配置。管理员还可以添加新的出行模式或移除并非组织必需的出行模式。默认距离测量单位将为英里或千米，具体取决于配置文件中的 units 设置。

参数

标注	说明	数据类型
输入邻近要素图层	用作输入汇总图层中到要素的距离的测量起点的点、线或面要素。	Feature Set
输入汇总要素	点、线或面要素。将汇总此图层中与输入邻近要素图层中的要素相距指定距离的要素。	Feature Set
输出名称	要在门户中创建的输出图层的名称。	String
距离测量	定义要使用的距离测量方式：按直线距离进行测量，或利用多种交通方式（称为出行模式）通过测量沿街道网络的行驶时间或行驶距离来进行测量。直线—使用直线欧式距离测量法。这是默认设置。行驶距离—使用汽车行驶距离。行驶时间—使用在指定汽车行驶时间内行驶的距离。货运距离—使用卡车行驶距离。货运时间—使用在指定卡车行驶时间内行驶的距离。步行距离—使用沿街道步行的距离。步行时间—使用指定步行时间内行驶的距离。	String
距离 (可选)	定义搜索距离（针对直线和基于距离的出行模式）或时间（针对基于时间的出行模式）的双精度值列表。可以输入一个距离值或多个距离值。汇总处于您所输入距离内（包含该距离）的要素。距离值的 units 由 units 参数提供。	Double
距离单位 (可选)	如果邻近类型为基于直线或基于距离的出行模式，则此单位应为与距离中指定的距离值一同使用的线性单位。有效选项包括米、千米、英尺、码和英里。如果邻近要素类型为基于时间的出行模式，则值将包括秒、分钟和小时。英里—英里英尺—英尺千米—千米米—米码—码秒—秒分—分小时—小时	String
时间 (可选)	指定行驶时间是否应该考虑交通状况。要在分析中使用流量，必须将邻近要素类型设置为基于出行时间的模式。时间值表示出行开始或离开输入点的时间。支持两种类型的流量：典型流量和实时流量。典型流量将参考行驶速度，该速度由一周内每 5 分钟执行一次测速所得的历史平均速度组成。实时流量从流量源（用于处理电话调查记录、传感器和其他数据源）检索速度以记录实际行驶速度并预测近期速度。要确保任务在适用的位置使用典型流量，请选择该周的某个时间和某天，并将这天转换为 1990 年的以下某个日期：星期一 - 1/1/1990 星期二 - 1/2/1990 星期三 - 1/3/1990 星期四 - 1/4/1990 星期五 - 1/5/1990 星期六 - 1/6/1990 星期日 - 1/7/1990 尽管用来表示该周各天的日期来自 1990 年，但典型流量将根据近期的交通趋势（通常在过去的几个月中）进行计算。要在适用的情况下使用实时流量，请选择当前时间 12 小时范围内的日期和时间。Esri会保存 12 小时的实时交通数据并参考 12 小时以后的预测数据。如果为此参数指定的时间和日期在 24 小时时间窗之外，或分析中的行驶时间继续超过预测数据窗，则任务将回退到典型流量速度。	Date
时区 (可选)	指定所选时间的一个或多个时区。有两个选项可供选择：GeoLocal（默认）和 UTC。 Geolocal—时间值采用输入点所在的一个或多个时区。该选项会导致各时区中分析的起始时间有所变动。这是默认设置。协调世界时间 (UTC)—时间值采用协调世界时间 (UTC)。无论时区差异，所有点的开始时间均应同步。	String
返回边界 (可选)	指定是返回输入几何还是返回直线或出行模式缓冲区几何。选中 - 输出图层将包含由指定邻近要素类型定义的区域。例如，如果使用 5 英里的直线距离，则输出中将包含输入邻近要素图层要素周围以 5 英里为半径的区域。这是默认设置。未选中 - 输出图层将包含与输入邻近要素图层相同的要素。	Boolean
添加形状汇总属性 (可选)	根据输入汇总要素的形状计算统计数据，例如输入汇总图层中各个面内汇总要素线的长度或面的面积。选中 - 计算形状汇总属性。这是默认设置。未选中 - 不计算形状汇总属性。	Boolean
形状单位 (可选)	如果要汇总邻近要素的形状，请指定形状汇总的单位。如果输入汇总要素为面，则有效选项为英亩、公顷、平方米、平方千米、平方英尺、平方码和平方英里。如果输入汇总要素为线，则有效选项为米、千米、英尺、码和英里。英里—英里英尺—英尺千米—千米米—米码—码英亩—英亩公顷—公顷平方米—平方米平方千米—平方千米平方英尺—平方英尺平方码—平方码平方英里—平方英里	String
汇总字段 (可选)	字段名称及您想要为各面内全部点计算的统计汇总类型的列表。始终返回每个面内的点计数。支持的统计数据类型如下： Sum - 总值。 Minimum - 最小值。 Max - 最大值。 Mean - 平均值。 Standard deviation - 标准差。	Value Table
分组条件字段 (可选)	这是输入汇总要素的一个字段，可用于分别计算每个唯一属性值的统计数据。例如，假设输入汇总要素包含存储危险材料的企业的点位置，且其中一个字段为 HazardClass，字段中含有用于描述所存储危险材料类型的代码。要根据每个 HazardClass 唯一值计算汇总，请将其用作分组条件字段。	Field
添加少数和众数属性 (可选)	仅当使用分组条件字段时适用。如果选中，将对各个边界内每个组字段的少数（所占比例最小）或众数（所占比例最大）属性值进行计算。前缀为众数_和少数_的两个新字段将添加至输出图层。未选中 - 不添加少数和众数字段。这是默认设置。选中 - 添加少数和众数字段。	Boolean
添加组百分比 (可选)	仅当使用分组条件字段时适用。如果选中，则系统将针对每个输入邻近要素计算各唯一组值的百分比。未选中 - 不添加百分比字段。这是默认设置。选中 - 添加百分比字段。	Boolean

派生输出

标注	说明	数据类型
输出要素服务	输出汇总图层。	要素集
输出分组表	如果提供了分组条件字段，则此工具将针对每个唯一组输出含有计算统计数据的表格。	记录集

arcpy.sfa.SummarizeNearby(sumNearbyLayer, summaryLayer, outputName, nearType, {distances}, {units}, {timeOfDay}, {timeZoneForTimeOfDay}, {returnBoundaries}, {sumShape}, {shapeUnits}, {summaryFields}, {groupByField}, {minorityMajority}, {percentShape})

名称	说明	数据类型
sumNearbyLayer	用作输入汇总图层中到要素的距离的测量起点的点、线或面要素。	Feature Set
summaryLayer	点、线或面要素。将汇总此图层中与输入邻近要素图层中的要素相距指定距离的要素。	Feature Set
outputName	要在门户中创建的输出图层的名称。	String
nearType	定义要使用的距离测量方式：按直线距离进行测量，或利用多种交通方式（称为出行模式）通过测量沿街道网络的行驶时间或行驶距离来进行测量。 STRAIGHTLINE—使用直线欧式距离测量法。这是默认设置。 DRIVINGDISTANCE—使用汽车行驶距离。 DRIVINGTIME—使用在指定汽车行驶时间内行驶的距离。 TRUCKINGDISTANCE—使用卡车行驶距离。 TRUCKINGTIME—使用在指定卡车行驶时间内行驶的距离。 WALKINGDISTANCE—使用沿街道步行的距离。 WALKINGTIME—使用指定步行时间内行驶的距离。	String
distances [distances,...] (可选)	定义搜索距离（针对直线和基于距离的出行模式）或时间（针对基于时间的出行模式）的双精度值列表。可以输入一个距离值或多个距离值。汇总处于您所输入距离内（包含该距离）的要素。距离值的 units 由 units 参数提供。	Double
units (可选)	如果邻近类型为基于直线或基于距离的出行模式，则此单位应为与距离中指定的距离值一同使用的线性单位。有效选项包括米、千米、英尺、码和英里。如果邻近要素类型为基于时间的出行模式，则值将包括秒、分钟和小时。 MILES—英里 FEET—英尺 KILOMETERS—千米 METERS—米 YARDS—码 SECONDS—秒 MINUTES—分 HOURS—小时	String
timeOfDay (可选)	指定行驶时间是否应该考虑交通状况。要在分析中使用流量，必须将邻近要素类型设置为基于出行时间的模式。时间值表示出行开始或离开输入点的时间。支持两种类型的流量：典型流量和实时流量。典型流量将参考行驶速度，该速度由一周内每 5 分钟执行一次测速所得的历史平均速度组成。实时流量从流量源（用于处理电话调查记录、传感器和其他数据源）检索速度以记录实际行驶速度并预测近期速度。要确保任务在适用的位置使用典型流量，请选择该周的某个时间和某天，并将这天转换为 1990 年的以下某个日期：星期一 - 1/1/1990 星期二 - 1/2/1990 星期三 - 1/3/1990 星期四 - 1/4/1990 星期五 - 1/5/1990 星期六 - 1/6/1990 星期日 - 1/7/1990 尽管用来表示该周各天的日期来自 1990 年，但典型流量将根据近期的交通趋势（通常在过去的几个月中）进行计算。要在适用的情况下使用实时流量，请选择当前时间 12 小时范围内的日期和时间。Esri会保存 12 小时的实时交通数据并参考 12 小时以后的预测数据。如果为此参数指定的时间和日期在 24 小时时间窗之外，或分析中的行驶时间继续超过预测数据窗，则任务将回退到典型流量速度。	Date
timeZoneForTimeOfDay (可选)	指定所选时间的一个或多个时区。有两个选项可供选择：GeoLocal（默认）和 UTC。 GEOLOCAL—时间值采用输入点所在的一个或多个时区。该选项会导致各时区中分析的起始时间有所变动。这是默认设置。 UTC—时间值采用协调世界时间 (UTC)。无论时区差异，所有点的开始时间均应同步。	String
returnBoundaries (可选)	指定是返回输入几何还是返回直线或出行模式缓冲区几何。 RETURN_BOUNDARIES—输出图层将包含由指定邻近要素类型定义的区域。例如，如果使用 5 英里的直线距离，则输出中将包含输入邻近要素图层要素周围以 5 英里为半径的区域。这是默认设置。 RETURN_INPUT—输出图层将包含与输入邻近要素图层相同的要素。	Boolean
sumShape (可选)	根据输入汇总要素的形状计算统计数据，例如输入汇总图层中各个面内汇总要素线的长度或面的面积。 ADD_SHAPE_SUM—计算形状汇总属性。这是默认设置。 NO_SHAPE_SUM—不计算形状汇总属性。	Boolean
shapeUnits (可选)	如果要汇总邻近要素的形状，请指定形状汇总的单位。如果输入汇总要素为面，则有效选项为英亩、公顷、平方米、平方千米、平方英尺、平方码和平方英里。如果输入汇总要素为线，则有效选项为米、千米、英尺、码和英里。 MILES—英里 FEET—英尺 KILOMETERS—千米 METERS—米 YARDS—码 ACRES—英亩 HECTARES—公顷 SQUAREMETERS—平方米 SQUAREKILOMETERS—平方千米 SQUAREFEET—平方英尺 SQUAREYARDS—平方码 SQUAREMILES—平方英里	String
summaryFields [[Field, Statistic],...] (可选)	字段名称及您想要为各面内全部点计算的统计汇总类型的列表。始终返回每个面内的点计数。支持的统计数据类型如下： SUM - 总值。 MIN - 最小值。 MAX - 最大值。 MEAN - 平均值。 STD - 标准差。	Value Table
groupByField (可选)	这是输入汇总要素的一个字段，可用于分别计算每个唯一属性值的统计数据。例如，假设输入汇总要素包含存储危险材料的企业的点位置，且其中一个字段为 HazardClass，字段中含有用于描述所存储危险材料类型的代码。要根据每个 HazardClass 唯一值计算汇总，请将其用作分组条件字段。	Field
minorityMajority (可选)	仅当使用分组条件字段时适用。如果指定了 ADD_MIN_MAJ，将对各个边界内每个组字段的少数（所占比例最小）或众数（所占比例最大）属性值进行计算。前缀为众数_和少数_的两个新字段将添加至输出图层。 NO_MIN_MAJ—不添加少数和众数字段。这是默认设置。 ADD_MIN_MAJ—添加少数和众数字段。	Boolean
percentShape (可选)	仅当使用分组条件字段时适用。如果选中，则系统将针对每个输入邻近要素计算各唯一组值的百分比。 NO_PERCENT—不添加百分比字段。这是默认设置。 ADD_PERCENT—添加百分比字段。	Boolean

派生输出

名称	说明	数据类型
resultLayer	输出汇总图层。	要素集
groupBySummary	如果提供了分组条件字段，则此工具将针对每个唯一组输出含有计算统计数据的表格。	记录集

摘要

插图

使用情况

参数

派生输出

派生输出

环境

特殊情况

许可信息

相关主题

在本主题中