Python ArcGIS summarize_nearby用法及代码示例

本文简要介绍 python 语言中 arcgis.features.analysis.summarize_nearby 的用法。

用法:

arcgis.features.analysis.summarize_nearby(sum_nearby_layer, summary_layer, near_type='StraightLine', distances=[], units='Meters', time_of_day=None, time_zone_for_time_of_day='GeoLocal', return_boundaries=True, sum_shape=True, shape_units=None, summary_fields=[], group_by_field=None, minority_majority=False, percent_shape=False, output_name=None, context=None, gis=None, estimate=False, future=False)

返回：

result_layer : FeatureLayer 如果指定了 output_name，否则为 FeatureCollection 字典。

带有以下键的dict：

“result_layer”：层( FeatureCollection )

“group_by_summary”：层( FeatureCollection )

summarize_nearby 方法查找输入层中要素指定距离内的要素。距离可以测量为直线距离、drive-time距离(例如，10 分钟内)或行驶距离(5 公里内)。然后计算附近要素的统计数据。例如：

• 计算建议的新商店位置开车五分钟内的总人口。

• 计算建议的新商店位置在one-mile 行驶距离内的高速公路入口坡道数量，以用作衡量商店可达性的指标。

Parameter	Description
sum_nearby_layer	必需 FeatureLayer 。将测量点、线或面要素到 summary_layer 中要素的距离。请参阅特征输入。
summary_layer	必需的层。点、线或面要素。此图层中与sum_nearby_layer 中的要素在指定距离内的要素将被汇总。请参阅特征输入。
near_type	可选字符串。定义您要使用哪种距离测量，直线距离、行程时间或使用称为出行模式的各种交通方式沿街道网络行驶的距离。默认为 StraightLine 。 选择清单： StraightLine , Driving Distance , Driving Time , Rural Driving Distance , Rural Driving Time , Trucking Distance , Trucking Time , Walking Distance , Walking Time
distances	浮点值的可选列表。定义“直线”和基于距离的出行模式的搜索距离，或基于时间的出行模式的持续时间。您可以输入单个或多个值，用空格分隔每个值。将汇总在您输入的距离内(或等于)的要素。 distances 的单位由 units 参数提供。
units	可选字符串。如果 near_type 是 StraightLine 或基于距离的出行模式，则这是与以距离指定的距离值一起使用的线性单位。 选择列表：| [Meters，Kilometers，Feet，Yards，Miles] 如果near_type 是基于时间的出行模式，则可以使用以下值作为单位： 选择清单： [Seconds，Minutes，Hours] 默认值为“米”。
time_of_day	可选的日期时间.日期时间。指定出行时间是否应考虑交通状况。要在分析中使用流量，请将 near_type 设置为出行模式对象，其 impedance_attribute_name 属性设置为 travel_time 并为 time_of_day 分配一个值。 (具有其他 impedance_attribute_name 值的出行模式不支持交通。)time_of_day 值表示出行从起点开始或离开的时间。时间指定为 datetime.datetime。 该服务支持两种流量：典型流量和实时流量。典型的交通参考行驶速度由跨越一周的每个 five-minute 间隔的历史平均值组成。实时交通从处理电话探测记录、传感器和其他数据源的交通源中检索速度，以记录实际行驶速度并预测不久的将来的速度。 data coverage 页面显示 Esri 当前为其提供流量数据的国家/地区。 典型流量： 为确保任务在可用位置使用典型流量，请选择时间和星期几，然后将星期几转换为 1990 年以来的以下日期之一： 星期一 - 1990 年 1 月 1 日 星期二 - 1990 年 1 月 2 日 星期三 - 1990 年 1 月 3 日 星期四 - 1990 年 1 月 4 日 星期五 - 1990 年 1 月 5 日 星期六 - 1990 年 1 月 6 日 星期日 - 1990 年 1 月 7 日 将时间和日期设置为 datetime.datetime。 例如，求解下午 1:03。在星期四，将时间和日期设置为 1990 年 1 月 4 日下午 1:03；并转换为日期时间，例如： datetime.datetime(1990, 1, 4, 1, 3)。 实时流量： 要在可用的时间和地点使用实时流量，请选择时间和日期并转换为日期时间。 Esri 保存 4 小时的实时交通数据，表示未来 4 小时的预测数据。如果您为此参数指定的时间和日期在 24 小时时间窗口之外，或者分析中的行驶时间持续超过预测数据窗口，则任务将回退到典型的交通速度。 示例：从日期时间导入日期时间 “time_of_day”- datetime(1990, 1, 4, 1, 3) # 1990 年 1 月 4 日 13:03。周四下午 1:03 的典型流量 “time_of_day”- datetime(1990, 1, 7, 17, 0) # 1990 年 1 月 7 日 17:00。周日下午 5:00 的典型流量 “time_of_day”- datetime(2014, 10, 22, 8, 0) # 2014年10月22日8:00。如果当前时间在2014年10月21日晚上8:00到2014年10月22日晚上8:00之间, 分析中引用了实时交通速度；否则，参考典型的交通速度。 * “time_of_day”- datetime(2015, 3, 18, 10, 20) # 2015年3月18日10:20。如果当前时间在2015年3月17日晚上10:20到3月18日晚上10:20之间2015年，分析中参考了实时交通速度；否则，参考典型的交通速度。
time_zone_for_time_of_day	可选字符串。指定time_of_day 参数的一个或多个时区。 选择列表：[‘GeoLocal’, ‘UTC’] GeoLocal-refers 到 originsLayer 点所在的时区。 UTC-refers 到协调世界时。 默认值为“GeoLocal”。
return_boundaries	可选的布尔值。如果为真，result_layer 将包含由指定的 near_type 定义的区域。例如，如果使用 5 英里的“直线”，result_layer 将包含输入 sum_nearby_layer 要素周围半径为 5 英里的区域。 如果为 False，result_ayer 将包含与 sum_nearby_layer 相同的函数。 默认值为真。
sum_shape	可选的布尔值。一个布尔值，指示任务根据 summary_layer 的形状类型计算统计信息，例如 sum_within_layer 中每个多边形内 summary_layer 的线的长度或多边形的面积。 默认值为真。
shape_units	可选字符串。如果sum_shape 为真，则必须指定形状摘要的单位。值： 当summary_layer 包含多边形时：值：[‘Acres’, ‘Hectares’, ‘SquareMeters’, ‘SquareKilometers’, ‘SquareFeet’, ‘SquareYards’, ‘SquareMiles’] 当summary_layer 包含行时：值：[‘米’、‘公里’、‘英尺’、‘码’、‘英里’]
summary_fields	可选的字符串列表。要计算的字段名称和统计摘要类型的列表。请注意，默认情况下始终返回计数。 fieldName 是在输入连接层中找到的数字字段之一的名称。 statisticType 是以下之一： SUM - 将每个多边形中所有点的总值相加 MEAN - 计算每个多边形中所有点的平均值 MIN - 找出每个多边形中所有点的最小值 MAX - 查找每个多边形中所有点的最大值 STDDEV - 找出每个多边形中所有点的标准差 示例：[“fieldName summaryType”,”fieldName summaryType”, ...]
group_by_field	可选字符串。这是 summary_layer 函数的一个字段，可用于单独计算每个唯一属性值的统计信息。例如，假设 summary_layer 包含存储危险材料的企业点位置，其中字段之一是 HazardClass，其中包含说明存储的危险材料类型的代码。要按 HazardClass 的每个唯一值计算摘要，请使用 HazardClass 作为 group_by_field 字段。
minority_majority	可选的布尔值。此布尔参数仅在指定 group_by_field 时适用。如果为真，则计算每个附近区域内每个组字段的少数(最不占优势)或多数(最占优势)属性值。 result_layer 中添加了两个新字段，前缀为 Majority_ 和 Minority_。 默认值为假。
percent_shape	可选的布尔值。此布尔参数仅在指定 group_by_field 时适用。如果设置为 true，则会为每个 sum_nearby_layer 函数计算每个唯一 group_by_field 值的百分比。 默认值为假。
output_name	可选字符串或 FeatureLayer 。现有要素图层将导致新图层附加到要素服务。如果 overwrite 在上下文中为 True，则新层将覆盖现有层。如果未指示output_name，则创建新的 FeatureCollection 。
context	可选字典。处理范围和输出空间参考等附加设置。对于summarize_nearby，有三个设置。 extent - 定义分析区域的边界框。仅分析input_layer 中与边界框相交的那些特征。 outSR - 输出要素将投影到 wkid 引用的输出空间参考中。 overwrite - 如果为 True，则 output_name 中的要素层将被新要素层覆盖。适用于 ArcGIS Online 或 Enterprise 10.9.1+ # Example Usage context = {"extent": {"xmin": 3164569.408035, "ymin": -9187921.892449, "xmax": 3174104.927313, "ymax": -9175500.875353, "spatialReference":{"wkid":102100,"latestWkid":3857}}, "outSR": {"wkid": 3857}, "overwrite": True}
estimate	可选的布尔值。返回操作的信用数。
future	可选布尔值。如果为 True，则将返回 future 对象，并且进程不会等待任务完成。默认为False，表示等待结果。

例子：

# USAGE EXAMPLE: To find hospital facilities that are within 5 miles of a school.
summarize_nearby(sum_nearby_layer=item2.layers[0],
                 summary_layer=item1.layers[0],
                 near_type='StraightLine',
                 distances=[5],
                 units='Miles',
                 time_zone_for_time_of_day='GeoLocal',
                 return_boundaries=False,
                 sum_shape=True,
                 shape_units=None,
                 output_name='nearest hospitals to schools')