当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Python ArcGIS generate_service_areas用法及代码示例


本文简要介绍 python 语言中 arcgis.network.analysis.generate_service_areas 的用法。

用法:

arcgis.network.analysis.generate_service_areas(facilities, break_values='5 10 15', break_units='Minutes', analysis_region=None, travel_direction='Away From Facility', time_of_day=None, use_hierarchy=False, uturn_at_junctions='Allowed Only at Intersections and Dead Ends', polygons_for_multiple_facilities='Overlapping', polygon_overlap_type='Rings', detailed_polygons=False, polygon_trim_distance=None, polygon_simplification_tolerance=None, point_barriers=None, line_barriers=None, polygon_barriers=None, restrictions=None, attribute_parameter_values=None, time_zone_for_time_of_day='Geographically Local', travel_mode='Custom', impedance='Drive Time', save_output_network_analysis_layer=False, overrides=None, time_impedance=None, distance_impedance=None, polygon_detail=None, output_type=None, output_format=None, gis=None, future=False)

返回:

以下为命名元组:

generate_service_areas.png

generate_service_areas 工具确定设施周围的网络服务区域。网络服务区是一个区域,它包含可以从一个或多个设施在给定距离或行程时间内访问的所有街道。例如,一个设施的 10 分钟服务区包括从该设施 10 分钟内可以到达的所有街道。服务区通常用于可视化和衡量可访问性。例如,杂货店周围的three-minute drive-time 多边形可以确定哪些居民能够在三分钟内到达商店,从而更有可能在那里购物。

Parameter

Description

facilities

必需 FeatureSet 。生成服务区的设施。您最多可以加载 1,000 个设施。设施特征集具有关联的属性表。属性表中的字段列出并说明如下:

  • ObjectID :system-managed ID 字段。

  • Name :设施的名称。如果未指定名称,则在求解时自动生成名称。

当多个设施点的多边形参数设置为重叠或不重叠时,输入设施点的所有字段都包含在输出多边形中。输入设施上的 ObjectID 字段将传输到输出面的 FacilityOID 字段。

break_values

必需的字符串。指定要为每个设施点生成的服务区多边形的大小和数量。单位由中断单位值确定。

可以设置多个多边形中断以创建每个设施的同心服务区。例如,要查找每个设施点的 2、3 和 5 英里服务区,请键入 2 3 5,用空格分隔值,并将中断单位设置为英里。您指定的中断值的数量没有限制。

最大中断值的大小不能超过相当于 300 分钟或 300 英里(482.80 公里)的值。生成详细多边形时,最大 service-area 大小限制为 15 分钟和 15 英里(24.14 公里)。

break_units

必需的字符串。 Break Values 参数的单位。您为此参数选择的单位决定了该工具是通过测量行驶距离还是行驶时间来创建服务区。选择一个时间单位来测量驾驶时间。要测量行驶距离,请选择距离单位。您的选择还决定了该工具将在结果中报告总行驶时间或距离的单位。选项有: 米 公里 英尺 码 英里 海里 秒 分 小时 天

选择列表:[“米”、“公里”、“英尺”、“码”、“英里”、“海里”、“秒”、“分钟”、“小时”、“天”]

analysis_region

可选字符串。指定执行分析的区域。如果未为此参数指定值,该工具将根据输入点的位置自动计算区域名称。建议设置区域名称以加快工具执行速度。

选择列表:['NorthAmerica', 'SouthAmerica', 'Europe', 'MiddleEastAndAfrica', 'India', 'SouthAsia', 'SouthEastAsia', 'Thailand', 'Taiwan', 'Japan', 'Oceania', 'Greece ', '朝鲜']

travel_direction

可选字符串。指定用于生成服务区面的行进方向是朝向设施点还是远离设施点。

  • Away From Facility - 服务区在远离设施的方向生成。

  • Towards Facility - 服务区朝设施方向创建。

行进方向可能会改变多边形的形状,因为街道两侧的阻抗可能不同或可能存在 one-way 限制,例如 one-way 街道。您应该选择的方向取决于您的服务区域分析的性质。例如,披萨外卖店的服务区应远离设施创建,而医院的服务区应靠近设施创建。

