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