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