选择列表:['Away From Facility'、'Towards Facility']

time_of_day

可选的日期时间。离开或到达设施的时间。此值的解释取决于旅行是朝向还是远离设施点。如果出行方向设置为远离设施点,则表示出发时间。如果 Travel Direction 设置为 Toward Facility,则它表示到达时间。

您可以使用 Time of Day 参数的时区来指定此时间和日期是指 UTC 还是设施所在的时区。

重复求解相同的分析,但使用不同的时间值,可以让您了解设施的覆盖范围如何随时间变化。例如,消防站周围的five-minute 服务区可能在清晨开始很大,在早高峰时段缩小,在上午晚些时候扩大,等等,全天。

use_hierarchy

可选的布尔值。指定在查找设施点和事件点之间的最佳路径时是否应使用层次结构。

选中 (True) - 使用层次结构属性进行分析。使用层次结构会导致求解器更喜欢高阶边而不是低阶边。分层求解速度更快,它们可用于模拟驾驶员在possible-even 时选择在高速公路上行驶而不是在地方道路上行驶的偏好,如果这意味着更长的行程。

未选中 (False) - 不使用层次结构属性进行分析。不使用等级会产生沿网络数据集的所有边测量的准确服务区,无论等级级别如何。

无论是否选中使用层次结构参数 (True),当最大中断值超过 240 分钟或 240 英里(386.24 公里)时,始终使用层次结构。

uturn_at_junctions

可选字符串。使用此参数来限制或允许服务区在交叉点处设置U-turns。为了理解参数值,请考虑一下以下术语:路口是街道段的终点,并可能连接到一个或多个其他路段; pseudo-junction 是恰好两条街道相互连接的点;十字路口是三个或更多街道连接的点; dead-end 是一个街道段结束而没有连接到另一个街道段的地方。鉴于此信息,参数可以具有以下值:

Parameter

Description

ALLOW_UTURNS

ALLOW_UTURNSU-turns 无处不在。允许U-turns 意味着车辆可以在交叉路口或交叉路口掉头,然后在同一条街道上折返。

ALLOW_DEAD_ENDS_AND

ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY

_INTERSECTIONS_ONLY

U-turns 禁止在两条相邻街道正好相交的路口。

ALLOW_DEAD_ENDS_ONLY

ALLOW_DEAD_ENDS_ONLYU-turns 禁止在所有路口和交叉路口使用,仅允许在死胡同处使用。

NO_UTURNS

U-turns 禁止在所有路口、交叉路口和dead-ends。请注意,即使选择了此参数值,路线仍然可以在停靠点生成U-turns。如果您希望在停止时禁止U-turns,您可以将其CurbApproach 属性设置为适当的值 (3)。

此参数的默认值为“ALLOW_UTURNS”。

选择列表:[‘允许’、‘不允许’、‘仅在死角允许’、‘仅在交叉路口和死角允许’]

polygons_for_multiple_facilities

可选字符串。选择在分析中存在多个设施点时如何生成服务区多边形。

  • Overlapping - 为每个设施创建单独的多边形。多边形可以相互重叠。这是默认值。

  • Not Overlapping - 创建单独的多边形,使一个设施的多边形不能与其他设施的多边形重叠;此外,网络的任何部分只能由最近设施的服务区域覆盖。

  • Merge by Break Value - 创建并连接具有相同中断值的不同设施的多边形。

使用重叠或不重叠时,输入设施点的所有字段都包含在输出面中,但输入ObjectID 字段中的值会传输到输出面的FacilityOID 字段中。按中断值合并时FacilityOID字段为空,输入字段不包含在输出中。

选择列表:[‘重叠’、‘不重叠’、‘按中断值合并’]

polygon_overlap_type

可选字符串。指定将同心服务区多边形创建为圆盘或圆环的选项。仅当为设施点指定多个中断值时,此选项才适用。

  • Rings - 代表较大中断的多边形不包括较小中断的多边形。这会创建在连续中断之间运行的多边形。如果要查找从一个中断到另一个中断的区域,请使用此选项。例如,如果您创建 5 分钟和 10 分钟服务区,则 10 分钟服务区多边形将排除 5 分钟服务区多边形下的区域。这是默认值。

  • Disks - 创建从设施到休息点的多边形。例如,如果您创建 5 分钟和 10 分钟服务区,则 10 分钟服务区多边形将包括 5 分钟服务区多边形下的区域。

