本文簡要介紹 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')
相關用法
- Python ArcGIS summarize_elevation用法及代碼示例
- Python ArcGIS summarize_categorical_raster用法及代碼示例
- Python ArcGIS summarize_raster_within用法及代碼示例
- Python ArcGIS summarize_center_and_dispersion用法及代碼示例
- Python ArcGIS summarize_attributes用法及代碼示例
- Python ArcGIS summarize_within用法及代碼示例
- Python ArcGIS sum用法及代碼示例
- Python ArcGIS subset_multidimensional_raster用法及代碼示例
- Python ArcGIS suggest用法及代碼示例
- Python ArcGIS sample用法及代碼示例
- Python ArcGIS square用法及代碼示例
- Python ArcGIS sqrt用法及代碼示例
- Python ArcGIS slope用法及代碼示例
- Python ArcGIS segment_mean_shift用法及代碼示例
- Python ArcGIS set_null用法及代碼示例
- Python ArcGIS std用法及代碼示例
- Python ArcGIS sinh用法及代碼示例
- Python ArcGIS segment用法及代碼示例
- Python ArcGIS sin用法及代碼示例
- Python ArcGIS power用法及代碼示例
- Python ArcGIS APIKeyManager.get用法及代碼示例
- Python ArcGIS KnowledgeGraph.named_object_type_delete用法及代碼示例
- Python ArcGIS ContentManager.unshare_items用法及代碼示例
- Python ArcGIS ImageryLayer.thumbnail用法及代碼示例
- Python ArcGIS FormFieldElement用法及代碼示例
注:本文由純淨天空篩選整理自arcgis.com大神的英文原創作品 arcgis.features.analysis.summarize_nearby。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。