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}}})