选择列表:['Rings','Disks']

detailed_polygons

可选的布尔值。指定创建详细或概化多边形的选项。

未选中 (False) - 创建快速生成且相当准确的广义多边形。这是默认设置。

选中 (True) - 创建详细的多边形,准确地模拟服务区线并且可能包含未到达区域的岛屿。此选项比生成广义多边形要慢得多。使用层次结构时不支持此选项。如果您的设施位于具有grid-like 街道网络的市区,则广义服务区和详细服务区之间的差异将很小。但是,如果您的设施位于包含山区和乡村道路的区域,则详细服务区可能会比广义服务区提供更准确的结果。

仅当中断值参数中指定的最大值小于或等于 15 分钟或 15 英里(24.14 公里)时,该工具才支持生成详细的多边形。

polygon_trim_distance

可选的线性单元。指定修剪服务区面的距离。当在街道网络稀疏的地方查找服务区并且您不希望服务区覆盖没有街道特征的大片区域时,这非常有用。

默认值为 100 米。此参数的无值或值为 0 指定不应修剪服务区多边形。使用层次结构时忽略此参数值。

polygon_simplification_tolerance

可选的线性单元。指定要简化多边形几何体的程度。

简化维护多边形的关键顶点以定义其基本形状并删除其他顶点。您指定的简化距离是简化的多边形边界可以偏离原始多边形边界的最大偏移量。简化多边形会减少顶点的数量并倾向于减少绘制时间。

point_barriers

可选 FeatureSet 。指定一个或多个点作为临时限制或代表在底层街道上行驶可能需要的额外时间或距离。例如,点障碍可用于表示沿街道倒下的树或在铁路道口花费的时间延迟。

该工具规定了可以添加为障碍的 250 个点的限制。指定点障碍时,您可以使用属性为每个点设置属性,例如其名称或障碍类型。可以使用以下属性指定点障碍:

  • Name :屏障的名称。

  • BarrierType :指定点障碍是完全限制行进还是在越过时增加时间或距离。此属性的值指定为以下整数之一(使用数字代码,而不是括号中的名称):

    • 0(限制)- 禁止穿过障碍物。障碍被称为限制点障碍,因为它充当限制。

    • 2(增加的成本)- 穿越障碍物会增加行驶时间或距离,增加 Additional_Time 或 Additional_Distance 字段中指定的数量。这种障碍类型称为added-cost 点障碍。

  • Additional_Time :指示穿越障碍物时增加了多少行程时间。此字段仅适用于added-cost 障碍并且仅当中断单位值基于时间时。该字段值必须大于或等于 0,其单位与 Break Units 参数中指定的单位相同。

  • Additional_Distance :表示穿越障碍物时增加了多少距离。此字段仅适用于added-cost 障碍并且仅当中断单位值基于距离时。该字段值必须大于或等于零,其单位与 Break Units 参数中指定的单位相同。

line_barriers

可选 FeatureSet 。指定一条或多条线路,禁止在线路与街道相交的任何地方行驶。例如,可以使用线屏障来模拟阻塞多个街道段交通的游行或抗议活动。线障还可以快速隔离多条道路,防止其穿越,从而引导可能的路线远离街道网络中不需要的部分。

该工具对您可以使用 Line Barriers 参数限制的街道数量施加了限制。虽然您可以指定为线障碍的线的数量没有限制,但与所有线相交的街道的总数量不能超过 500。

指定线障碍时,您可以使用以下属性为每个障碍设置名称属性:

  • Name :屏障的名称。

polygon_barriers

