Python ArcGIS create_buffers用法及代码示例

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

用法:

arcgis.features.analysis.create_buffers(input_layer, distances=[], field=None, units='Meters', dissolve_type='None', ring_type='Disks', side_type='Full', end_type='Round', output_name=None, context=None, gis=None, estimate=False, future=False)

返回：

result_layer：如果指定了output_name，则为 FeatureLayer ，否则为 FeatureCollection 。

create_buffers 任务创建覆盖距点、线或面要素给定距离的面。缓冲区通常用于创建可以使用 overlay_layers 等工具进一步分析的区域。例如，如果问题是“学校 1 英里范围内有哪些建筑物？”，可以通过在学校周围创建 one-mile 缓冲区并将缓冲区与包含建筑物足迹的图层重叠来找到答案。最终结果是学校一英里内的这些建筑物的一层。

Parameter	Description
input_layer	所需的点、线或面要素图层。要缓冲的输入特征。请参阅特征输入。
distances	用于缓冲输入特征的可选浮点列表。将被缓冲的距离。您必须为 distances 或 field 参数提供值。您可以输入单个距离值或多个值。距离值的单位由单位参数提供。
field	可选字符串。 input_layer 上包含缓冲距离的字段。缓冲区将使用字段值创建。与 distances 参数不同，字段输入不支持多个距离。
units	可选字符串。与在距离中指定或包含在字段值中的距离值一起使用的线性单位。 选择列表：[“米”、“公里”、“英尺”、“英里”、“航海英里”、“码”] 默认值为“米”。
dissolve_type	可选字符串。确定如何处理重叠缓冲区。 选择列表：[‘无’，‘溶解’] None - 保留重叠区域。这是默认设置。 Dissolve - 重叠区域合并。
ring_type	可选字符串。确定如何处理 multiple-distance 缓冲区。 选择列表：[‘Disks’, ‘Rings’] Disks - 缓冲区是同心的并且会重叠。例如，如果您的距离是 10 和 14，则结果将是两个缓冲区，一个从 0 到 10，一个从 0 到 14。这是默认设置。 Rings 缓冲区不会重叠。例如，如果您的距离是 10 和 14，则结果将是两个缓冲区，一个从 0 到 10，一个从 10 到 14。
side_type	可选字符串。缓冲线要素时，可以选择要缓冲的线的哪一侧。 通常，您选择两侧(Full，这是默认设置)。左右确定就像您从直线的第一个 x,y 坐标(起始坐标)走到直线的最后一个 x,y 坐标(结束坐标)一样。选择左或右通常意味着您知道您的线要素是在特定方向创建和存储的(例如，河流网络中的上游或下游)。 缓冲面要素时，可以选择缓冲区是包括还是排除正在缓冲的面。 选择列表：[‘Full’, ‘Left’, ‘Right’, ‘Outside’] Full - 行的两边都将被缓冲。这是线要素的默认设置。 Left - 仅缓冲行的右侧。 Right - 仅缓冲行的右侧。 Outside 缓冲多边形时，正在缓冲的多边形被排除在结果缓冲区中。 如果未提供side_type，则正在缓冲的多边形将包含在结果缓冲区中。这是面要素的默认设置。
end_type	可选字符串。线输入要素末端缓冲区的形状。此参数对面输入要素无效。在行的末端，缓冲区可以是圆形的(Round)或笔直的(Flat)。 选择列表：['圆形'，'扁平'] Round - 缓冲区将在行尾四舍五入。这是默认设置。 Flat - 缓冲区在行尾是平坦的。
output_name	可选字符串或 FeatureLayer 。现有要素图层将导致新图层附加到要素服务。如果 overwrite 在上下文中为 True，则新层将覆盖现有层。如果未指示output_name，则创建新的 FeatureCollection 。
context	可选字典。处理范围和输出空间参考等附加设置。对于create_buffers，有三个设置。 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}
gis	可选，运行此工具的 GIS 。如果未指定，则使用活动 GIS。
estimate	可选的布尔值。如果为 True，则将返回运行该操作所需的估计积分数。
future	可选布尔值。如果为 True，则将返回 future 对象，并且进程不会等待任务完成。默认为False，表示等待结果。

例子：

# USAGE EXAMPLE: To create 5 mile buffer around US parks, within the specified extent.

polygon_lyr_buffer = create_buffers(input_layer=parks_lyr,
                         distances=[5],
                         units='Miles',
                         ring_type='Rings',
                         end_type='Flat',
                         output_name='create_buffers',
                         context={"extent":{"xmin":-12555831.656684224,"ymin":5698027.566358956,"xmax":-11835489.102124758,"ymax":6104672.556836072,"spatialReference":{"wkid":102100,"latestWkid":3857}}})