Python ArcGIS create_drive_time_areas用法及代碼示例

本文簡要介紹 python 語言中 arcgis.features.analysis.create_drive_time_areas 的用法。

用法:

arcgis.features.analysis.create_drive_time_areas(input_layer, break_values=[5, 10, 15], break_units='Minutes', travel_mode=None, overlap_policy='Overlap', time_of_day=None, time_zone_for_time_of_day='GeoLocal', output_name=None, context=None, gis=None, estimate=False, point_barrier_layer=None, line_barrier_layer=None, polygon_barrier_layer=None, future=False, travel_direction='AwayFromFacility', show_holes=False, include_reachable_streets=False)

返回：

result_layer：如果指定了output_name，則為 FeatureLayer ，否則為特征集合。

create_drive_time_areas 方法創建可以在給定行駛時間或行駛距離內到達的區域。它可以幫助您回答以下問題：

• 五分鍾內我能從這裏開車多遠？

• 我的商店的three-mile 行駛距離內涵蓋哪些區域？

• 我們的消防站四分鍾內有哪些區域？

有關運行此任務的Spatial Analysis Service 的詳細信息，請參閱Create Drive-Time Areas。

Parameter	Description
input_layer	所需的點要素圖層。將圍繞其繪製基於交通方式的旅行區域的點。請參閱特征輸入。
travel_mode	可選字符串或字典。指定分析的運輸方式。 選擇列表：【‘行車距離’、‘行車時間’、‘農村行車距離’、‘農村行車時間’、‘行車距離’、‘行車時間’、‘步行距離’、‘步行時間’】 默認為“行駛時間”。
break_values	可選的浮點數列表。要創建的多邊形的大小。 break_values 的單位由break_units 參數指定。 通過在列表中設置許多唯一值，可以在每個輸入位置周圍生成不同大小的多邊形。 默認值為 [5, 10, 15]。
break_units	可選字符串。 break_values 參數的單位。 要創建顯示在給定時間內您可以沿著道路或人行道走多遠的區域，請指定時間單位。或者，指定距離單位以生成以最大行駛距離為界的區域。 當travel_mode 是基於時間的時，應該為break_units 指定時間單位。當travel_mode 基於距離時，應為break_units 指定距離單位。 選擇列表：[“秒”、“分鍾”、“小時”、“英尺”、“米”、“公裏”、“英尺”、“英裏”、“碼”] 默認值為“分鍾”。
overlap_policy	可選字符串。確定如何處理重疊區域。 選擇列表：[‘重疊’、‘融合’、‘分割’] Overlap - 保留重疊區域。這是默認設置。 Dissolve - 重疊區域按中斷值組合。由於區域已溶解，因此當您需要知道在給定時間或距離內可以到達的區域但不需要知道哪些輸入點最近時，請使用此選項。 Split - 重疊區域在中間分割。當您需要知道距覆蓋區域最近的一個輸入位置時，請使用此選項。 默認為“重疊”
time_of_day	可選的日期時間.日期時間。指定出行時間是否應考慮交通狀況。要在分析中使用流量，請將 measurement_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 點，分析中引用了實時交通速度；否則，將參考典型的交通速度。 “time_of_day”: datetime(2015, 3, 18, 10, 20) # 10:20, 18 March 2015. 如果當前時間在 2015 年 3 月 17 日晚上 10:20 到 2015 年 3 月 18 日晚上 10:20 之間，分析中引用了實時交通速度；否則，將參考典型的交通速度。
time_zone_for_time_of_day	可選字符串。指定time_of_day 參數的一個或多個時區。 選擇列表：[‘GeoLocal’, ‘UTC’] GeoLocal-refers 到 originsLayer 點所在的時區。 UTC-refers 到協調世界時。 默認值為“GeoLocal”。
output_name	可選字符串或 FeatureLayer 。現有要素圖層將導致新圖層附加到要素服務。如果 overwrite 在上下文中為 True，則新層將覆蓋現有層。如果未指示output_name，則創建新的 FeatureCollection 。
context	可選字典。處理範圍和輸出空間參考等附加設置。對於create_drive_time_areas，有三個設置。 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，則將返回運行該操作所需的估計積分數。
point_barrier_layer	可選層。指定在基礎街道上行駛時充當臨時限製(即障礙)的一個或多個點要素。 點障礙可以模擬倒下的樹、事故、倒塌的電線或任何完全阻塞街道特定位置交通的東西。允許在街上旅行，但不允許穿過障礙物。請參閱特征輸入。
line_barrier_layer	可選層。指定一個或多個線要素，禁止在線與街道相交的任何地方行駛。 線障礙禁止在障礙與街道相交的任何地方旅行。例如，可以使用線障礙對阻礙跨多個街道段的交通的遊行或抗議進行建模。請參閱特征輸入。
polygon_barrier_layer	可選字符串。指定一個或多個麵要素，以完全限製在麵相交的街道上的通行。 這種類型的屏障的一種用途是模擬覆蓋街道網絡區域的洪水，並使那裏的道路無法通行。請參閱特征輸入。
future	可選布爾值。如果為 True，則將返回 future 對象，並且進程不會等待任務完成。默認為False，表示等待結果。
travel_direction	可選字符串。指定用於生成行駛區域的行駛方向是朝向還是遠離輸入位置。 值：AwayFromFacility 或 TowardsFacility 行進方向會影響區域的生成方式。 CreateDriveTimeAreas 將遵守 one-way 街道，避免非法轉彎，並根據行駛方向遵守其他規則。您應該根據輸入位置的類型和分析的上下文來選擇行進方向。例如，披薩外賣店的drive-time 區域應該在遠離設施的地方創建，而醫院的drive-time 區域應該在設施附近創建。
show_holes	可選的布爾值。設置為 true 時，如果某些街道在不超過分界線或由於出行模式施加的出行限製而無法到達時，輸出區域將包括洞。
include_reachable_streets	可選字符串。僅在指定 output_name 時適用。當 True(並且指定了 output_name)時，在輸出 Feature Layer 中創建名為 Reachable Streets 的第二層。 該圖層包含用於定義行駛時間區域多邊形的街道。如果您希望獲得比 drive-time 區域所包含的特定行駛距離內實際覆蓋的街道更準確的結果，請將其設置為 true。

例子：

# USAGE EXAMPLE: To create drive time areas around USA airports, within the specified extent.

target_area4 = create_drive_time_areas(airport_lyr,
                               break_values=[2, 4],
                               break_units='Hours',
                               travel_mode='Trucking Time',
                               overlap_policy='Split',
                               time_of_day=datetime(2019, 5, 13, 7, 52),
                               output_name='create_drive_time_areas',
                               context={"extent":{"xmin":-11134400.655784884,"ymin":3368261.7800108367,"xmax":-10682810.692676282,"ymax":3630899.409198575,"spatialReference":{"wkid":102100,"latestWkid":3857}}})