可选 FeatureSet 。指定完全限制行驶或按比例缩放在与多边形相交的街道上行驶所需的时间或距离的多边形。该服务对您可以使用“多边形障碍”参数限制的街道数量施加限制。虽然可以指定为多边形障碍的多边形数量没有限制,但所有多边形相交的街道总数不应超过 2,000。指定多边形障碍物时,您可以使用属性为每个障碍物设置属性,例如其名称或障碍物类型。可以使用以下属性指定多边形障碍:

  • Name :屏障的名称。

  • BarrierType :指定障碍物是完全限制旅行还是缩放通过它的时间或距离。字段值指定为以下整数之一(使用数字代码,而不是括号中的名称):

    • 0(限制)- 禁止通过障碍物的任何部分。该障碍被称为限制多边形障碍,因为它禁止在与障碍相交的街道上行驶。这种类型的屏障的一种用途是模拟覆盖街道区域的洪水,这些区域无法在这些街道上行驶。

    • 1(按比例计算的成本)- 按使用 ScaledTimeFactor 或 ScaledDistanceFactor 字段指定的系数来调整行驶基础街道所需的时间或距离。如果街道被障碍物部分覆盖,则行程时间或距离将被分配然后按比例缩放。例如,系数 0.25 意味着在底层街道上的行驶速度预计将比正常速度快四倍。 3.0 的系数意味着在底层街道上行驶的时间预计是正常情况的三倍。此障碍类型称为scaled-cost 多边形障碍。它可用于模拟降低特定地区旅行速度的风暴。

    • ScaledTimeFactor :这是与障碍物相交的街道的行驶时间乘以的因子。此字段仅适用于scaled-cost 障碍并且仅当测量单位是基于时间的。字段值必须大于零。

    • ScaledDistanceFactor :这是与障碍物相交的街道距离乘以的系数。此属性仅适用于scaled-cost 障碍并且仅当测量单位是基于距离的。属性值必须大于零。

restrictions

可选字符串。指定在查找设施点和请求点之间的最佳路径时该工具应遵守哪些限制。限制代表驾驶偏好或要求。在大多数情况下,限制会导致道路被禁止。例如,使用避开收费公路限制将导致仅当绝对需要在收费公路上行驶以访问事件或设施时才包含收费公路的路线。高度限制可以绕过低于车辆高度的任何间隙。如果您在车辆上携带腐蚀性材料,则使用“禁止任何危险品”限制可防止沿着标记为非法的道路运输材料。以下是可用限制列表和简短说明。某些限制需要为其所需用途指定一个附加值。此值需要与限制名称和旨在与限制一起使用的特定参数相关联。如果它们的名称出现在 Attribute Parameter Values 参数的 AttributeName 列下,您可以识别这些限制。ParameterValue 字段应在 Attribute Parameter Values 参数中指定,以便在查找可通行道路时正确使用限制。某些限制仅在某些国家/地区受支持;它们的可用性在下面的列表中按地区说明。在区域内限制可用性的限制中,您可以通过查看网络分析服务网页的数据覆盖范围的国家列表部分中的表格来检查限制是否在特定国家/地区可用。如果某个国家/地区的物流属性列中的值为是,则该国家/地区支持在该地区选择可用性的限制。如果您指定的限制名称在您的事件所在的国家/地区不可用,则服务会忽略无效的限制。该服务还会忽略 Restriction Usage 参数值介于 0 和 1 之间的限制(请参阅 Attribute Parameter Value 参数)。禁止所有 Restriction Usage 参数值大于 0 的限制。该服务支持下表中列出的限制名称:

Parameter

Description

禁止任何危险品

结果将不包括禁止运输任何危险材料的道路。可用性:北美和欧洲的部分国家

避开拼车道路

结果将避开专为拼车 (high-occupancy) 车辆指定的道路。可用性:所有国家

避开快车道

结果将避开指定为快速车道的道路。可用性:所有国家

避免渡轮

结果将避免渡轮。可用性:所有国家

避开盖茨

结果将避开有大门的道路,例如有钥匙的通道或guard-controlled 入口通道。可用性:所有国家

避免进入受限的道路

结果将避开限制进入高速公路的道路。可用性:所有国家

避开私家路

结果将避开非公共拥有和维护的道路。可用性:所有国家

避开不适合行人通行的道路

结果将避开不适合行人通行的道路。

避开楼梯

结果将避开适合行人路线的所有楼梯。

避开收费公路

