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