返回顶部

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

在本主题中

  1. 摘要
  2. 插图
  3. 使用情况
  4. 参数
  5. 环境
  6. 许可信息

摘要

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

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

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

插图

邻近汇总

使用情况

  • 邻近汇总工具需要两个输入图层：用于测量距离的图层和要汇总的图层。两个图层均可为点、线或面。第一个输入图层最多可包含 1000 个要素。

  • 邻近距离可基于直线距离或多种不同的出行模式，使用时间或距离作为测量单位。仅当您的第一个输入图层包含点要素时才启用出行模式。您可通过输入多个距离或时间来创建多个输出面。

  • 一些出行模式具有使用交通状况的选项。使用交通状况时，结果可能取决于当周指定日期和时间的实时状况或典型状况。实时交通状况可能与当前时间偏移多达 12 小时。全天均可将典型状况的时间间隔设置为 15 分钟。

  • 出行模式可由组织管理员进行配置。管理员还可以添加新的出行模式或移除并非组织必需的出行模式。默认距离测量单位将为英里或千米，具体取决于配置文件中的 units 设置。

参数

对话框Python

标注说明数据类型
输入邻近要素图层

用作输入汇总图层中到要素的距离的测量起点的点、线或面要素。

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

如果提供了分组条件字段，则此工具将针对每个唯一组输出含有计算统计数据的表格。

记录集

环境

范围

许可信息

  • Basic: 需要 ArcGIS Enterprise 中的帐户有执行分析的权限
  • Standard: 需要 ArcGIS Enterprise 中的帐户有执行分析的权限
  • Advanced: 需要 ArcGIS Enterprise 中的帐户有执行分析的权限

相关主题

  • 汇总数据工具集概述
  • 查找地理处理工具

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 插图
  3. 使用情况
  4. 参数
  5. 环境
  6. 许可信息