结果将避开收费公路。可用性:所有国家

避免卡车收费公路

结果将避开卡车的所有收费公路

避开卡车限制道路

结果将避开除了送货时不允许卡车进入的道路。

避开未铺砌的道路

结果将避开未铺设的道路(例如,泥土、砾石等)。可用性:所有国家

轴数限制

结果将不包括禁止使用指定轴数的卡车的道路。可以使用轴数限制参数指定轴数。可用性:北美和欧洲的部分国家

驾驶巴士

结果将不包括禁止公共汽车的道路。使用此限制还可以确保结果符合one-way 街道。可用性:所有国家

驾驶出租车

结果将不包括禁止出租车的道路。使用此限制还可以确保结果符合one-way 街道。可用性:所有国家

驾驶卡车

结果将不包括禁止卡车行驶的道路。使用此限制还可以确保结果符合one-way 街道。可用性:所有国家

驾驶汽车

结果将不包括禁止汽车通行的道路。使用此限制还可以确保结果符合one-way 街道。可用性:所有国家

驾驶紧急车辆

结果将不包括紧急车辆被禁止的道路。使用此限制还可以确保结果符合one-way 街道。可用性:所有国家

身高限制

结果将不包括车辆高度超过道路最大允许高度的道路。可以使用 Vehicle Height (meters) 限制参数指定车辆高度。可用性:北美和欧洲的部分国家

主销到后桥

结果将

长度限制

不包括车辆长度超过道路上所有卡车的最大允许主销到后轴的道路。车辆主销和后轴之间的长度可以使用车辆主销到后轴长度(米)限制参数来指定。可用性:北美和欧洲的部分国家

长度限制

结果将不包括车辆长度超过道路最大允许长度的道路。可以使用 Vehicle Length (meters) 限制参数指定车辆长度。可用性:北美和欧洲的部分国家

行人首选

结果更喜欢为行人指定的路径。

骑摩托车

结果将不包括禁止摩托车的道路。使用此限制还可以确保结果符合one-way 街道。可用性:所有国家

禁止在建道路

结果将不包括正在建设中的道路。可用性:所有国家

半拖拉机与一个

结果将不包括半挂车或拖拉机所在的道路

或更多预告片被禁止

禁止使用一辆或多辆拖车。可用性:北美和欧洲的部分国家

禁止单轴车辆

结果将不包括禁止使用单轴车辆的道路。可用性:北美和欧洲的部分国家

禁止串联车轴车辆

结果将不包括禁止使用双轴车辆的道路。可用性:北美和欧洲的部分国家

禁止通过交通

结果将不包括禁止通行(非本地)的道路。可用性:所有国家

带拖车限制的卡车

结果将不包括禁止载有指定数量拖车的卡车的道路。可以使用卡车上的拖车数量限制参数指定卡车上的拖车数量。可用性:北美和欧洲的部分国家

使用首选的危险品路线

结果将更倾向于指定用于运输任何类型危险材料的道路。可用性:北美和欧洲的部分国家

使用首选卡车路线

结果将优先选择指定为卡车路线的道路,例如美国《国家地面运输援助法》指定的国家网络的一部分,或州或省指定为卡车路线的道路,或卡车在某个区域行驶时首选的道路。可用性:北美和欧洲的部分国家

Walking

结果将不包括禁止行人的道路。可用性:所有国家

重量限制

结果将不包括车辆重量超过道路最大允许重量的道路。可以使用车辆重量(公斤)限制参数指定车辆重量。可用性:北美和欧洲的部分国家

每轴重量限制

结果将不包括每轴车辆重量超过道路每轴最大允许重量的道路。可以使用每轴车辆重量(千克)限制参数指定每轴车辆重量。可用性:北美和欧洲的部分国家

宽度限制

结果将不包括车辆宽度超过道路最大允许宽度的道路。可以使用 Vehicle Width (meters) 限制参数指定车辆宽度。可用性:北美和欧洲的部分国家

