Python ArcGIS enrich_layer用法及代码示例

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

用法:

arcgis.features.analysis.enrich_layer(input_layer, data_collections=[], analysis_variables=[], country=None, buffer_type=None, distance=None, units=None, output_name=None, context=None, gis=None, estimate=False, return_boundaries=False, future=False)

enrich_layer 方法通过获取有关数据位置周围的人员、地点和企业的事实来丰富您的数据。例如：什么样的人住在这里？人们喜欢在这个领域做什么？他们的生活习惯和生活方式是怎样的？这个领域有哪些企业？

结果将是一个新的输入特征层，其中包括来自给定数据集合的所有人口统计和地理信息。

Parameter	Description
input_layer	必需的层。用新数据丰富的函数。请参阅特征输入。
data_collections	可选的字符串列表。此可选参数定义您要用于丰富函数的数据集合。它的值是一个字符串列表。如果不提供此参数，则必须提供analysis_variables 参数。 有关数据收集和此参数值的更多信息，请访问 Esri Demographics site。
analysis_variables	可选的字符串列表。该参数定义了数据集合中要用于特征的特定变量。它的值是“dataCollection.VariableName” 形式的字符串列表。如果不提供此参数，则必须提供 dataCollections 参数。您可以提供这两个参数。例如，如果您想要 KeyGlobalFacts 数据集合中的所有变量，请在 dataCollections 参数中指定它，并将此参数用于其他集合中的特定变量。 有关数据集合中变量的更多信息，请访问Esri Demographics site。每个数据集都有一个说明变量及其名称的 PDF 文件。
country	可选字符串。此可选参数进一步定义从数据收集返回的内容。例如，您的输入要素可能是西欧的国家/地区，并且您希望使用 KeyWEFacts 数据集合来丰富它们。但是，您只需要法国的数据，而不是输入图层中的每个国家/地区的数据。该值是two-character 国家代码。 有关数据收集和此参数值的更多信息，请访问 Esri Demographics site。
buffer_type(如果 input_layer 包含点或线要素，则为必需)	可选字符串。如果输入要素是点或线，则必须在要素周围定义要丰富的区域。将丰富在您输入的距离内(或等于)的要素。 选择列表：['直线'、'行车距离'、'行车时间'、'农村行车距离'、'农村行车时间'、'行车距离'、'行车时间'、'步行距离'、'步行时间']
距离(如果 input_layer 包含点或线要素，则为必需)	可选浮点数。定义搜索距离或时间的值。距离值的单位由 units 参数提供。
units	可选字符串。与距离参数中指定的距离值一起使用的线性单位。 选择列表：[“米”、“公里”、“英尺”、“码”、“英里”、“秒”、“分钟”。 '小时']
output_name	可选字符串或 FeatureLayer 。现有要素图层将导致新图层附加到要素服务。如果 overwrite 在上下文中为 True，则新层将覆盖现有层。如果未指示output_name，则创建新的 FeatureCollection 。
context	可选字典。处理范围和输出空间参考等附加设置。对于enrich_layer，有三个设置。 extent - 定义分析区域的边界框。仅分析input_layer 中与边界框相交的那些特征。 outSR - 输出要素将投影到 wkid 引用的输出空间参考中。 overwrite - 如果为 True，则 output_name 中的要素层将被新要素层覆盖。适用于 ArcGIS Online 或 Enterprise 11+
gis	可选，运行此工具的 GIS 。如果未指定，则使用活动 GIS。
return_boundaries	可选的布尔值。仅适用于点和线输入要素。如果为 True，则返回区域的结果层。返回区域由指定的buffer_type 定义。例如，如果使用距离为 5 英里的 StraightLine 的 buffer_type，您的结果将包含输入要素周围半径为 5 英里的区域和请求的 analysis_variables 变量。如果为 False，则结果层将返回与具有 analysis_variables 变量的输入层相同的特征。 默认值为假。
future	可选，如果为 True，将返回未来对象，并且进程不会等待任务完成。默认为False，表示等待结果。

:如果指定了output_name，则返回 FeatureLayer ，否则返回 FeatureCollection 。如果 future = True ，则结果是 Future 对象。调用 result() 获取响应。

例子：

# USAGE EXAMPLE: To enrich US block groups with population as analysis variable.
blkgrp_enrich = enrich_layer(block_groups,
                             analysis_variables=["AtRisk.MP27002A_B"],
                             country='US',
                             output_name='enrich layer')