描述
基于行驶时间或行驶距离查找离事件点最近的一个或多个设施点,输出最佳路径、事件点间的行驶方向、选定的设施点以及选定设施点的副本。例如,您可以使用此工具查找离事故地点最近的医院、离犯罪现场最近的警车或者是离客户地址最近的商店。
查找最近设施点时,您可以指定查找数量和行驶方向(驶向设施点或驶离设施点)。您可以指定一天中的某个时间,然后根据该时间和日期的实时或预测交通状况计算行驶时间。例如,您可以使用此工具搜索距离事故发生地点行驶时间在 15 分钟(根据给定的一天中的时间计算)以内的医院。查找结果中将不会包含任何行驶时间超出 15 分钟(依据交通状况计算)的医院。
警告:
有关此工具的最新信息,请参阅 Web 帮助中本主题的最新版本。ArcGIS Online 会定期对此类服务进行功能更新,因此安装的帮助可能已过期。
插图
使用方法
即用型工具箱中的工具是利用 ArcGIS Online 托管数据和分析要素的 ArcGIS Online 地理处理服务。
如果测量单位参数是基于时间的,则该工具会根据行驶时间查找最近设施点。同样,若测量单位是基于距离的,则工具会使用行驶距离。
为成功执行该工具,您至少需要指定一个设施点和一个事件点。最多可以加载 5,000 个设施点和 5,000 个事件点,且最多可以为每个事件点查找到 100 个最近设施点。因此,工具的每个解决方案最多能找到 100,000 个最近设施点。
最多可以添加 250 个点障碍。您可以添加任意数量的线障碍或面障碍,但线障碍的相交数不能超过 500 个街道要素,面障碍的相交数不能超过 2,000 个要素。
求解时可选择使用道路等级以更快地生成结果,但解决方案可能欠佳。
无论是否选中应用等级参数 (True),只要代表事件点或设施点的任何一对要素之间的直线距离大于 50 英里(80.46 公里),便会始终使用等级。
当出行模式设置为步行时或者设置为自定义并且使用步行约束条件时,代表事件点或设施点的任意一对要素之间的直线距离不得大于 27 英里(43.45 千米)。
如果输入点与其最近的可穿过街道之间的距离大于 12.42 英里(20 千米),则将从分析中排除该点。
语法
FindClosestFacilities(Incidents, Facilities, Measurement_Units, {Analysis_Region}, {Number_of_Facilities_to_Find}, {Cutoff}, {Travel_Direction}, {Use_Hierarchy}, {Time_of_Day}, {Time_of_Day_Usage}, {UTurn_at_Junctions}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Restrictions}, {Attribute_Parameter_Values}, {Route_Shape}, {Route_Line_Simplification_Tolerance}, {Populate_Directions}, {Directions_Language}, {Directions_Distance_Units}, {Directions_Style_Name}, {Time_Zone_for_Time_of_Day}, {Travel_Mode}, {Impedance}, {Save_Output_Network_Analysis_Layer}, {Overrides}, {Save_Route_Data}, {Time_Impedance}, {Distance_Impedance}, {Output_Format})
参数 | 说明 | 数据类型 |
Incidents | 在最近设施点分析中用作起点或终点的位置。 可指定一个或多个事件点(最多 5,000 个)。工具将在这些位置中搜索附近的位置。 指定事件点后,可使用以下特性为每个事件点设置属性,例如事件点的名称或服务时间。 Name 事件点的名称。该名称用于行驶方向中。如果未指定名称,则会在输出路径和方向中自动生成前缀为 Location 的唯一名称。 ID 事件点的唯一标识符。该标识符包含在输出路径中(作为 IncidentID 字段),且有助于将输出路径的附加信息(例如总行驶时间或总距离)连接到事件点的属性中,反之亦然。如果未指定 ID,则服务将为每个事件点自动生成一个唯一的标识符。 AdditionalTime 在事件点所花费的时间,该时间将被添加到路径总时间中。默认值为 0。 该属性值的单位由测量单位参数指定。仅在测量单位基于时间时,属性值才能包含在分析中。 例如,如果您要查找距火灾事件点最近的消防站以估算响应时间,AdditionalTime 属性可存储消防人员开始灭火前在事件点位置连接装备所花费的时间。 AdditionalDistance 在事件点所行驶的额外距离,该距离将被添加到路径总距离中。默认值为 0。 该属性值的单位由测量单位参数指定。仅在测量单位基于距离时,属性值才能包含在分析中。 通常,事件点的位置(例如住宅)并不是恰好位于街道上,而是位于道路的后方。该属性值可用于构建事件点位置与其在街道上的位置之间的距离,如有必要,将此段距离包括在总行驶距离中。 AdditionalCost 在事件点花费的额外成本,该成本将被添加到路径总距离中。默认值为 0。 当分析的出行模式使用不基于时间也不基于距离的阻抗属性时,应使用此属性值。属性值的单位将理解为未知单位。 TargetFacilityCount 需要为指定事件点查找的设施点的数量。此字段允许您为每个事件点指定要查找的不同数量的设施点。例如,使用此字段,您可以找到距一个事件点最近的三个设施点,以及距另一个事件点最近的两个设施点。 Cutoff 停止从指定事件点搜索设施点时所对应的阻抗值。此属性允许您为每个事件点指定不同的中断值。例如,使用此属性,您可以搜索距一个事件点五分钟行驶时间以内的设施点,并搜索距另一个事件点八分钟行驶时间以内的设施点。 CurbApproach 指定车辆到达和离开事件点的方向。该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):
CurbApproach 属性是专为使用以下两种国家驾驶标准而设计的:右侧通行(美国)和左侧通行(英国)。首先,考虑位于车辆左侧的事件点。不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。不同国家的驾驶标准可能会要求您从这两种方向中的其中一个接近事件点,也就是说,只能从车辆的右侧或左侧接近事件点。例如,如果要到达一个事件点并且在车辆与事件点之间不存在其他交通车道,那么在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。 Bearing 点移动的方向。单位为度,并且从正北方向开始顺时针进行测量。该字段与 BearingTol 字段结合使用。 方位角数据通常会从配有 GPS 接收器的移动设备自动发送。如果正在加载移动输入位置(例如行人或车辆),请尝试包括方位角数据。 使用该字段可以防止将位置添加到错误的边上,例如,车辆刚好在交叉路口或天桥附近时。方位角也可帮助工具确定点在街道的哪一边上。 BearingTol 使用 Bearing 字段在边上定位移动点时,方位角容差值将创建一个可接受方位角值的范围。如果 Bearing 字段中的值在可接受值范围(由边上的方位角容差生成)内,则可以将该点作为网络位置添加在此处,否则,将计算下一个最近边上的最近点。 单位为度,默认值为 30。值必须大于 0 且小于 180。值为 30 表示,Network Analyst 尝试在边上添加网络位置时,在边的每一侧(左侧和右侧)的两个数字化方向上都将生成一个 15 度的可接受方位角值。 NavLatency 如果 Bearing 和 BearingTol 也具有值,则该字段只在求解过程中使用;但是,即使当 Bearing 和 BearingTol 字段中有值时,NavLatency 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要经过的时间。 NavLatency 的时间单位与分析对象的 timeUnits 属性指定的单位相同。 | Feature Set |
Facilities | 在最近设施点分析中用作起点或终点的位置。 可指定一个或多个设施点(最多 5,000 个)。以下为查找最近位置时所搜索的位置。 指定设施点后,可使用以下特性为每个事件点设置属性,例如事件点的名称或服务时间。 Name 设施点的名称。该名称用于行驶方向中。如果未指定名称,则会在输出路径和方向中自动生成前缀为 Location 的唯一名称。 ID 设施点的唯一标识符。该标识符作为 FacilityID 字段包含在输出路径和输出最近设施点中。FacilityID 字段可用于将输出路径的附加信息(例如总行驶时间或总距离)连接到设施点的属性中。如果未指定 ID,则服务将为每个设施点自动生成一个唯一的标识符。 AdditionalTime 在设施点所花费的时间,该时间将被添加到路径总时间中。默认值为 0。 该属性值的单位由测量单位参数指定。仅在测量单位基于时间时,属性值才能包含在分析中。 例如,如果您要查找离火灾事件点最近的消防站,AdditionalTime 可存储消防人员穿好适当的防护装备和离开消防站所花费的时间。 AdditionalDistance 在设施点所行驶的额外距离,该距离将被添加到路径总距离中。默认值为 0。 该属性值的单位由测量单位参数指定。仅在测量单位基于距离时,属性值才能包含在分析中。 通常,设施点的位置(例如消防站)并不是恰好位于街道上,而是位于道路的后方。AdditionalDistance 可用于构建设施点位置与其在街道上的位置之间的距离,如有必要,将此段距离包括在总行驶距离中。 AdditionalCost 在设施点花费的额外成本,该成本将被添加到路径总距离中。默认值为 0。 当分析的出行模式使用不基于时间也不基于距离的阻抗属性时,应使用此属性值。属性值的单位将理解为未知单位。 Cutoff 停止从指定设施点搜索事件点时所对应的阻抗值。此属性允许您为每个设施点指定不同的中断值。例如,使用此属性,您可以搜索距一个设施点五分钟行驶时间以内的事件点,并搜索距另一个设施点八分钟行驶时间以内的事件点。 CurbApproach 指定车辆到达和离开设施点的方向。该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):
CurbApproach 属性是专为使用以下两种国家驾驶标准而设计的:右侧通行(美国)和左侧通行(英国)。首先,考虑位于车辆左侧的设施点。不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。不同国家的驾驶标准可能会要求您从这两种方向中的其中一个接近设施点,也就是说,只能从车辆的右侧或左侧接近设施点。例如,如果要到达一个设施点并且在车辆与设施点之间不存在其他交通车道,那么在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。 Bearing 点移动的方向。单位为度,并且从正北方向开始顺时针进行测量。该字段与 BearingTol 字段结合使用。 方位角数据通常会从配有 GPS 接收器的移动设备自动发送。如果正在加载移动输入位置(例如行人或车辆),请尝试包括方位角数据。 使用该字段可以防止将位置添加到错误的边上,例如,车辆刚好在交叉路口或天桥附近时。方位角也可帮助工具确定点在街道的哪一边上。 BearingTol 使用 Bearing 字段在边上定位移动点时,方位角容差值将创建一个可接受方位角值的范围。如果 Bearing 字段中的值在可接受值范围(由边上的方位角容差生成)内,则可以将该点作为网络位置添加在此处,否则,将计算下一个最近边上的最近点。 单位为度,默认值为 30。值必须大于 0 且小于 180。值为 30 表示,Network Analyst 尝试在边上添加网络位置时,在边的每一侧(左侧和右侧)的两个数字化方向上都将生成一个 15 度的可接受方位角值。 NavLatency 如果 Bearing 和 BearingTol 也具有值,则该字段只在求解过程中使用;但是,即使当 Bearing 和 BearingTol 字段中有值时,NavLatency 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要经过的时间。 NavLatency 的时间单位与分析对象的 timeUnits 属性指定的单位相同。 | Feature Set |
Measurement_Units | 指定用于测量和报告输出路径的总行驶时间或行驶距离的单位。该工具可通过测量行驶时间或沿街道行驶距离查找最近设施点。 为此参数指定的单位可以确定工具将测量行驶距离还是行驶时间来查找最近位置。选择时间单位以测量行驶时间。要测量行驶距离,则请选择距离单位。选择的单位还确定工具在结果中报告总行驶时间或距离时采用的单位。 选项如下:
| String |
Analysis_Region (可选) | 要进行分析的区域。如果未对此参数指定值,工具会基于输入点的位置自动计算区域名称。仅当自动检测的区域名称输入不准确时,才需要设置区域名称。 要指定区域,请使用以下值之一:
旧版本:不再支持以下区域名称,且将在未来版本中删除这些名称。如果您指定了任一已弃用的区域名称,则工具会自动为您所在的区域分配支持的区域名称。
| String |
Number_of_Facilities_to_Find (可选) | 要按事件点查找的最近设施点数。在可能需要来自不同消防站的多辆消防车的情况(例如火灾)中,此项非常有用。例如,您可以指定查找距离起火地点最近的三个消防站。 在此参数中设置的值可以通过输入事件点中的 TargetFacilityCount 字段覆盖每个事件点。 该工具最多可为每个事件点查找 100 个设施点。 | Long |
Cutoff (可选) | 对于给定事件点,停止搜索设施点的行驶时间或行驶距离值。例如,在查找距离事故地点最近的医院时,如果中断值设为 15 分钟,则表示工具将搜索距离事件点 15 分钟车程以内的最近医院。如果到达最近的医院需要 17 分钟的车程,则在输出路径中不会返回任何路线。在搜索多个设施点时,中断值尤为有用。 当行驶方向参数设置为设施点到事件点时,中断可以通过输入设施点中的 Cutoff 字段覆盖每个设施点。当行驶方向参数设置为事件点到设施点时,中断可以通过输入事件点中的 Cutoff 字段覆盖每个事件点。 该参数的单位由测量单位参数指定。 | Double |
Travel_Direction (可选) | 指定如何测量最近设施点搜索的行驶方向。
每个选项找到的设施点可能不同,因为沿某些街道的行驶时间可能会随行驶方向和单行线限制而发生变化。例如,从事件点行驶到设施点时,可能需要 10 分钟,而从设施点行驶到事件点时,由于该方向上的行驶时间不同,可能需要 15 分钟。如果您还要设置时间参数的值,交通状况也可能导致设施点到事件点和事件点到设施点选项返回不同的结果。 消防部门通常使用参数的设施点到事件点值,因为他们需要关注从消防站(设施点)行驶到紧急救援位置(事件点)所需的时间。零售商店(设施点)管理层则更关注顾客(事件点)到达商店(设施点)所需的时间;因此,商店管理层通常选择事件点到设施点。 | String |
Use_Hierarchy (可选) | 指定是否将在查找设施点和事件点之间的最佳路径时使用等级。
如果设施点和事件点间的直线距离大于 50 英里,即使未选中此参数(在 Python 中设置为 False),工具也会自动恢复为使用等级。 | Boolean |
Time_of_Day (可选) | 路线开始或结束的时间和日期。该值根据时间用法参数的值可用作路径的起始时间或结束时间。如果您指定当前日期和时间作为该参数的值,则工具将使用实时交通状况查找最近设施点,并且总行驶时间将基于交通状况提供。 指定时间可实现更加准确的事件点和设施点之间的行驶时间评估,因为行驶时间会考虑该日期和时间对应的交通状况。 时间的时区参数指定该时间和日期是参考 UTC 还是设施点或事件点所在时区。 | Date |
Time_of_Day_Usage (可选) | 指定时间参数值是表示路径的到达时间还是出发时间。
| String |
UTurn_at_Junctions (可选) | 交汇点的 U 形转弯策略。允许 U 形转弯表示求解程序可以在交汇点处转向并沿同一街道往回行驶。考虑到交汇点表示街道交叉路口和死角,不同的车辆可以在某些交汇点转弯,而在其他交汇点则不行 - 这取决于交汇点是交叉路口还是死角。为适应此情况,U 形转弯策略参数由连接到交汇点的边数隐性指定,这称为交汇点原子价。此参数可接受的值如下所列;每个值的后面是根据交汇点价对其含义的描述。
| String |
Point_Barriers (可选) | 使用此参数可指定一个或多个点作为临时限制,或表示在基础街道上行驶可能需要的附加时间或距离。例如,点障碍可用来显示一棵沿街倒下的树或是铁路道口上的时间延迟。 工具限制了可添加为障碍的点不得超过 250 个。 指定点障碍后,可通过使用以下属性为每个事件点设置属性,例如其名称或障碍类型: Name 障碍的名称。 BarrierType 指定点障碍是完全限制通行还是增加通过障碍时的时间或距离。此特性值可指定为以下整数之一(请使用数值代码而非括号中的名称):
Additional_Time 穿越障碍时增加的行驶时间。该字段仅适用于增加成本型障碍,并且仅当用于分析的出行模式使用基于时间的阻抗属性时才适用。 此字段的值必须大于或等于零,并且其单位与 测量单位参数中指定的单位相同。 Additional_Distance 穿越障碍时增加的距离。该字段仅适用于增加成本型障碍,并且仅当用于分析的出行模式使用基于距离的阻抗属性时才适用。 该字段的值必须大于或等于零,并且其单位与 测量单位参数中指定的单位相同。 Additional_Cost 穿越障碍时增加的成本。该字段仅适用于增加成本型障碍,并且仅当用于分析的出行模式使用的阻抗属性不基于时间或距离时才适用。 FullEdge 指定分析期间如何将限制点障碍应用于边元素。该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):
CurbApproach 指定受障碍影响的行驶方向。该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):
由于交汇点是点且不分左右侧,所以无论路边通道如何设置,交汇点上的障碍都会影响所有车辆。 CurbApproach 属性是专为使用以下两种国家驾驶标准而设计的:右侧通行(美国)和左侧通行(英国)。首先,考虑位于车辆左侧的设施点。不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。不同国家的驾驶标准可能会要求您从这两种方向中的其中一个接近设施点,也就是说,只能从车辆的右侧或左侧接近设施点。例如,如果要到达一个设施点并且在车辆与设施点之间不存在其他交通车道,那么在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。 Bearing 点移动的方向。单位为度,并且从正北方向开始顺时针进行测量。该字段与 BearingTol 字段结合使用。 方位角数据通常会从配有 GPS 接收器的移动设备自动发送。如果正在加载移动输入位置(例如行人或车辆),请尝试包括方位角数据。 使用该字段可以防止将位置添加到错误的边上,例如,车辆刚好在交叉路口或天桥附近时。方位角也可帮助工具确定点在街道的哪一边上。 BearingTol 使用 Bearing 字段在边上定位移动点时,方位角容差值将创建一个可接受方位角值的范围。如果 Bearing 字段中的值在可接受值范围(由边上的方位角容差生成)内,则可以将该点作为网络位置添加在此处,否则,将计算下一个最近边上的最近点。 单位为度,默认值为 30。值必须大于 0 且小于 180。值为 30 表示,Network Analyst 尝试在边上添加网络位置时,在边的每一侧(左侧和右侧)的两个数字化方向上都将生成一个 15 度的可接受方位角值。 NavLatency 如果 Bearing 和 BearingTol 也具有值,则该字段只在求解过程中使用;但是,即使当 Bearing 和 BearingTol 字段中有值时,NavLatency 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要经过的时间。 NavLatency 的时间单位与分析对象的 timeUnits 属性指定的单位相同。 | Feature Set |
Line_Barriers (可选) | 使用此参数可指定一条或多条线,用于禁止在线与街道相交的位置通行。例如,线障碍可用于对阻塞若干个路段交通的游行或抗议队伍进行建模。线障碍还可用于快速隔离多条道路使其禁止被穿越,从而在可能的路径中去除不符合要求的街道网络部分。 该工具限制了您可以使用线障碍参数限制的街道数量。可指定为线障碍的线数没有限制时,所有线的相交街道的合并数不能超过 500。 指定线障碍时,可以使用以下属性为每个障碍设置名称和障碍类型属性: Name 障碍的名称。 | Feature Set |
Polygon_Barriers (可选) | 使用此参数可指定面,用于完全限制通行或按比例调整行驶在面相交的街道上所需的行驶时间或距离。 该服务限制了您可以使用面障碍参数限制的街道数量。可指定为面障碍的面数没有限制时,所有面的相交街道的合并数不能超过 2,000。 指定面障碍时,可通过使用以下属性为每个面障碍设置属性,例如名称或障碍类型: Name 障碍的名称。 BarrierType 指定障碍是完全禁止通行还是按比例调整穿过成本(例如时间或距离)。该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):
ScaledTimeFactor 它是与障碍相交街道的行驶时间要乘以的因子。该字段值必须大于零。 该字段仅适用于按比例调整成本型障碍,并且仅当用于分析的出行模式使用基于时间的阻抗属性时才适用。 ScaledDistanceFactor 它是与障碍相交街道的距离要乘以的因子。该字段值必须大于零。 该字段仅适用于增加成本型障碍,并且仅当用于分析的出行模式使用基于距离的阻抗属性时才适用。 ScaledCostFactor 它是与障碍相交街道的成本要乘以的因子。该字段值必须大于零。 该字段仅适用于按比例调整成本型障碍,并且仅当用于分析的出行模式使用的阻抗属性不基于时间或距离时才适用。 | Feature Set |
Restrictions (可选) | 在查找最佳路径时工具应使用的限制。 限制表示行驶偏好或要求。大多数情况下,限制条件会导致道路禁行。例如,使用“避开收费公路”限制的结果是,仅在访问某一事件点或设施点需要借道收费公路时,才会生成一条包含该收费公路的路径。高度限制则使您可以绕开低于车辆高度的间隙。如果车辆上装载着腐蚀性物质,使用“禁止任何危险物品”限制可以防止在标记着运输腐蚀性材料为非法行为的路上运输这些材料。 注:除非将出行模式设置为自定义,否则会忽略您为此参数提供的值。 注:某些限制需要指定一个额外值以供它们使用。该值必须与限制名称和用于限制的特定参数相关联。如果在属性参数值参数中的 AttributeName 列显示限制名称,则可识别限制。发现可穿越道路时,为了正确使用限制,应在属性参数值参数中指定 ParameterValue 字段。 注:有些限制仅适用于某些国家/地区;下表按区域显示了这些限制的可用性。关于在某区域内可用性有限的限制,通过在网络分析覆盖范围上查看“国家/地区列表”部分中的表,可以确定该限制在特定国家/地区是否可用。如果一个国家/地区具有 Logistics Attribute 列的 Yes 值,则该国家/地区支持具有区域可选性的限制。如果您指定的限制名称在事件点所在的国家/地区不可用,该服务会忽略无效限制。该服务还会忽略约束条件用法属性参数值为 0 到 1(请参阅属性参数值参数)时的约束条件。它会禁止约束条件用法参数值大于 0 时的所有约束条件。 该工具支持以下限制:
旧版本:“驾驶配送车辆”限制属性将不再可用。由于限制失效,该服务会将其忽略。要实现相似结果,请使用“驾驶货车”限制属性和“避开货车禁行道路”限制属性。 | String |
Attribute_Parameter_Values (可选) | 使用此参数可指定属性或限制条件所需的其他值,例如,指定限制对在受限道路上行驶是禁止、避免还是首选。如果该限制要避免或首选道路,您可以使用此参数进一步指定要避免或首选的程度。例如,您可以选择从不使用收费公路,尽可能的避开它们,或倾向于它们。 注:除非将出行模式设置为自定义,否则会忽略您为此参数提供的值。 如果指定了要素类的属性参数值参数,则要素类上的字段名称必须与如下所示字段相匹配:
属性参数值参数取决于限制参数。仅当限制名称指定为限制参数值时,ParameterValue 字段 才可用。 在属性参数值中,每个限制(以 AttributeName 形式列出)具有一个 ParameterName 字段值,指定限制的行程是禁止、避免还是首选的限制用法与道路选择避免或首选的限制和程度相关联。可为限制用法 ParameterName 分配下列字符串值,或在括号内列出等效数值:
大多数情况下,如果约束条件取决于车辆特征(如车辆高度),则可以使用“约束条件用法”的默认值 PROHIBITED。但是在某些情况下,“限制用法”的值取决于您的路径偏好。例如,“避开收费公路”限制具有“限制用法”属性的默认值 AVOID_MEDIUM。这表示在使用限制时,在可能的情况下工具会试图绕开收费公路。AVOID_MEDIUM 也表示查找最佳路径时避开收费公路的重要性,即优先级为中等。选择 AVOID_LOW 会降低避开收费公路的重要性;而选择 AVOID_HIGH 则会增加其重要性,因此服务为避开收费公路而生成更长的路径时更容易为人所接受。选择 PROHIBITED 则会完全不允许在收费公路上行驶,因此路径不可能经过收费公路的所有部分。但是请注意,避开或禁止收费公路并由此避开公路通行费只是一部分人的目的。对另外一部分人来说,因为避开拥堵的交通比交一些公路通行费更为重要,会宁愿走收费公路。在后一种情况中,您可以选择 PREFER_LOW、PREFER_MEDIUM 或 PREFER_HIGH 作为“限制用法”的值。首选的等级越高,工具为了在与限制相关的道路上行驶就会绕行更远的路程。 | Record Set |
Route_Shape (可选) | 指定工具输出的路径要素的类型。
当路径形状参数设置为实际形状或具有测量值的实际形状时,可以使用适当的路线简化容差参数值对路径形状的制图综合进行进一步控制。 无论为路径形状参数选择哪个值,最佳路径始终通过最大限度地缩短行驶时间或行驶距离来确定,从不使用停靠点间的直线距离进行确定。这意味着只有路径形状是不同的,而非查找路径时搜索的基础街道。 | String |
Route_Line_Simplification_Tolerance (可选) | 用于简化路径和方向的输出线几何的距离。 如果路径形状参数未设置为实际形状,则工具将忽略此参数。 简化将保留路径上定义路径基本形状所需的关键点(例如交点处的转弯)而删除其他点。指定的简化距离为简化线偏离原始线的最大允许偏移。简化线将减少路径几何中的折点数。这将改善工具的执行时间。 | Linear Unit |
Populate_Directions (可选) | 指定工具是否将为每条路径生成行驶方向。
| Boolean |
Directions_Language (可选) | 在生成行驶方向时使用的语言。 此参数仅在选中填充方向参数(在 Python 中为 True)时使用。 可使用下列两位或五位字符语言代码指定参数值:
工具首先在全部本地化语言中搜索与指定值完全匹配的语言。如果未找到完全匹配,则会尝试匹配语系。如果仍未找到匹配,该工具将会使用默认语言(英语)返回方向。例如,如果将方向指示语言指定为 es-MX(墨西哥西班牙语),则工具将返回西班牙语的指示,因为它支持 es 语言代码但不支持 es-MX。 警告:如果某种语言支持本地化,例如巴西葡萄牙语 (pt-BR) 和欧洲葡萄牙语 (pt-PT),则指定语系和地区。如果您只指定语系,则工具将无法与具体语系匹配,而使用默认语言(英语)返回方向。例如,如果方向语言指定为 pt,则工具将返回英文指示,因为它无法确定应该使用 pt-BR 还是 pt-PT 返回方向。 | String |
Directions_Distance_Units (可选) | 指定在行驶方向中显示行驶距离的单位。此参数仅在选中填充方向参数(在 Python 中为 True)时使用。
| String |
Directions_Style_Name (可选) | 指定方向的格式化样式名称。此参数仅在选中填充方向参数(在 Python 中为 True)时使用。
| String |
Time_Zone_for_Time_of_Day (可选) | 指定时间参数的时区。
无论时间的时区如何设置,如果您的设施点和事件点在多个时区中,则工具将强制执行以下规则:
| String |
Travel_Mode (可选) | 用于在分析中建模的交通模式。出行模式在 ArcGIS Online 中进行管理,组织管理员可通过对其进行配置反映组织工作流。您需要指定组织所支持的出行模式名称。 要获取受支持出行模式名称的列表,请使用与访问此工具时使用的相同 GIS 服务器连接,并在实用程序工具箱中运行 GetTravelModes 工具。GetTravelModes 会将表和支持的出行模式添加到应用程序中。可将“支持的出行模式”表中 Travel Mode Name 字段的任何值指定为输入。您还可以将 Travel Mode Settings 字段中的值指定为输入。由于工具不必根据出行模式名称查找设置,因而减少了工具的执行时间。 默认值,自定义,可以使用自定义出行模式参数(在交汇点处 U 形转弯、应用等级、限制、属性参数值和阻抗)配置您自己的出行模式。自定义出行模式参数的默认值对使用汽车的出行方式建模。您还可以选择自定义并设置上述自定义出行模式参数,从而以快速步行速度对行人建模,或以给定高度、重量和特定危险材料货物对卡车建模。您可以尝试不同的设置以获取所需的分析结果。一旦确定了分析设置,则可使用组织管理员身份并将这些设置保存为新建或现有出行模式的一部分,以便您组织中的所有人均运行相同设置的分析。 警告:选择自定义后,您为自定义出行模式参数设置的值便会包含在分析中。指定您组织定义的其他出行模式,将忽略为自定义出行模式参数设置的所有值;该工具将用您所指定的出行模式中的值将其覆盖。 | String |
Impedance (可选) | 指定阻抗,其值表示沿交通网络的路段或其他部分行进所需的精力或成本。 行程时间是一种阻抗,比如,汽车花费 1 分钟沿空无一人的道路行驶一公里。行程时间会随出行模式的不同而不同(行人可能需要 20 多分钟才能走完一公里),所以在建模时为出行模式选择正确的阻抗非常重要。 行程距离也是一种阻抗,可将以千米表示的道路长度作为阻抗。从这个意义上,行程距离对所有模式均相同,即对行人而言 1 千米的距离对汽车而言也是 1 千米。(但不同模式所允许行进的线路可能会有变化,而这会影响两点间的距离,可通过出行模式设置对此进行建模。) 警告:除非将出行模式设置为自定义(这是默认值),否则会忽略您为此参数提供的值。 从以下阻抗值中选择:
如果选择基于时间的阻抗,例如 TravelTime、TruckTravelTime、Minutes、TruckMinutes 或 WalkTime,则测量单位参数必须设置为基于时间的值。如果选择基于距离的阻抗,例如 Miles 或 Kilometers,则测量单位必须基于距离。 旧版本:不再支持行驶时间、卡车时间、步行时间和行驶距离阻抗值,且将在未来版本中删除。如果您使用上述任一值,则工具将为基于时间的值使用时间阻抗参数,为基于距离的值使用距离阻抗参数。 | String |
Save_Output_Network_Analysis_Layer (可选) | 指定是否将分析设置保存为网络分析图层文件。即使在 ArcGIS Desktop 应用程序(例如 ArcMap)中打开文件,仍然无法直接使用此文件。需要将其发送至 Esri 技术支持以诊断工具所返回结果的质量。
| Boolean |
Overrides (可选) | 求解网络分析问题时可影响求解程序行为的其他设置。 必须在 JavaScript 对象表示法 (JSON) 中指定此参数的值。例如,有效值的格式如下:{"overrideSetting1" : "value1", "overrideSetting2" : "value2"}。覆盖设置名称始终以双引号括起。该值可以是数字、布尔值或字符串。 此参数的默认值为无值,表示不覆盖任何求解程序设置。 覆盖是高级设置,应仅在谨慎分析应用设置前后得到的结果之后使用。要获得每个求解程序支持的覆盖设置及其可接受值的列表,请联系 Esri 技术支持。 | string |
Save_Route_Data (可选) | 指定输出中是否包括含有某类文件地理数据库的 .zip 文件,该类文件地理数据库通过可与 ArcGIS Online 或 Portal for ArcGIS 共享路径图层的格式保存分析的输入和输出。
| Boolean |
Time_Impedance (可选) | 基于时间的阻抗是用于表示沿交通网络的路段或其他部分行进所需出行时间的值。 注:如果使用阻抗参数指定的出行模式阻抗是基于时间的,则时间阻抗和阻抗参数的值必须相同。否则,服务将返回错误。 | String |
Distance_Impedance (可选) | 基于距离的阻抗是用于表示沿交通网络的路段或其他部分行进所需出行时间的值。 注:如果使用阻抗参数指定的出行模式阻抗是基于距离的,则距离阻抗和阻抗参数的值必须相同。否则,服务将返回错误。 | String |
Output_Format (可选) | 指定创建输出要素的格式。
如果指定文件基于输出格式(如 JSON 文件或 GeoJSON 文件),则不会向显示添加输出,因为应用程序(例如 ArcMap 或 ArcGIS Pro)无法绘制结果文件的内容。相反,结果文件将下载到计算机上的临时目录中。在 ArcGIS Pro 中,可以通过查看输出结果文件参数的值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具执行相对应的条目中。在 ArcMap 中,可以通过访问输出结果文件参数上的快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具执行对应的条目中。 | String |
派生输出
名称 | 说明 | 数据类型 |
Solve_Succeeded | 指示是否成功求解最近设施点分析。 | 布尔型 |
Output_Routes | 将提供对生成的路径或设施点与事件点之间路径的访问权限。 | 要素集 |
Output_Directions | 将提供对每个生成路径转弯方向的访问权限。 | 要素集 |
Output_Closest_Facilities | 将提供对最近设施点分析中的输出设施点的访问权限。 | 要素集 |
Output_Network_Analysis_Layer | 网络分析图层可用于在地图中进行进一步分析或调试,其属性可在工具参数中配置。 | 文件 |
Output_Route_Data | 包含特定路径的所有信息的 .zip 文件。 | 文件 |
Output_Incidents | 将提供对在最近设施点分析中用作起点或终点的位置的访问权限。 | 要素集 |
Output_Facilities | 分析中使用的设施点。 | 要素集 |
Output_Result_File | 包含分析结果的 .zip(每个输出有一个或多个文件)。单个文件的格式由输出格式参数指定。 | 文件 |
代码示例
以下 Python 脚本演示了如何在脚本中使用 Find Closest Facilities 工具。
"""This example shows how to find three closest stores from each customer location."""
import sys
import time
import arcpy
# Change the username and password applicable to your own ArcGIS Online account
username = "<your user name>"
password = "<your password>"
cf_service = "https://logistics.arcgis.com/arcgis/services;World/ClosestFacility;{0};{1}".format(username, password)
# Add the geoprocessing service as a toolbox.
# Check https://pro.arcgis.com/en/pro-app/2.6/arcpy/functions/importtoolbox.htm for
# other ways in which you can specify credentials to connect to a geoprocessing service.
arcpy.ImportToolbox(cf_service)
# Set the variables to call the tool
facilities = "C:/data/Inputs.gdb/Stores"
incidents = "C:/data/Inputs.gdb/Customers"
output_routes = "C:/data/Results.gdb/Routes"
output_closest_facilities = "C:/data/Results.gdb/ClosestStores"
# Call the tool
result = arcpy.FindClosestFacilities_ClosestFacility(incidents, facilities, "Minutes", "", 3)
arcpy.AddMessage("Running the analysis with result ID: {}".format(result.resultID))
# Check the status of the result object every 1 second until it has a
# value of 4 (succeeded) or greater
while result.status < 4:
time.sleep(1)
# print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
arcpy.AddError("An error occured when running the tool")
arcpy.AddError(result.getMessages(2))
sys.exit(2)
elif result_severity == 1:
arcpy.AddWarning("Warnings were returned when running the tool")
arcpy.AddWarning(result.getMessages(1))
# Save the output routes and the closest facilities to a geodatabase
result.getOutput(0).save(output_routes)
result.getOutput(3).save(output_closest_facilities)
以下示例将显示如何使用自定义出行模式来执行最近设施点分析。
"""This example shows how to perform a closest facility analysis using a custom travel mode
that models trucks carrying wide load."""
import sys
import time
import json
import arcpy
username = "<your user name>"
password = "<your password>"
cf_service = "https://logistics.arcgis.com/arcgis/services;World/ClosestFacility;{0};{1}".format(username, password)
# Add the geoprocessing service as a toolbox
arcpy.ImportToolbox(cf_service)
# Set the variables to call the tool
facilities = "C:/data/Inputs.gdb/Stores"
incidents = "C:/data/Inputs.gdb/Customers"
output_routes = "C:/data/Results.gdb/Routes"
output_closest_facilities = "C:/data/Results.gdb/ClosestStores"
# Change Vehicle Width attribute parameter value to 4.5 (about 15 feet) for the Trucking Time travel mode
# used for the analysis
portal_url = "https://www.arcgis.com"
arcpy.SignInToPortal(portal_url, username, password)
travel_mode_list = arcpy.na.GetTravelModes(portal_url)
tt = travel_mode_list["Trucking Time"]
tt_json = str(tt)
tt_dict = json.loads(tt_json)
tt_dict["restrictionAttributeNames"].append("Width Restriction")
for attr_param in tt_dict["attributeParameterValues"]:
if attr_param['attributeName'] == 'Width Restriction' and attr_param['parameterName'] == 'Vehicle Width (meters)':
attr_param['value'] = 4.5
travel_mode = json.dumps(tt_dict)
# Call the tool
result = arcpy.FindClosestFacilities_ClosestFacility(incidents, facilities, "Minutes", "", 2,
Travel_Mode=travel_mode)
# Check the status of the result object every 1 second until it has a
# value of 4 (succeeded) or greater
while result.status < 4:
time.sleep(1)
# print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
arcpy.AddError("An error occured when running the tool")
arcpy.AddError(result.getMessages(2))
sys.exit(2)
elif result_severity == 1:
arcpy.AddWarning("Warnings were returned when running the tool")
arcpy.AddWarning(result.getMessages(1))
# Save the output routes and the closest facilities to a geodatabase
result.getOutput(0).save(output_routes)
result.getOutput(3).save(output_closest_facilities)