选择列表:['Any Hazmat Prohibited'、'Avoid Carpool Roads'、'Avoid Express Lanes'、'Avoid Ferries'、'Avoid Gates'、'Avoid Limited Access Roads'、'Avoid Private Roads'、'Avoid Roads Unsuitable行人”、“避开楼梯”、“避开收费公路”、“避开卡车收费公路”、“避开卡车限制道路”、“避开未铺砌的道路”、“轴数限制”、“驾驶巴士”、“驾驶送货车','驾驶出租车','驾驶卡车','驾驶汽车','驾驶紧急车辆','高度限制','主销到后轴长度限制','长度限制','首选行人用”、“骑摩托车”、“禁止在建设中的道路”、“禁止带一个或多个拖车的半挂车或拖拉机”、“禁止单轴车辆”、“禁止双轴车辆”、“禁止通过交通”、“带有拖车限制的卡车”、“使用首选危险品路线”、“使用首选卡车路线”、“步行”、“重量限制”、“每轴重量限制”、“W idth 限制”]

attribute_parameter_values

可选 FeatureSet 。指定某些限制所需的附加值,例如重量限制的车辆重量。您还可以使用属性参数来指定任何限制是否禁止、避免或倾向于在使用该限制的道路上行驶。如果限制是为了避开或首选道路,您可以使用此参数进一步指定避开或首选道路的程度。例如,您可以选择从不使用收费公路、尽可能避开它们,甚至非常喜欢它们。

除非旅行模式设置为自定义,否则您为此参数提供的值将被忽略。如果您从要素类中指定属性参数值参数,则要素类上的字段名称必须与字段匹配,如下所述:

  • AttributeName :列出限制的名称。

  • ParameterName :列出与限制相关的参数名称。根据其预期用途,限制可以具有一个或多个ParameterName 字段值。

  • ParameterValue :工具在评估限制时使用的 ParameterName 的值。

    属性参数值取决于限制参数。仅当将限制名称指定为 Restrictions 参数的值时,ParameterValue 字段才适用。

    在 Attribute Parameter Values 中,每个限制(列为 AttributeName)都有一个 ParameterName 字段值 Restriction Usage,它指定限制是禁止、避免还是更喜欢在与限制相关的道路上行驶以及道路的行驶程度避免或首选。限制用法ParameterName 可以分配以下任何字符串值或括号内列出的等效数值:

    • 禁止 (-1) - 完全禁止在使用限制的道路上行驶。

    • AVOID_HIGH (5) - 该工具极不可能在路线中包含与限制相关的道路。

    • AVOID_MEDIUM (2) - 该工具不太可能在路线中包含与限制相关的道路。

    • AVOID_LOW (1.3) - 该工具不太可能在路线中包含与限制相关的道路。

    • PREFER_LOW (0.8) - 该工具有可能在路线中包含与限制相关的道路。

    • PREFER_MEDIUM (0.5) - 该工具可能会在路线中包含与限制相关的道路。

    • PREFER_HIGH (0.2) - 该工具极有可能在路线中包含与限制相关的道路。

    在大多数情况下,如果限制依赖于 vehicle-characteristic(例如车辆高度),您可以使用默认值 PROHIBITED 作为限制使用。但是,在某些情况下,Restriction Usage 的值取决于您的路由首选项。例如,Avoid Toll Roads 限制的 Restriction Usage 参数的默认值为 AVOID_MEDIUM。这意味着当使用限制时,该工具将在可能的情况下尝试绕过收费公路。 AVOID_MEDIUM也说明了在寻找最佳路线时避开收费公路的重要性;它具有中等优先级。选择AVOID_LOW 会降低避免过路费的重要性;相反,选择AVOID_HIGH 将赋予它更高的重要性,从而使服务更容易接受生成更长的路线以避免收费。选择 PROHIBITED 将完全禁止在收费公路上行驶,从而使路线无法在收费公路的任何部分行驶。请记住,避免或禁止收费公路,从而避免支付通行费,是某些人的目标;相比之下,其他人更喜欢在收费公路上开车,因为对他们来说,避开交通比花在通行费上的钱更有值。在后一种情况下,您可以选择 PREFER_LOW、PREFER_MEDIUM 或 PREFER_HIGH 作为 Restriction Usage 的值。偏好越高,工具在与限制相关的道路上行驶的距离就越远。

time_zone_for_time_of_day

可选字符串。指定时间参数的一个或多个时区。

  • Geographically Local:时间参数是指设施所在的时区。因此,服务区的开始或结束时间是按时区错开的。将一天中的时间设置为上午 9:00,为一天中的时间选择地理本地作为时区,并求解导致为东部时区中的任何设施在东部时间上午 9:00 生成服务区,上午 9:00。中央时区设施的时间,山地时区设施的上午 9:00 山区时间,等等,不同时区的设施。如果跨越美国的连锁店在当地时间上午 9:00 营业,则可以选择此参数值以在一个解决方案中找到所有商店在营业时间的市场区域。首先,东部时区的商店打开并生成一个多边形,然后一小时后在中部时间打开商店,依此类推。九点钟始终是当地时间,但实时错开。

  • UTC:时间参数是指协调世界时 (UTC)。因此,无论每个设施所在的时区如何,所有设施都同时到达或离开。将时间设置为下午 2:00,选择 UTC,然后求解会导致服务区生成为东部标准时间上午 9:00东部时区的任何设施,中部时区的设施的上午 8:00 中部标准时间,山地时区的设施的上午 7:00 山地标准时间,等等,不同时区的设施。上述场景假定为标准时间。在夏令时期间,东部时间、中部时间和山区时间将分别提前一小时(即分别为上午 10:00、上午 9:00 和上午 8:00)。 UTC 选项有用的一种情况是可视化划分为两个时区的辖区的emergency-response 覆盖范围。紧急车辆作为设施装载。 UTC 时间设置为现在。 (您需要根据 UTC 确定当前时间和日期以正确使用此选项。)设置其他属性并解决分析。尽管时区边界将车辆分开,但结果显示了在当前交通状况下可以到达的区域。同样的过程也可以用于其他时间,而不仅仅是现在。

无论时间设置的时区如何,当时间具有非空值且多个设施的面设置为创建合并或非重叠面时,所有设施都必须位于同一时区。

选择列表:['Geographically Local', 'UTC']

travel_mode

可选字符串。指定要在分析中建模的运输方式。旅行模式在ArcGIS Online 中进行管理,并且可以由您组织的管理员进行配置,以更好地反映您组织的工作流程。您需要指定您的组织支持的出行方式的名称。

要获取支持的出行模式名称列表,请从用于访问该工具的同一 GIS Server 连接下的实用工具工具箱中运行 GetTravelModes 工具。 GetTravelModes 工具将支持的出行模式表添加到应用程序。支持的出行模式表中的出行模式名称字段中的任何值都可以指定为输入。您还可以将出行模式设置字段中的值指定为输入。这加快了工具的执行速度,因为工具不必根据出行模式名称查找设置。

默认值“自定义”允许您使用自定义出行模式参数(UTurn at Junctions、Use Hierarchy、Restrictions、Attribute Parameter Values 和 Impedance)配置您自己的出行模式。自定义出行模式参数模型自驾车的默认值。您可能需要选择自定义并设置上面列出的自定义出行模式参数,以对具有快速步行速度的行人或具有给定高度、重量和某些危险材料的货物的卡车进行建模。您可以选择这样做来尝试不同的设置以获得所需的分析结果。确定分析设置后,您应该与组织的管理员合作,并将这些设置保存为新的或现有出行模式的一部分,以便组织中的每个人都可以使用相同的设置重新运行分析。

impedance

可选字符串。指定阻抗,它是一个值,表示沿着路段或在交通网络的其他部分行驶的努力或成本。行驶距离是一种阻抗;以公里为单位的道路长度可以被认为是阻抗。从这个意义上说,行人的所有modes-a公里对于汽车也是一公里。 (可能会改变的是允许不同模式行驶的路径,这会影响点之间的距离,这由行驶模式设置建模。)行驶时间也可以是一种阻抗;一辆汽车在空旷的道路上行驶一英里可能需要一分钟。旅行时间可能因旅行而异mode-a 行人可能需要超过 20 分钟才能走完同一英里,因此为您正在建模的旅行模式选择正确的阻抗很重要。从以下阻抗值中进行选择: 汽车的行驶时间 Time-Models。这些旅行时间是动态的,并且会根据交通数据可用区域的交通流量而波动。这是默认值。 Truck Time-Models 卡车的行驶时间。这些行程时间对于每条道路都是静态的,不会随交通而波动。 Walk Time-Models 行人的出行时间。沿道路和路径行驶Distance-Stores 长度测量。要模拟步行距离,请选择此选项并确保在限制参数中设置步行。同样,要模拟行驶距离或卡车距离,请在此处选择行驶距离并设置适当的限制,以便您的车辆仅在允许的道路上行驶。您为此参数提供的值将被忽略,除非旅行模式设置为自定义,这是默认值。如果您选择 Drive Time、Truck Time 或 Walk Time,则 Measurement Units 参数必须设置为基于时间的值;如果您为阻抗选择行驶距离,则测量单位必须基于距离。

选择列表:[‘驾驶时间’、‘卡车时间’、‘步行时间’、‘行驶距离’]

save_output_network_analysis_layer

可选布尔值。指定工具是否应将分析设置保存为网络分析图层文件。即使在 ArcGIS 桌面应用程序(例如 ArcMap)中打开该文件,也无法直接使用该文件。其目的是发送给 Esri 技术支持来诊断该工具返回的结果的质量。 True:保存网络分析图层文件。该文件将下载到您计算机上的临时目录中。在 ArcGIS Pro 中,可以通过查看项目地理处理历史记录中与工具执行相对应的条目中的输出网络分析图层参数值来确定下载文件的位置。在 ArcMap 中,可以通过访问与地理处理结果窗口中的工具执行相对应的条目中的输出网络分析图层参数上的快捷菜单中的复制位置选项来确定文件的位置。 False:不保存网络分析图层文件。这是默认设置。

overrides

可选字符串。在寻找网络分析问题的解决方案时,指定可以影响求解器行为的附加设置。这个参数的值需要在dict中指定。例如,有效值具有以下形式 {“overrideSetting1”: “value1”, “overrideSetting2”: “value2”}。覆盖设置名称始终用双引号引起来。这些值可以是数字、布尔值或字符串。此参数的默认值为无值,表示不覆盖任何求解器设置。覆盖是高级设置,只有在仔细分析应用设置前后获得的结果后才能使用。可以通过联系 Esri 技术支持获取每个求解器支持的覆盖设置列表及其可接受的值。

time_impedance

可选字符串。指定基于时间的阻抗。

distance_impedence

可选字符串。指定基于距离的阻抗。

polygon_detail

可选字符串。指定要创建的多边形的细节。

选择列表:[“Generalized”、“Standard”、“High”]

output_format

可选的。指定创建输出要素的格式。

从以下格式中选择:

  • 要素集 - 输出要素作为要素类和表返回。这是默认设置。

  • JSON 文件 - 输出特征作为包含输出的 JSON 表示的压缩文件返回。指定此选项时,输出为单个文件(扩展名为 .zip),其中包含服务创建的每个输出的一个或多个 JSON 文件(扩展名为 .json)。

  • GeoJSON 文件 - 输出特征作为包含输出的 GeoJSON 表示的压缩文件返回。指定此选项时,输出为单个文件(扩展名为 .zip),其中包含服务创建的每个输出的一个或多个 GeoJSON 文件(扩展名为 .geojson)。

gis

可选,运行此工具的 GIS 。如果未指定,则使用活动 GIS。

future

可选布尔值。如果为 True,则将返回 future 对象,并且进程不会等待任务完成。默认为False,表示等待结果。

  • service_areas - 服务区域作为FeatureSet

  • solve_succeeded - 作为布尔值求解成功

单击GenerateServiceAreas 获取更多帮助。

例子:

# Usage Example: To determine network service areas around facilities at time breaks of 5, 10, 15 min of drive time.

agg_result = generate_service_areas(facilities=facilities,
                                    break_values=[5, 10, 15],
                                    break_units="Minutes",
                                    time_of_day=current_time)

相关用法


注:本文由纯净天空筛选整理自arcgis.com大神的英文原创作品 arcgis.network.analysis.generate_service_areas。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。