查找最近设施点 (即用型)

摘要

基于行驶时间或行驶距离查找离事件点最近的一个或多个设施点,输出最佳路径、事件点间的行驶方向、选定的设施点以及选定设施点的副本。 例如,您可以使用此工具查找离事故地点最近的医院、离犯罪现场最近的警车或者是离客户地址最近的商店。

查找最近设施点时,您可以指定查找数量和行驶方向(驶向设施点或驶离设施点)。 您可以指定一天中的某个时间,然后根据该时间和日期的实时或预测交通状况计算行驶时间。 例如,您可以使用此工具搜索距离事故发生地点行驶时间在 15 分钟(根据给定的一天中的时间计算)以内的医院。 查找结果中将不会包含任何基于交通条件行程时间超出 15 分钟的医院。

旧版本:
此工具已弃用。 有关如何从网络分析图库执行网络分析工作流程的更多信息,请参阅帮助文章

插图

FindClosestFacilities 结果

使用情况

  • 即用型工具箱中的工具是利用 ArcGIS Online 托管数据和分析功能的 ArcGIS Online 地理处理服务。

  • 如果测量单位参数是基于时间的,则该工具会根据行驶时间查找最近设施点。 同样,若测量单位是基于距离的,则工具会使用行驶距离。

  • 要成功运行该工具,您必须至少指定一个设施点和一个事件点。 最多可以加载 5,000 个设施点和 5,000 事件点,且最多可以为每个事件点查找到 100 个最近设施点。 因此,工具的每个解决方案最多能找到 500,000 个最近设施点。

  • 最多可以添加 250 个点障碍。 您可以添加任意数量的线障碍或面障碍,但线障碍的相交数不能超过 500 个街道要素,面障碍的相交数不能超过 2,000 个要素。

  • 求解时可选择使用道路等级以更快地生成结果,但解决方案可能欠佳。

  • 无论是否选中使用等级参数 (True),只要代表事件点或设施点的任何一对要素之间的直线距离大于 50 英里(80.46 公里),便会使用等级。

  • 出行模式设置为步行时或者设置为自定义并且使用步行约束条件时,代表事件点或设施点的任意一对要素之间的直线距离不得大于 27 英里(43.45 千米)。

  • 如果输入点与其最近的可穿过街道之间的距离大于 12.42 英里(20 千米),则将从分析中排除该点。

  • 使用此服务会消耗配额。 有关详细信息,请参阅服务配额概述。

参数

标注说明数据类型
事件点

在最近设施点分析中用作起点或终点的位置。

可指定一个或多个事件点(最多 5,000 个)。工具将在这些位置中搜索附近的位置。

指定事件点后,可使用以下特性为每个事件点设置属性,例如事件点的名称或服务时间。

Name

事件点的名称。该名称用于行驶方向中。如果未指定名称,则会在输出路径和方向中自动生成前缀为 Location 的唯一名称。

ID

事件点的唯一标识符。该标识符包含在输出路径中(作为 IncidentID 字段),且有助于将输出路径的附加信息(例如总行驶时间或总距离)连接到事件点的属性中,反之亦然。如果未指定 ID,则服务将为每个事件点自动生成一个唯一的标识符。

AdditionalTime

在事件点所花费的时间,该时间将被添加到路径总时间中。默认值为 0。

该属性值的单位由测量单位参数指定。仅在测量单位基于时间时,属性值才能包含在分析中。

例如,如果您要查找距火灾事件点最近的消防站以估算响应时间,AdditionalTime 属性可存储消防人员开始灭火前在事件点位置连接装备所花费的时间。

AdditionalDistance

在事件点所行驶的额外距离,该距离将被添加到路径总距离中。默认值为 0。

该属性值的单位由测量单位参数指定。仅在测量单位基于距离时,属性值才能包含在分析中。

通常,事件点的位置(例如住宅)并不是恰好位于街道上,而是位于道路的后方。该属性值可用于构建事件点位置与其在街道上的位置之间的距离,如有必要,将此段距离包括在总行驶距离中。

AdditionalCost

在事件点花费的额外成本,该成本将被添加到路径总距离中。默认值为 0。

当分析的出行模式使用不基于时间也不基于距离的阻抗属性时,应使用此属性值。属性值的单位将理解为未知单位。

TargetFacilityCount

需要为指定事件点查找的设施点的数量。此字段允许您为每个事件点指定要查找的不同数量的设施点。例如,使用此字段,您可以找到距一个事件点最近的三个设施点,以及距另一个事件点最近的两个设施点。

Cutoff

停止从指定事件点搜索设施点时所对应的阻抗值。此属性允许您为每个事件点指定不同的中断值。例如,使用此属性,您可以搜索距一个事件点五分钟行驶时间以内的设施点,并搜索距另一个事件点八分钟行驶时间以内的设施点。

CurbApproach

指定车辆到达和离开事件点的方向。该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0 (Either side of vehicle)—The vehicle can approach and depart the incident in either direction, so a U-turn is allowed at the incident. This setting can be chosen if it is possible and practical for a vehicle to turn around at the incident. This decision may depend on the width of the road and the amount of traffic or whether the incident has a parking lot where vehicles can pull in and turn around.
  • 1 (Right side of vehicle)—When the vehicle approaches and departs the incident, the curb must be on the right side of the vehicle. A U-turn is prohibited. This is typically used for vehicles such as buses that must arrive with the bus stop on the right-hand side.
  • 2 (Left side of vehicle)—When the vehicle approaches and departs the incident, the curb must be on the left side of the vehicle. A U-turn is prohibited. This is typically used for vehicles such as buses that must arrive with the bus stop on the left-hand side.
  • 3 (No U-Turn)—When the vehicle approaches the incident, the curb can be on either side of the vehicle; however, the vehicle must depart without turning around.

CurbApproach 属性是专为使用以下两种国家驾驶标准而设计的:右侧通行(美国)和左侧通行(英国)。首先,考虑位于车辆左侧的事件点。不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。不同国家的驾驶标准可能会要求您从这两种方向中的其中一个接近事件点,也就是说,只能从车辆的右侧或左侧接近事件点。例如,如果要到达一个事件点并且在车辆与事件点之间不存在其他交通车道,那么在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。

Bearing

点移动的方向。 单位为度,从正北开始沿顺时针方向进行测量。 该字段与 BearingTol 字段结合使用。

方位角数据通常会从配有 GPS 接收器的移动设备自动发送。 如果正在加载移动输入位置(例如行人或车辆),请尝试包括方位角数据。

使用该字段可以防止将位置添加到错误的边上,例如,车辆刚好在交叉路口或天桥附近时。 方位角也可帮助工具确定点在街道的哪一边上。

BearingTol

使用 Bearing 字段在边上定位移动点时,方位角容差值将创建一个可接受方位角值的范围。 如果 Bearing 字段值在可接受值范围(由边上的方位角容差生成)内,则可以将该点作为网络位置添加在此处,否则,将计算下一个最近边上的最近点。

单位为度,默认值为 30。 值必须大于 0 且小于 180。 值为 30 表示,Network Analyst 尝试在边上添加网络位置时,在边的每一侧(左侧和右侧)的两个数字化方向上都将生成一个 15 度的可接受方位角值。

NavLatency

如果 BearingBearingTol 也具有值,则该字段只在求解过程中使用;但是,即使当 BearingBearingTolNavLatency 字段中有值时,NavLatency 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要花费的成本。

NavLatency 的单位与阻抗属性的单位相同。

Feature Set
设施点

在最近设施点分析中用作起点或终点的位置。

可指定一个或多个设施点(最多 5,000 个)。以下为查找最近位置时所搜索的位置。

指定设施点后,可使用以下特性为每个事件点设置属性,例如事件点的名称或服务时间。

Name

设施点的名称。该名称用于行驶方向中。如果未指定名称,则会在输出路径和方向中自动生成前缀为 Location 的唯一名称。

ID

设施点的唯一标识符。该标识符作为 FacilityID 字段包含在输出路径和输出最近设施点中。FacilityID 字段可用于将输出路径的附加信息(例如总行驶时间或总距离)连接到设施点的属性中。如果未指定 ID,则服务将为每个设施点自动生成一个唯一的标识符。

AdditionalTime

在设施点所花费的时间,该时间将被添加到路径总时间中。默认值为 0。

该属性值的单位由测量单位参数指定。仅在测量单位基于时间时,属性值才能包含在分析中。

例如,如果您要查找离火灾事件点最近的消防站,AdditionalTime 可存储消防人员穿好适当的防护装备和离开消防站所花费的时间。

AdditionalDistance

在设施点所行驶的额外距离,该距离将被添加到路径总距离中。默认值为 0。

该属性值的单位由测量单位参数指定。仅在测量单位基于距离时,属性值才能包含在分析中。

通常,设施点的位置(例如消防站)并不是恰好位于街道上,而是位于道路的后方。AdditionalDistance 可用于构建设施点位置与其在街道上的位置之间的距离,如有必要,将此段距离包括在总行驶距离中。

AdditionalCost

在设施点花费的额外成本,该成本将被添加到路径总距离中。默认值为 0。

当分析的出行模式使用不基于时间也不基于距离的阻抗属性时,应使用此属性值。属性值的单位将理解为未知单位。

Cutoff

停止从指定设施点搜索事件点时所对应的阻抗值。此属性允许您为每个设施点指定不同的中断值。例如,使用此属性,您可以搜索距一个设施点五分钟行驶时间以内的事件点,并搜索距另一个设施点八分钟行驶时间以内的事件点。

CurbApproach

指定车辆到达和离开设施点的方向。

  • 0(车辆的任意一侧)- 车辆可从任一方向到达和离开设施点,因此设施点处允许 U 形转弯。如果车辆有可能要在设施点处调头,则可以选择该设置。此决策可能取决于道路的宽度以及交通量,或者该设施点是否有停车场能让车辆驶入并调头。
  • 1(车辆的右侧)- 当车辆到达和离开设施点时,设施点必须在车辆右侧。禁止 U 形转弯。通常用于必须在右侧停靠的车辆(如公共汽车)。
  • 2(车辆的左侧)- 当车辆到达和离开设施点时,路边必须在车辆左侧。禁止 U 形转弯。通常用于必须在左侧停靠的车辆(如公共汽车)。
  • 3(禁止 U 形转弯)- 当车辆到达设施点时,路边可在车辆的任意一侧;但是,车辆在离开时不得调头。

CurbApproach 属性是专为使用以下两种国家驾驶标准而设计的:右侧通行(美国)和左侧通行(英国)。首先,考虑位于车辆左侧的设施点。不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。不同国家的驾驶标准可能会要求您从这两种方向中的其中一个接近设施点,也就是说,只能从车辆的右侧或左侧接近设施点。例如,如果要到达一个设施点并且在车辆与设施点之间不存在其他交通车道,那么在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。

Bearing

点移动的方向。 单位为度,从正北开始沿顺时针方向进行测量。 该字段与 BearingTol 字段结合使用。

方位角数据通常会从配有 GPS 接收器的移动设备自动发送。 如果正在加载移动输入位置(例如行人或车辆),请尝试包括方位角数据。

使用该字段可以防止将位置添加到错误的边上,例如,车辆刚好在交叉路口或天桥附近时。 方位角也可帮助工具确定点在街道的哪一边上。

BearingTol

使用 Bearing 字段在边上定位移动点时,方位角容差值将创建一个可接受方位角值的范围。 如果 Bearing 字段值在可接受值范围(由边上的方位角容差生成)内,则可以将该点作为网络位置添加在此处,否则,将计算下一个最近边上的最近点。

单位为度,默认值为 30。 值必须大于 0 且小于 180。 值为 30 表示,Network Analyst 尝试在边上添加网络位置时,在边的每一侧(左侧和右侧)的两个数字化方向上都将生成一个 15 度的可接受方位角值。

NavLatency

如果 BearingBearingTol 也具有值,则该字段只在求解过程中使用;但是,即使当 BearingBearingTolNavLatency 字段中有值时,NavLatency 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要花费的成本。

NavLatency 的单位与阻抗属性的单位相同。

Feature Set
测量单位

指定用于测量和报告输出路径的总行驶时间或行驶距离的单位。该工具可通过测量行驶时间或沿街道行驶距离查找最近设施点。

为此参数指定的单位可以确定工具将测量行驶距离还是行驶时间来查找最近位置。选择时间单位以测量行驶时间。要测量行驶距离,则请选择距离单位。选择的单位还确定工具在结果中报告总行驶时间或距离时采用的单位。

  • 线性单位将为米。
  • 千米线性单位将为公里。
  • 英尺线性单位将为英尺。
  • 线性单位将为码。
  • 英里线性单位将为英里。
  • 海里线性单位将为海里。
  • 时间单位将为秒。
  • 时间单位将为分钟。
  • 小时时间单位将为小时。
  • 时间单位将为天。
String
分析区域
(可选)

将在其中执行分析的区域。 如果未对此参数指定值,工具会基于输入点的位置自动计算区域名称。 仅当自动检测的区域名称输入不准确时,才需要设置区域名称。

要指定区域,请使用以下值之一:

  • 欧洲分析区域为欧洲。
  • 日本分析区域为日本。
  • 韩国分析区域为韩国。
  • 中东和非洲分析区域为中东和非洲。
  • 北美分析区域为北美洲。
  • 南美洲分析区域为南美洲。
  • 南亚分析区域为南亚。
  • 泰国分析区域为泰国。
旧版本:

不再支持以下区域名称,且将在未来版本中删除这些名称。 如果您指定了任一已弃用的区域名称,则工具会自动为您所在的区域分配支持的区域名称。

  • 希腊将重定向到欧洲
  • 印度将重定向到南亚
  • 大洋洲将重定向到南亚
  • 东南亚将重定向到南亚
  • 台湾将重定向到南亚

String
要查找的设施点数
(可选)

要按事件点查找的最近设施点数。在可能需要来自不同消防站的多辆消防车的情况(例如火灾)中,此项非常有用。例如,您可以指定查找距离起火地点最近的三个消防站。

在此参数中设置的值可以通过输入事件点中的 TargetFacilityCount 字段覆盖每个事件点。

该工具最多可为每个事件点查找 100 个设施点。

Long
中断
(可选)

对于给定事件点,停止搜索设施点的行驶时间或行驶距离值。例如,在查找距离事故地点最近的医院时,如果中断值设为 15 分钟,则表示工具将搜索距离事件点 15 分钟车程以内的最近医院。如果到达最近的医院需要 17 分钟的车程,则在输出路径中不会返回任何路线。在搜索多个设施点时,中断值尤为有用。

行驶方向参数设置为设施点到事件点时,中断可以通过输入设施点中的 Cutoff 字段覆盖每个设施点。当行驶方向参数设置为事件点到设施点时,中断可以通过输入事件点中的 Cutoff 字段覆盖每个事件点。

该参数的单位由测量单位参数指定。

Double
行驶方向
(可选)

指定如何测量最近设施点搜索的行驶方向。

每个选项找到的设施点可能不同,因为沿某些街道的行驶时间可能会随行驶方向和单行线限制而发生变化。例如,从事件点行驶到设施点时,可能需要 10 分钟,而从设施点行驶到事件点时,由于该方向上的行驶时间不同,可能需要 15 分钟。

如果您还要设置时间参数的值,交通状况也可能导致设施点到事件点事件点到设施点选项返回不同的结果。

消防部门通常使用参数的设施点到事件点值,因为他们需要关注从消防站(设施点)行驶到紧急救援位置(事件点)所需的时间。零售商店(设施点)管理层则更关注顾客(事件点)到达商店(设施点)所需的时间;因此,商店管理层通常选择事件点到设施点

  • 设施点到事件点从设施点到事件点的行驶方向。
  • 事件点到设施点从事件点到设施点的行驶方向。
String
应用等级
(可选)

指定是否将在查找设施点和事件点之间的最佳路径时使用等级。

  • 选中(在 Python 中为 True)- 查找路径时将使用等级。在应用等级时,相比低等级的街道(例如地方道路),该工具会优先标识等级较高的街道(例如高速公路),且该工具可以用于模拟驾驶员对在高速公路(而非地方道路)上行驶的偏好,即使这意味着行程更远。查找远距离设施点的路径时尤为有用,因为长途驾驶员往往更偏好于在高速公路上行驶,这样可以避免停靠、交叉路口和转弯。应用等级可实现更快的计算速度,尤其是对于长途路径来说,因为该工具需要在相对较小的街道子集中标识最佳路径。
  • 未选中(在 Python 中为 False)- 查找路径时不会使用等级。如果没有应用等级,该工具就会考虑所有的街道且在选择路线时并不一定标识等级较高的街道。这常用于在市内查找短途路径。

如果设施点和事件点间的直线距离大于 50 英里,即使未选中此参数(在 Python 中设置为 False),工具也会自动恢复为使用等级。

Boolean
时间
(可选)

路线开始或结束的时间和日期。该值根据时间用法参数的值可用作路径的起始时间或结束时间。如果您指定当前日期和时间作为该参数的值,则工具将使用实时交通状况查找最近设施点,并且总行驶时间将基于交通状况提供。

指定时间可实现更加准确的事件点和设施点之间的行驶时间评估,因为行驶时间会考虑该日期和时间对应的交通状况。

时间的时区参数指定该时间和日期是参考 UTC 还是设施点或事件点所在时区。

Date
时间用法
(可选)

指定时间参数值是表示路径的到达时间还是出发时间。

  • 开始时间该工具会将时间参数值视为从设施点或事件点开始寻找最佳路径的出发时间。
  • 结束时间该工具会将时间参数值视为从设施点或事件点开始寻找最佳路径的到达时间。 如果想知道从地点出发的时间,从而能在时间指定的时间到达目的地,该选项将十分有用。
String
在交汇点处 U 形转弯
(可选)

指定交汇点的 U 形转弯策略。 允许 U 形转弯表示求解程序可以在交汇点处转向并沿同一街道往回行驶。 考虑到交汇点表示街道交叉路口和死角,不同的车辆可以在某些交汇点转弯,而在其他交汇点则不行 - 这取决于交汇点是交叉路口还是死角。 为适应此情况,U 形转弯策略参数由连接到交汇点的边数隐性指定,这称为交汇点价。 此参数可接受的值如下所列;每个值的后面是根据交汇点价对其含义的描述。

除非将出行模式设置为自定义,否则会忽略此参数。

  • 允许无论在交汇点处有几条连接的边,均允许 U 形转弯。 这是默认值。
  • 不允许在所有交汇点处均禁止 U 形转弯,不管交汇点原子价如何。 但是,即使已选择该选项,在网络位置仍允许 U 形转弯;但是也可以通过设置个别网络位置的 CurbApproach 属性来禁止 U 形转弯。
  • 仅在死角处允许除仅有一条相邻边的交汇点(死角)外,其他交汇点均禁止 U 形转弯。
  • 仅在交点和死角处允许在恰好有两条相邻边相遇的交汇点处禁止 U 形转弯,但是交叉点(三条或三条以上相邻边的交汇点)和死角(仅有一条相邻边的交汇点)处允许。 通常,网络在路段中间有多余的交汇点。 此选项可防止车辆在这些位置掉头。
String
点障碍
(可选)

使用此参数可指定一个或多个点作为临时限制,或表示在基础街道上行驶可能需要的附加时间或距离。 例如,点障碍可用来显示一棵沿街倒下的树或是铁路道口上的时间延迟。

工具限制了可添加为障碍的点不得超过 250 个。

指定点障碍后,可通过使用以下属性为每个事件点设置属性,例如其名称或障碍类型:

Name

障碍名称。

BarrierType

指定点障碍是完全限制通行还是增加通过障碍时的时间或距离。 此特性值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0(限制型)- 禁止穿过障碍。 此障碍称为限制型点障碍,因为它作为限制使用。

  • 2(增加成本型)- 穿过此障碍会增加通过 Additional_TimeAdditional_DistanceAdditionalCost 字段指定的行驶时间或行驶距离的数值。 此障碍类型称为增加成本型点障碍。

Additional_Time

穿越障碍时增加的行驶时间。 此字段仅适用于增加成本型障碍,且仅在测量单位参数值基于时间时适用。

此字段值必须大于或等于零,并且其单位必须与在测量单位参数中指定的单位相同。

Additional_Distance

穿越障碍时增加的距离。 此字段仅适用于增加成本型障碍,且仅在测量单位参数值基于距离时适用。

该字段值必须大于或等于零,并且其单位必须与在测量单位参数中指定的单位相同。

AdditionalCost

穿越障碍时增加的成本。 当测量单位参数值不基于时间或距离时,此字段仅适用于增加成本型障碍。

FullEdge

指定分析期间如何将限制点障碍应用于边元素。 该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0 (False) - 允许沿边行进到障碍,但不允许穿过障碍。 这是默认值。
  • 1 (True) - 禁止沿关联边的任何位置行进。

CurbApproach

指定受障碍影响的行驶方向。 该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0(车辆的任一侧)- 障碍将影响在边左右两个方向上行驶的车辆。
  • 1(车辆右侧)- 只会影响车辆的右行方向(障碍位于车辆左侧)。 在同一条边上行驶但从左侧接近障碍的车辆不会受到障碍的影响。
  • 2(车辆左侧)- 只会影响车辆的左行方向(障碍位于车辆左侧)。 在同一条边上行驶但从右侧接近障碍的车辆不会受到障碍的影响。

由于交汇点是点且不分左右侧,所以无论路边通道如何设置,交汇点上的障碍都会影响所有车辆。

CurbApproach 属性适用于以下两种国家驾驶标准:右侧通行(美国)和左侧通行(英国)。 首先,考虑位于车辆左侧的设施点。 不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。 不同国家的驾驶标准可能会要求您从这两种方向中的其中一个接近设施点,也就是说,只能从车辆的右侧或左侧接近设施点。 例如,要到达一个设施点并且在车辆与设施点之间不存在其他交通车道,应在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。

Bearing

点移动的方向。 单位为度,从正北开始沿顺时针方向进行测量。 该字段与 BearingTol 字段结合使用。

方位角数据通常会从配有 GPS 接收器的移动设备自动发送。 如果正在加载移动输入位置(例如行人或车辆),请尝试包括方位角数据。

使用该字段可以防止将位置添加到错误的边上,例如,车辆刚好在交叉路口或天桥附近时。 方位角也可帮助工具确定点在街道的哪一边上。

BearingTol

使用 Bearing 字段在边上定位移动点时,方位角容差值将创建一个可接受方位角值的范围。 如果 Bearing 字段值在可接受值范围(由边上的方位角容差生成)内,则可以将该点作为网络位置添加在此处,否则,将计算下一个最近边上的最近点。

单位为度,默认值为 30。 值必须大于 0 且小于 180。 值为 30 表示,Network Analyst 尝试在边上添加网络位置时,在边的每一侧(左侧和右侧)的两个数字化方向上都将生成一个 15 度的可接受方位角值。

NavLatency

如果 BearingBearingTol 也具有值,则该字段只在求解过程中使用;但是,即使当 BearingBearingTolNavLatency 字段中有值时,NavLatency 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要花费的成本。

NavLatency 的单位与阻抗属性的单位相同。

Feature Set
线障碍
(可选)

使用此参数可指定一条或多条线,用于禁止在线与街道相交的位置通行。 例如,线障碍可用于对阻塞若干个路段交通的游行或抗议队伍进行建模。 线障碍还可隔离多条道路以禁止进行遍历,从而在可能的路径中去除不符合要求的街道网络部分。

该工具限制了您可以使用线障碍参数限制的街道数量。 可指定为线障碍的线数没有限制时,所有线的相交街道的合并数不能超过 500

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

Name

障碍名称。

Feature Set
面障碍
(可选)

使用此参数可指定面,用于完全限制通行或按比例调整行驶在面相交的街道上所需的行驶时间或距离。

该服务限制了您可以使用面障碍参数限制的街道数量。 可指定为面障碍的面数没有限制时,所有面的相交街道的合并数不能超过 2,000

指定面障碍时,可通过使用以下属性为每个面障碍设置属性,例如名称或障碍类型:

Name

障碍名称。

BarrierType

指定障碍是完全禁止通行还是按比例调整穿过成本(例如时间或距离)。 该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0(限制型)- 禁止穿过障碍的任何部分。 此障碍称作限制型面障碍,因为它禁止在与障碍相交的街道上行驶。 此类障碍的一个具体应用是对覆盖街道中某些区域且导致街道无法通行的洪水进行建模。

  • 1(按比例调整成本型)- 根据使用 ScaledTimeFactorScaledDistanceFactor 字段指定的系数,按比例调整在基础街道上行驶所需的成本(例如行驶时间或距离)。 如果障碍部分覆盖了街道,则会按比例调整行驶时间或行驶距离。 例如,系数 0.25 表示在基础街道上行进的速度是正常速度的四倍。 系数 3.0 表示预期在基础街道上行进相同距离所花费的时间为正常值的三倍。 此障碍类型称为调整成本型面障碍。 例如,可使用该障碍对导致特定区域的行进速度减慢的暴风雨进行建模。

ScaledTimeFactor

它是与障碍相交街道的行驶时间要乘以的因子。 该字段值必须大于零。

此字段仅适用于按比例调整成本型障碍且仅在测量单位参数基于时间时适用。

ScaledDistanceFactor

它是与障碍相交街道的距离要乘以的因子。 该字段值必须大于零。

此字段仅适用于按比例调整成本型障碍且仅在测量单位参数基于距离时适用。

ScaledCostFactor

这是与障碍相交的街道的成本要乘以的系数。 该字段值必须大于零。

此字段仅适用于按比例调整成本型障碍且仅在测量单位参数既不基于时间也不基于距离时适用。

Feature Set
约束条件
(可选)

在查找最佳路径时工具应使用的限制。

限制表示行驶偏好或要求。 大多数情况下,限制条件会导致道路禁行。 例如,使用“避开收费公路”限制的结果是,仅在访问某一事件点或设施点需要借道收费公路时,才会生成一条包含该收费公路的路径。 高度限制则使您可以绕开低于车辆高度的间隙。 如果车辆上装载着腐蚀性物质,使用“禁止任何危险物品”限制将防止在标记着运输腐蚀性材料为非法行为的路上运输这些材料。

注:

某些限制需要指定一个额外值以供它们使用。 该值必须与限制名称和用于限制的特定参数相关联。 可识别名称在属性参数值参数的 AttributeName 列中显示的限制。 在查找可遍历道路时,要正确使用限制,请指定属性参数值参数的 ParameterValue 字段。

注:

有些限制仅适用于某些国家/地区;下表按区域显示了这些限制的可用性。 关于在某区域内可用性有限的限制,通过在网络分析覆盖范围上查看“国家/地区列表”部分中的表,可以确定该限制在特定国家/地区是否可用。 如果一个国家/地区具有 Logistics Attribute 列的 Yes 值,则该国家/地区支持具有区域可选性的限制。 如果您指定的限制名称在事件点所在的国家/地区不可用,该服务会忽略无效限制。 该服务还会忽略约束条件用法属性参数值为 0 到 1(请参阅属性参数值参数)时的约束条件。 它会禁止约束条件用法参数值大于 0 时的所有约束条件。

该工具支持以下约束条件:

  • 禁止任何危险物品结果将不包含禁止运输任何危险类型材料的道路。可用性:在北美洲及欧洲选择国家
  • 避开拼车道路结果将避开专供拼车(高承载)车辆行使的道路。可用性:所有国家
  • 避开快速车道结果将避开指定为快速车道的道路。可用性:所有国家
  • 避开轮渡结果将避开轮渡。可用性:所有国家
  • 避开关口结果将避开存在关键通道或守卫控制入口等关口的道路。可用性:所有国家
  • 避开限行道路结果将避开限制进入高速公路的道路。可用性:所有国家
  • 避开私家道路结果将避开非公有和维护的道路。可用性:所有国家
  • 避开不适合行人的道路结果将避开不适合行人的道路。可用性:所有国家
  • 避开楼梯结果将避开行人适合路线上的所有楼梯。可用性:所有国家
  • 避开收费公路结果将避开汽车收费公路。可用性:所有国家
  • 避开卡车收费公路结果将避开卡车收费公路。可用性:所有国家
  • 避开货车禁行道路结果将避开禁止货车通行的道路,除非正在进行配送。可用性:所有国家
  • 避开未铺设道路结果将避开未铺设(例如,泥土、砾石等)的道路。可用性:所有国家
  • 轴计数限制结果将不包含具有指定轴数的卡车禁行的道路。 可使用车轴数限制参数指定车轴数。可用性:在北美洲及欧洲选择国家
  • 驾驶公共汽车结果将不包含公共汽车禁行的道路。 使用此约束条件还将确保结果支持单行道。可用性:所有国家
  • 驾驶出租车结果将不包含出租车禁行的道路。 使用此约束条件还将确保结果支持单行道。可用性:所有国家
  • 驾驶货车结果将不包含卡车禁行的道路。 使用此约束条件还将确保结果支持单行道。可用性:所有国家
  • 驾驶汽车结果将不包含汽车禁行的道路。 使用此约束条件还将确保结果支持单行道。可用性:所有国家
  • 驾驶急救车辆结果将不包含急救车辆禁行的道路。 使用此约束条件还将确保结果支持单行道。可用性:所有国家
  • 高度限制结果将不包含车辆高度超出道路所允许的最大高度的道路。 可使用“车辆高度(米)”限制参数指定车辆高度。可用性:在北美洲及欧洲选择国家
  • 主销到后轴长度限制结果将不包含车辆长度超出路上所有货车所允许的主销到后轴最大长度的道路。 可使用“车辆主销到后轴长度(米)”限制参数指定车辆中心立轴与后轴之间的长度。可用性:在北美洲及欧洲选择国家
  • 长度限制结果将不包含车辆长度超出道路所允许的最大长度的道路。 可使用“车辆长度(单位为米)”限制参数指定车辆长度。可用性:在北美洲及欧洲选择国家
  • 行人首选结果将使用适合行人导航的首选路线。可用性:在北美洲及欧洲选择国家
  • 骑摩托车结果将不包含摩托车禁行的道路。 使用此约束条件还将确保结果支持单行道。可用性:所有国家
  • 禁止在建道路结果将不包含在建道路。可用性:所有国家
  • 禁止带有一个或多个拖车的半挂车或牵引车结果将不包含带有一个或多个拖车的半挂车或牵引车禁行的道路。可用性:在北美洲及欧洲选择国家
  • 禁止单轴车辆结果将不包含单轴车辆禁行的道路。可用性:在北美洲及欧洲选择国家
  • 禁止双轴车辆结果将不包含双轴车辆禁行的道路。可用性:在北美洲及欧洲选择国家
  • 禁止过境交通结果将不包含禁止过境交通(非本地)的道路。可用性:所有国家
  • 带拖车的卡车限制结果将不包含具有指定拖车数量的货车禁行的道路。 可使用“卡车上的拖车数量”限制参数指定卡车的拖车数量。可用性:在北美洲及欧洲选择国家
  • 使用首选危险物品路径结果将优先选择专用于运输危险类型材料的道路。可用性:在北美洲及欧洲选择国家
  • 使用首选卡车路径结果将优先选择指定为卡车路径的道路,例如,由美国的《国家地面交通援助法案》指定为国家网络的一部分的道路,由州或省指定为卡车路径的道路,或在某区域内驾驶卡车的首选道路。可用性:在北美洲及欧洲选择国家
  • 步行结果将不包含行人禁行的道路。可用性:所有国家
  • 重量限制结果将不包含车辆重量超出道路所允许的最大重量的道路。 可使用“车辆重量(千克)”限制参数指定车辆重量。可用性:在北美洲及欧洲选择国家
  • 轴负重限制结果将不包含车辆轴负重超出道路所允许的最大轴负重的道路。 可使用“车辆轴负重(千克)”限制参数指定车辆轴负量。可用性:在北美洲及欧洲选择国家
  • 宽度限制结果将不包含车辆宽度超出道路所允许的最大宽度的道路。 可使用“车辆宽度(单位为米)”限制参数指定车辆宽度。可用性:在北美洲及欧洲选择国家
注:

除非将出行模式设置为自定义,否则会忽略您为此参数提供的值。

String
属性参数值
(可选)

使用此参数可指定属性或限制条件所需的其他值,例如,指定限制对在受限道路上行驶是禁止、避免还是首选。 如果该限制要避免或首选道路,您可以使用此参数进一步指定要避免或首选的程度。 例如,您可以选择从不使用收费公路,尽可能的避开它们,或倾向于它们。

注:

除非将出行模式设置为自定义,否则会忽略您为此参数提供的值。

如果指定了要素类的属性参数值参数,则要素类上的字段名称必须与如下所示字段相匹配:

  • AttributeName- 限制的名称。
  • ParameterName- 与限制关联的参数名称。 限制根据其用途可具有一个或多个 ParameterName 字段值。
  • ParameterValue- 工具在评估限制时使用的 ParameterName 的值。

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

属性参数值中,每个限制(以 AttributeName 形式列出)具有一个 ParameterName 字段值,指定限制的行程是禁止、避免还是首选的限制用法与道路选择避免或首选的限制和程度相关联。 可为限制用法 ParameterName 分配下列字符串值,或在括号内列出等效数值:

  • PROHIBITED (-1) - 完全禁止在使用限制的道路上行驶。
  • AVOID_HIGH (5) - 极不可能将工具包括在与限制相关的道路中。
  • AVOID_MEDIUM (2) - 不太可能将工具包括在与限制相关的道路中。
  • AVOID_LOW (1.3) - 一定程度上不太可能将工具包括在与限制相关的道路中。
  • PREFER_LOW (0.8) - 一定程度上有可能将工具包括在与限制相关的道路中。
  • PREFER_MEDIUM (0.5) - 有可能将工具包括在与限制相关的道路中。
  • PREFER_HIGH (0.2) - 极有可能将工具包括在与限制相关的道路中。

大多数情况下,如果约束条件取决于车辆特征(如车辆高度),则可以使用默认值 PROHIBITED 作为“约束条件用法”值。 但是在某些情况下,“限制用法”的值取决于您的路径偏好。 例如,“避开收费公路”限制具有“限制用法”属性的默认值 AVOID_MEDIUM。 这表示在使用限制时,在可能的情况下工具将绕开收费公路。 AVOID_MEDIUM 也表示查找最佳路径时避开收费公路的重要性,即优先级为中等。 选择 AVOID_LOW 会降低避开收费公路的重要性;而选择 AVOID_HIGH 则会增加其重要性,因此服务为避开收费公路而生成更长的路径时更容易为人所接受。 选择 PROHIBITED 则会完全不允许在收费公路上行驶,因此路径不可能经过收费公路的所有部分。 但是请注意,避开或禁止收费公路以及避开公路通行费只是一部分人的目的。 对另外一部分人来说,因为避开拥堵的交通比交一些公路通行费更为重要,会宁愿走收费公路。 在后一种情况中,您可以选择 PREFER_LOW、PREFER_MEDIUM 或 PREFER_HIGH 作为“限制用法”的值。 首选的等级越高,工具在与限制相关的道路上行驶的距离越远。

Record Set
路径形状
(可选)

指定工具将输出的路径要素的类型。

路径形状参数设置为实际形状具有测量值的实际形状时,可以使用适当的路线简化容差参数值对路径形状的简化进行进一步控制。

无论为路径形状参数选择哪个值,最佳路径始终通过最大限度地缩短行驶时间或行驶距离来确定,从不使用停靠点间的直线距离进行确定。 这意味着只有路径形状是不同的,而非查找路径时搜索的基础街道。

  • 实际形状返回基于基础街道的生成路径的精确形状。
  • 具有测量值的实际形状返回基于基础街道的生成路径的精确形状。 此外,会对该形状进行测量以便其可用于线性参考中。 测量值从第一个停靠点开始增加,并以测量单位参数所指定的单位来记录累积行驶时间或累积行驶距离。
  • 直线返回两个停靠点之间的一条直线。
  • 将不返回路径形状。 此值在您只想确定路径的总行程时间或行程距离时十分有用,并可以快速返回结果。
String
路线简化容差
(可选)

用于简化路径和方向的输出线几何的距离。

如果路径形状参数未设置为实际形状,则工具将忽略此参数。

简化将保留路径上定义路径基本形状所需的关键点(例如交点处的转弯)而删除其他点。 指定的简化距离为简化线偏离原始线的最大允许偏移。 简化线将减少路径几何中的折点数。 这提高了工具处理时间。

Linear Unit
填充方向
(可选)

指定工具是否将为每条路径生成行驶方向。

  • 选中(在 Python 中为 True)- 将根据方向语言方向样式名称方向距离单位参数值生成和配置方向。
  • 未选中(在 Python 中为 False)- 将不会生成方向,且工具将返回一个空的 Directions 图层。

Boolean
方向语言
(可选)

在生成行驶方向时使用的语言。

此参数仅在选中填充方向参数(在 Python 中为 True)时使用。

可使用下列两位或五位字符语言代码指定参数值:

  • ar - 阿拉伯语
  • bg - 保加利亚语
  • bs - 波斯尼亚语
  • ca - 加泰罗尼亚语
  • cs - 捷克语
  • da - 丹麦语
  • de - 德语
  • el - 希腊语
  • en - 英语
  • es - 西班牙语
  • et - 爱沙尼亚语
  • fi - 芬兰语
  • fr - 法语
  • he - 希伯来语
  • hr - 克罗地亚语
  • hu - 匈牙利语
  • id - 印度尼西亚语
  • it - 意大利语
  • ja - 日语
  • ko - 朝鲜语
  • lt - 立陶宛语
  • lv - 拉脱维亚语
  • nb - 挪威语
  • nl - 荷兰语
  • pl - 波兰语
  • pt-BR - 葡萄牙语(巴西)
  • pt-PT - 葡萄牙语(葡萄牙)
  • ro - 罗马尼亚语
  • ru - 俄语
  • sk - 斯洛伐克语
  • sl - 斯洛文尼亚语
  • sr - 塞尔维亚语
  • sv - 瑞典语
  • th - 泰语
  • tr - 土耳其语
  • uk - 乌克兰语
  • vi - 越南语
  • zh-CN - 简体中文(中国)
  • zh-HK - 繁体中文(中国香港)
  • zh-TW - 繁体中文(中国台湾)

工具首先在全部本地化语言中搜索与指定值完全匹配的语言。 如果未找到完全匹配,则会尝试匹配语系。 如果仍未找到匹配,该工具将会使用默认语言(英语)返回方向。 例如,如果将方向指示语言指定为 es-MX(墨西哥西班牙语),则工具将返回西班牙语的指示,因为它支持 es 语言代码但不支持 es-MX。

警告:

如果某种语言支持本地化,例如巴西葡萄牙语 (pt-BR) 和欧洲葡萄牙语 (pt-PT),则指定语系和地区。 如果您只指定语系,则工具将无法与具体语系匹配,而使用默认语言(英语)返回方向。 例如,如果方向语言指定为 pt,则工具将返回英文指示,因为它无法确定应该使用 pt-BR 还是 pt-PT 返回方向。

String
方向距离单位
(可选)

指定在行驶方向中显示行驶距离的单位。 此参数仅在选中填充方向参数(在 Python 中为 True)时使用。

  • 英里线性单位将为英里。
  • 千米线性单位将为公里。
  • 线性单位将为米。
  • 英尺线性单位将为英尺。
  • 线性单位将为码。
  • 海里线性单位将为海里。
String
方向样式名称
(可选)

指定方向的格式化样式名称。 此参数仅在选中填充方向参数(在 Python 中为 True)时使用。

  • Network Analyst Desktop此样式适合打印的转弯说明。
  • Network Analyst 导航此样式针对车载导航设备的转弯说明。
String
时间的时区
(可选)

指定时间参数的时区。

无论时间的时区如何设置,如果您的设施点和事件点在多个时区中,则工具将强制执行以下规则: 在以下情况中,所有事件点和设施点必须在同一时区内:

  • 指定起始时间并从事件点行驶至设施点
  • 指定结束时间并从设施点行驶至事件点
  • 指定起始时间并从设施点行驶至事件点
  • 指定结束时间并从事件点行驶至设施点

  • 本地地理位置时间参数采用设施点或事件点所处的时区。如果将时间用法设置为起始时间行驶方向设置为设施点到事件点,则该时间为设施点所在时区。如果将时间用法设置为起始时间行驶方向设置为事件点到设施点,则为事件点所在时区。如果将时间用法设置为结束时间行驶方向设置为设施点到事件点,则为事件点所在时区。如果将时间用法设置为结束时间行驶方向设置为事件点到设施点,则为设施点所在时区。
  • UTC时间参数是指协调世界时间 (UTC)。 如果您想要在指定时间内(如现在)找到最近位置,但不确定设施点或事件点所在的时区,请选择此选项。
String
出行模式
(可选)

用于在分析中建模的交通模式。 出行模式在 ArcGIS Online 中进行管理,组织管理员可通过对其进行配置,以反映组织工作流。 指定组织所支持的出行模式名称。

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

默认值,自定义,可以使用自定义出行模式参数(在交汇点处 U 形转弯应用等级限制属性参数值阻抗)配置您自己的出行模式。 自定义出行模式参数的默认值对使用汽车的出行方式建模。 您还可以选择自定义并设置上述自定义出行模式参数,从而以快速步行速度对行人建模,或以给定高度、重量和特定危险材料货物对卡车建模。 您可以尝试不同的设置以获取所需的分析结果。 一旦确定了分析设置,则可使用组织管理员身份并将这些设置保存为新建或现有出行模式的一部分,以便您组织中的所有人均运行相同设置的分析。

警告:

选择自定义后,您为自定义出行模式参数设置的值便会包含在分析中。 指定您组织定义的其他出行模式,将忽略为自定义出行模式参数设置的所有值;该工具将用您所指定的出行模式中的值将其覆盖。

String
阻抗
(可选)

指定阻抗,该值表示沿交通网络的路段或其他部分行进所需的精力或成本。

行程时间是一种阻抗,比如,汽车花费 1 分钟沿空无一人的道路行驶一公里。 行程时间会随出行模式的不同而不同(行人可能需要 20 多分钟才能走完一公里),所以在建模时为出行模式选择正确的阻抗非常重要。

行程距离也是一种阻抗,可将以千米表示的道路长度作为阻抗。 从这个意义上,行程距离对所有模式均相同,即对行人而言 1 千米的距离对汽车而言也是 1 千米。 (但不同模式所允许行进的线路可能会有变化,而这会影响两点间的距离,可通过出行模式设置对此进行建模。)

如果选择基于时间的阻抗(例如 TravelTimeTruckTravelTimeMinutesTruckMinutesWalkTime),则必须将中断单位参数设置为基于时间的值;如果您选择基于距离的阻抗(例如 MilesKilometers),则中断单位必须为基于距离的值。

  • 行驶时间使用历史和实时流量数据。 此选项适用于在每天的特定时间使用实时流量速度数据(如果适用)对汽车沿道路行驶的时间进行建模。 如果使用 TravelTime,则可以选择设置 TravelTime::车辆最大速度 (km/h) 属性参数来指定车辆能够行驶的速度的物理限制。
  • 不使用实时流量数据,而是使用汽车的历史平均速度。
  • 卡车行驶时间使用历史和实时流量数据,但将速度限制为发布的卡车限速要求。 这有助于模拟卡车在特定时间沿着道路行驶所需的时间。 如果使用 TruckTravelTime,则可以选择设置 TruckTravelTime::车辆最大速度 (km/h) 属性参数来指定卡车能够行驶的速度的物理限制。
  • 卡车分钟不使用实时流量数据,而是使用汽车历史平均速度的较小值以及发布的卡车限速要求。
  • 步行时间在所有道路和路径上的默认速度为 5 千米/小时,但可以通过 WalkTime::步行速度 (km/h) 属性参数进行配置。
  • 英里以英里为单位存储沿道路的长度测量值,可用于基于最短距离执行分析。
  • 千米以公里为单位存储沿道路的长度测量值,可用于基于最短距离进行分析。
  • 每小时一公里的时间默认将所有道路和路径上的速度都设为 1 千米/小时。 使用任何属性参数都无法更改速度。
  • 行驶时间为小型汽车的行程时间建模。 这些行驶时间是动态的,会随交通数据可用区域的交通流量而波动。 这是默认值。
  • 卡车时间为卡车的行程时间建模。 这些行驶时间对于每条道路都是静态的,不会随交通流量而波动。
  • 步行时间为行人的出行时间建模。
  • 行驶距离存储沿道路和路径测得的距离长度。 要对步行距离建模,请选择此选项并确保在限制参数中设置了步行。 同样,若对行驶距离或货运距离建模,则在此处选择行程距离并设置相应限制,以使车辆仅在允许的道路上行进。
警告:

除非将出行模式设置为自定义(这是默认值),否则会忽略您为此参数提供的值。

旧版本:

不再支持行驶时间卡车时间步行时间行驶距离阻抗值,且将在未来版本中删除。 如果您使用上述任一值,则工具将为基于时间的值使用时间阻抗参数,为基于距离的值使用距离阻抗参数。

String
保存输出网络分析图层
(可选)

指定是否将分析设置保存为网络分析图层文件。 即使在 ArcGIS Desktop 应用程序(例如 ArcMap)中打开文件,仍然无法直接使用此文件。 需要将其发送至 Esri 技术支持以诊断工具所返回结果的质量。

  • 选中(在 Python 中为 True)- 输出将另存为网络分析图层文件。 文件将下载到计算机上的临时目录中。 在 ArcGIS Pro 中,可以通过查看输出网络分析图层参数的值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具服务相对应的条目中。 在 ArcMap 中,可以通过访问输出网络分析图层参数的快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具服务对应的条目中。
  • 未选中(在 Python 中为 False)- 输出不会另存为网络分析图层文件。 这是默认设置。

Boolean
覆盖
(可选)

注:

此参数仅供内部使用。

String
保存路径数据
(可选)

指定输出中是否包括含有某类文件地理数据库的 .zip 文件,该类文件地理数据库通过可与 ArcGIS OnlinePortal for ArcGIS 共享路径图层的格式保存分析的输入和输出。

  • 选中(在 Python 中为 True)- 路径数据将另存为为 .zip 文件。 文件将下载到计算机上的临时目录中。 在 ArcGIS Pro 中,可以通过查看输出路径数据参数值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具执行相对应的条目中。 在 ArcMap 中,可以通过访问输出路径数据参数快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具执行对应的条目中。
  • 未选中(在 Python 中为 False)- 路径数据将不会另存为 .zip 文件。 这是默认设置。

Boolean
时间阻抗
(可选)

基于时间的阻抗值表示沿交通网络的路段或其他部分行进所需的出行时间。

  • 时间阻抗为分钟。
  • 行驶时间时间阻抗为行驶时间。
  • 每小时一公里的时间时间阻抗为每小时一公里的时间。
  • 步行时间时间阻抗为步行时间。
  • 卡车分钟时间阻抗为卡车分钟。
  • 卡车行驶时间时间阻抗为卡车行驶时间。
注:
如果使用阻抗参数指定的出行模式阻抗是基于时间的,则时间阻抗阻抗参数的值必须相同。 否则,服务将返回错误。
String
距离阻抗
(可选)

基于距离的阻抗值表示沿交通网络的路段或其他部分行进所需的出行时间。

  • 英里距离阻抗为英里。
  • 千米距离阻抗为千米。
注:
如果使用阻抗参数指定的出行模式阻抗是基于距离的,则距离阻抗阻抗参数的值必须相同。 否则,服务将返回错误。
String
输出格式
(可选)

指定将返回输出要素的格式。

如果指定基于文件的输出格式(如 JSON 文件GeoJSON 文件),则不会向显示添加输出,因为应用程序(例如 ArcMapArcGIS Pro)无法绘制结果文件的内容。 相反,结果文件将下载到计算机上的临时目录中。 在 ArcGIS Pro 中,可以通过查看输出结果文件参数值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具执行相对应的条目中。 在 ArcMap 中,可以通过访问输出结果文件参数快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具执行对应的条目中。

  • 要素集输出要素将作为要素类和表返回。 这是默认设置。
  • JSON 文件输出要素将作为包含输出的 JSON 表示的压缩文件返回。 指定此选项时,输出将是包含由服务针对每个输出创建的一个或多个 JSON 文件(扩展名为 .zip)的单个文件(扩展名为 .json)。
  • GeoJSON 文件输出要素将作为包含输出的 GeoJSON 表示的压缩文件返回。 指定此选项时,输出将是包含由服务针对每个输出创建的一个或多个 GeoJSON 文件(扩展名为 .zip)的单个文件(扩展名为 .geojson)。
String
忽略无效的位置
(可选)

指定是否忽略无效的输入位置。

  • 选中 - 将忽略未定位的网络位置,并且将仅使用有效网络位置运行分析。 如果这些位置位于不可遍历的元素上或有其他错误,则分析仍会继续进行。 如果您已知网络位置并不完全正确,但是希望对有效的网络位置运行分析,则此选项将非常有用。 这是默认设置。
  • 未选中 - 不会忽略无效位置。 如果存在无效位置,请勿运行分析。 更正无效位置,然后重新运行分析。
Boolean
定位设置
(可选)

使用此参数指定影响输入定位方式的设置,例如在网络上定位输入时使用的最大搜索距离或用于定位的网络源。

了解有关定位输入的更多信息

定位器 JSON 对象具有以下属性:

  • tolerancetoleranceUnits - 允许您控制定位输入时的最大搜索距离。 如果在此距离内未发现有效的网络位置,则输入要素将被视为未定位。 小的搜索容差会降低定位到错误街道的可能性,但会增加找不到任何有效网络位置的可能性。 toleranceUnits 参数值可指定为下列值之一:
    • esriCentimeters
    • esriDecimalDegrees
    • esriDecimeters
    • esriFeet
    • esriInches
    • esriIntFeet
    • esriIntInches
    • esriIntMiles
    • esriIntNauticalMiles
    • esriIntYards
    • esriKilometers
    • esriMeters
    • esriMiles
    • esriMillimeters
    • esriNauticalMiles
    • esriYards
  • sources - 允许您控制可用于定位的网络源。 例如,您可以将分析配置为在街道上而不是在人行道上定位输入。 可用于定位的源列表特定于此服务引用的网络数据集。 只有源数组中存在的源将用于定位。 源指定为对象数组,每个对象具有以下属性:
    • name - 可用于定位输入的网络源要素类的名称。
  • allowAutoRelocate - 允许您控制是否可以在求解时自动重定位具有现有网络位置字段的输入,以确保分析的位置字段有效并且可以用于路径选择。 如果值为 true,则位于限制网络元素上的点和受障碍影响的点将重定位至最近的可路由位置。 如果值为 false,则网络位置字段将按原样使用(即使点无法访问),并且这可能会导致求解失败。 即使值为 false,没有位置字段或位置字段不完整的输入也会在求解运算期间定位。
注:
目前,无法为 sources 数组指定不同的源名称。 此外,由于服务不支持位置字段,因此 allowAutoRelocate 始终设置为 true

参数值指定为 JSON 对象。 您可通过 JSON 对象为分析中的所有输入要素指定定位器 JSON,或者可以为特定输入指定覆盖。 您可通过覆盖对每个分析输入使用不同的设置。 例如,您可以禁止将停靠点定位于高速公路匝道上,并允许将点障碍定位于高速公路匝道上。 指定 Locate_Settings JSON 时,必须提供tolerancetoleranceUnitsallowAutoRelocate 属性。 如果需要为特定输入类提供不同的定位器 JSON,则必须为该输入添加覆盖属性。 属性名称必须与输入参数名匹配。 特定输入的定位器 JSON 不需要包含所有属性;仅需要包含与默认定位器 JSON 属性不同的属性。

String

派生输出

标注说明数据类型
输出路径

将提供对生成的路径或设施点与事件点之间路径的访问权限。

Feature Set
输出方向

将提供对每个生成路径转弯方向的访问权限。

Feature Set
求解成功

指示是否成功求解最近设施点分析。

Boolean
输出最近设施点

将提供对最近设施点分析中的输出设施点的访问权限。

Feature Set
输出网络分析图层

网络分析图层可用于在地图中进行进一步分析或调试,其属性可在工具参数中配置。

File
输出路径数据

包含特定路径的所有信息的 .zip 文件。

File
输出事件点

将提供对在最近设施点分析中用作起点或终点的位置的访问权限。

Feature Set
输出设施点

分析中使用的设施点。

Feature Set
输出结果文件

.zip 文件包含分析结果,每个输出对应一个或多个文件。 单个文件的格式由输出格式参数指定。

File
输出网络分析图层包

此图层包包含网络分析图层,该图层包含用于分析的数据和设置。

File
输出方向点

此参数用于访问分析中计算的路径的转弯方向,表示为沿发生特定方向事件或行进策略的路径上的点位置。

Feature Set
输出方向线

此参数用于访问在分析中计算的输出路径线,经过剖切以表示 DirectionPoints 事件或行进策略位置之间的每个路径段。

Feature Set
使用成本

此参数可返回分析使用的配额

注:

每个分析可以生成不同数量的付费对象,因此将使用不同数量的配额。 如果服务无法确定配额,则 usage_cost 参数会为 credits 返回值 -1

JSON

arcpy.agolservices.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}, {Ignore_Invalid_Locations}, {Locate_Settings})
名称说明数据类型
Incidents

在最近设施点分析中用作起点或终点的位置。

可指定一个或多个事件点(最多 5,000 个)。工具将在这些位置中搜索附近的位置。

指定事件点后,可使用以下特性为每个事件点设置属性,例如事件点的名称或服务时间。

Name

事件点的名称。该名称用于行驶方向中。如果未指定名称,则会在输出路径和方向中自动生成前缀为 Location 的唯一名称。

ID

事件点的唯一标识符。该标识符包含在输出路径中(作为 IncidentID 字段),且有助于将输出路径的附加信息(例如总行驶时间或总距离)连接到事件点的属性中,反之亦然。如果未指定 ID,则服务将为每个事件点自动生成一个唯一的标识符。

AdditionalTime

在事件点所花费的时间,该时间将被添加到路径总时间中。默认值为 0。

该属性值的单位由测量单位参数指定。仅在测量单位基于时间时,属性值才能包含在分析中。

例如,如果您要查找距火灾事件点最近的消防站以估算响应时间,AdditionalTime 属性可存储消防人员开始灭火前在事件点位置连接装备所花费的时间。

AdditionalDistance

在事件点所行驶的额外距离,该距离将被添加到路径总距离中。默认值为 0。

该属性值的单位由测量单位参数指定。仅在测量单位基于距离时,属性值才能包含在分析中。

通常,事件点的位置(例如住宅)并不是恰好位于街道上,而是位于道路的后方。该属性值可用于构建事件点位置与其在街道上的位置之间的距离,如有必要,将此段距离包括在总行驶距离中。

AdditionalCost

在事件点花费的额外成本,该成本将被添加到路径总距离中。默认值为 0。

当分析的出行模式使用不基于时间也不基于距离的阻抗属性时,应使用此属性值。属性值的单位将理解为未知单位。

TargetFacilityCount

需要为指定事件点查找的设施点的数量。此字段允许您为每个事件点指定要查找的不同数量的设施点。例如,使用此字段,您可以找到距一个事件点最近的三个设施点,以及距另一个事件点最近的两个设施点。

Cutoff

停止从指定事件点搜索设施点时所对应的阻抗值。此属性允许您为每个事件点指定不同的中断值。例如,使用此属性,您可以搜索距一个事件点五分钟行驶时间以内的设施点,并搜索距另一个事件点八分钟行驶时间以内的设施点。

CurbApproach

指定车辆到达和离开事件点的方向。该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0 (Either side of vehicle)—The vehicle can approach and depart the incident in either direction, so a U-turn is allowed at the incident. This setting can be chosen if it is possible and practical for a vehicle to turn around at the incident. This decision may depend on the width of the road and the amount of traffic or whether the incident has a parking lot where vehicles can pull in and turn around.
  • 1 (Right side of vehicle)—When the vehicle approaches and departs the incident, the curb must be on the right side of the vehicle. A U-turn is prohibited. This is typically used for vehicles such as buses that must arrive with the bus stop on the right-hand side.
  • 2 (Left side of vehicle)—When the vehicle approaches and departs the incident, the curb must be on the left side of the vehicle. A U-turn is prohibited. This is typically used for vehicles such as buses that must arrive with the bus stop on the left-hand side.
  • 3 (No U-Turn)—When the vehicle approaches the incident, the curb can be on either side of the vehicle; however, the vehicle must depart without turning around.

CurbApproach 属性是专为使用以下两种国家驾驶标准而设计的:右侧通行(美国)和左侧通行(英国)。首先,考虑位于车辆左侧的事件点。不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。不同国家的驾驶标准可能会要求您从这两种方向中的其中一个接近事件点,也就是说,只能从车辆的右侧或左侧接近事件点。例如,如果要到达一个事件点并且在车辆与事件点之间不存在其他交通车道,那么在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。

Bearing

点移动的方向。 单位为度,从正北开始沿顺时针方向进行测量。 该字段与 BearingTol 字段结合使用。

方位角数据通常会从配有 GPS 接收器的移动设备自动发送。 如果正在加载移动输入位置(例如行人或车辆),请尝试包括方位角数据。

使用该字段可以防止将位置添加到错误的边上,例如,车辆刚好在交叉路口或天桥附近时。 方位角也可帮助工具确定点在街道的哪一边上。

BearingTol

使用 Bearing 字段在边上定位移动点时,方位角容差值将创建一个可接受方位角值的范围。 如果 Bearing 字段值在可接受值范围(由边上的方位角容差生成)内,则可以将该点作为网络位置添加在此处,否则,将计算下一个最近边上的最近点。

单位为度,默认值为 30。 值必须大于 0 且小于 180。 值为 30 表示,Network Analyst 尝试在边上添加网络位置时,在边的每一侧(左侧和右侧)的两个数字化方向上都将生成一个 15 度的可接受方位角值。

NavLatency

如果 BearingBearingTol 也具有值,则该字段只在求解过程中使用;但是,即使当 BearingBearingTolNavLatency 字段中有值时,NavLatency 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要花费的成本。

NavLatency 的单位与阻抗属性的单位相同。

Feature Set
Facilities

在最近设施点分析中用作起点或终点的位置。

可指定一个或多个设施点(最多 5,000 个)。以下为查找最近位置时所搜索的位置。

指定设施点后,可使用以下特性为每个事件点设置属性,例如事件点的名称或服务时间。

Name

设施点的名称。该名称用于行驶方向中。如果未指定名称,则会在输出路径和方向中自动生成前缀为 Location 的唯一名称。

ID

设施点的唯一标识符。该标识符作为 FacilityID 字段包含在输出路径和输出最近设施点中。FacilityID 字段可用于将输出路径的附加信息(例如总行驶时间或总距离)连接到设施点的属性中。如果未指定 ID,则服务将为每个设施点自动生成一个唯一的标识符。

AdditionalTime

在设施点所花费的时间,该时间将被添加到路径总时间中。默认值为 0。

该属性值的单位由测量单位参数指定。仅在测量单位基于时间时,属性值才能包含在分析中。

例如,如果您要查找离火灾事件点最近的消防站,AdditionalTime 可存储消防人员穿好适当的防护装备和离开消防站所花费的时间。

AdditionalDistance

在设施点所行驶的额外距离,该距离将被添加到路径总距离中。默认值为 0。

该属性值的单位由测量单位参数指定。仅在测量单位基于距离时,属性值才能包含在分析中。

通常,设施点的位置(例如消防站)并不是恰好位于街道上,而是位于道路的后方。AdditionalDistance 可用于构建设施点位置与其在街道上的位置之间的距离,如有必要,将此段距离包括在总行驶距离中。

AdditionalCost

在设施点花费的额外成本,该成本将被添加到路径总距离中。默认值为 0。

当分析的出行模式使用不基于时间也不基于距离的阻抗属性时,应使用此属性值。属性值的单位将理解为未知单位。

Cutoff

停止从指定设施点搜索事件点时所对应的阻抗值。此属性允许您为每个设施点指定不同的中断值。例如,使用此属性,您可以搜索距一个设施点五分钟行驶时间以内的事件点,并搜索距另一个设施点八分钟行驶时间以内的事件点。

CurbApproach

指定车辆到达和离开设施点的方向。

  • 0(车辆的任意一侧)- 车辆可从任一方向到达和离开设施点,因此设施点处允许 U 形转弯。如果车辆有可能要在设施点处调头,则可以选择该设置。此决策可能取决于道路的宽度以及交通量,或者该设施点是否有停车场能让车辆驶入并调头。
  • 1(车辆的右侧)- 当车辆到达和离开设施点时,设施点必须在车辆右侧。禁止 U 形转弯。通常用于必须在右侧停靠的车辆(如公共汽车)。
  • 2(车辆的左侧)- 当车辆到达和离开设施点时,路边必须在车辆左侧。禁止 U 形转弯。通常用于必须在左侧停靠的车辆(如公共汽车)。
  • 3(禁止 U 形转弯)- 当车辆到达设施点时,路边可在车辆的任意一侧;但是,车辆在离开时不得调头。

CurbApproach 属性是专为使用以下两种国家驾驶标准而设计的:右侧通行(美国)和左侧通行(英国)。首先,考虑位于车辆左侧的设施点。不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。不同国家的驾驶标准可能会要求您从这两种方向中的其中一个接近设施点,也就是说,只能从车辆的右侧或左侧接近设施点。例如,如果要到达一个设施点并且在车辆与设施点之间不存在其他交通车道,那么在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。

Bearing

点移动的方向。 单位为度,从正北开始沿顺时针方向进行测量。 该字段与 BearingTol 字段结合使用。

方位角数据通常会从配有 GPS 接收器的移动设备自动发送。 如果正在加载移动输入位置(例如行人或车辆),请尝试包括方位角数据。

使用该字段可以防止将位置添加到错误的边上,例如,车辆刚好在交叉路口或天桥附近时。 方位角也可帮助工具确定点在街道的哪一边上。

BearingTol

使用 Bearing 字段在边上定位移动点时,方位角容差值将创建一个可接受方位角值的范围。 如果 Bearing 字段值在可接受值范围(由边上的方位角容差生成)内,则可以将该点作为网络位置添加在此处,否则,将计算下一个最近边上的最近点。

单位为度,默认值为 30。 值必须大于 0 且小于 180。 值为 30 表示,Network Analyst 尝试在边上添加网络位置时,在边的每一侧(左侧和右侧)的两个数字化方向上都将生成一个 15 度的可接受方位角值。

NavLatency

如果 BearingBearingTol 也具有值,则该字段只在求解过程中使用;但是,即使当 BearingBearingTolNavLatency 字段中有值时,NavLatency 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要花费的成本。

NavLatency 的单位与阻抗属性的单位相同。

Feature Set
Measurement_Units

指定用于测量和报告输出路径的总行驶时间或行驶距离的单位。该工具可通过测量行驶时间或沿街道行驶距离查找最近设施点。

为此参数指定的单位可以确定工具将测量行驶距离还是行驶时间来查找最近位置。选择时间单位以测量行驶时间。要测量行驶距离,则请选择距离单位。选择的单位还确定工具在结果中报告总行驶时间或距离时采用的单位。

  • Meters线性单位将为米。
  • Kilometers线性单位将为公里。
  • Feet线性单位将为英尺。
  • Yards线性单位将为码。
  • Miles线性单位将为英里。
  • NauticalMiles线性单位将为海里。
  • Seconds时间单位将为秒。
  • Minutes时间单位将为分钟。
  • Hours时间单位将为小时。
  • Days时间单位将为天。
String
Analysis_Region
(可选)

将在其中执行分析的区域。 如果未对此参数指定值,工具会基于输入点的位置自动计算区域名称。 仅当自动检测的区域名称输入不准确时,才需要设置区域名称。

要指定区域,请使用以下值之一:

  • Europe分析区域为欧洲。
  • Japan分析区域为日本。
  • Korea分析区域为韩国。
  • MiddleEastAndAfrica分析区域为中东和非洲。
  • NorthAmerica分析区域为北美洲。
  • SouthAmerica分析区域为南美洲。
  • SouthAsia分析区域为南亚。
  • Thailand分析区域为泰国。
旧版本:

不再支持以下区域名称,且将在未来版本中删除这些名称。 如果您指定了任一已弃用的区域名称,则工具会自动为您所在的区域分配支持的区域名称。

  • 希腊将重定向到欧洲
  • 印度将重定向到南亚
  • 大洋洲将重定向到南亚
  • 东南亚将重定向到南亚
  • 台湾将重定向到南亚

String
Number_of_Facilities_to_Find
(可选)

要按事件点查找的最近设施点数。在可能需要来自不同消防站的多辆消防车的情况(例如火灾)中,此项非常有用。例如,您可以指定查找距离起火地点最近的三个消防站。

在此参数中设置的值可以通过输入事件点中的 TargetFacilityCount 字段覆盖每个事件点。

该工具最多可为每个事件点查找 100 个设施点。

Long
Cutoff
(可选)

对于给定事件点,停止搜索设施点的行驶时间或行驶距离值。例如,在查找距离事故地点最近的医院时,如果中断值设为 15 分钟,则表示工具将搜索距离事件点 15 分钟车程以内的最近医院。如果到达最近的医院需要 17 分钟的车程,则在输出路径中不会返回任何路线。在搜索多个设施点时,中断值尤为有用。

行驶方向参数设置为设施点到事件点时,中断可以通过输入设施点中的 Cutoff 字段覆盖每个设施点。当行驶方向参数设置为事件点到设施点时,中断可以通过输入事件点中的 Cutoff 字段覆盖每个事件点。

该参数的单位由测量单位参数指定。

Double
Travel_Direction
(可选)

指定如何测量最近设施点搜索的行驶方向。

  • Facility to Incident从设施点到事件点的行驶方向。
  • Incident to Facility从事件点到设施点的行驶方向。

每个选项找到的设施点可能不同,因为沿某些街道的行驶时间可能会随行驶方向和单行线限制而发生变化。例如,从事件点行驶到设施点时,可能需要 10 分钟,而从设施点行驶到事件点时,由于该方向上的行驶时间不同,可能需要 15 分钟。

如果您还要设置时间参数的值,交通状况也可能导致设施点到事件点事件点到设施点选项返回不同的结果。

消防部门通常使用参数的设施点到事件点值,因为他们需要关注从消防站(设施点)行驶到紧急救援位置(事件点)所需的时间。零售商店(设施点)管理层则更关注顾客(事件点)到达商店(设施点)所需的时间;因此,商店管理层通常选择事件点到设施点

String
Use_Hierarchy
(可选)

指定是否将在查找设施点和事件点之间的最佳路径时使用等级。

  • 选中(在 Python 中为 True)- 查找路径时将使用等级。在应用等级时,相比低等级的街道(例如地方道路),该工具会优先标识等级较高的街道(例如高速公路),且该工具可以用于模拟驾驶员对在高速公路(而非地方道路)上行驶的偏好,即使这意味着行程更远。查找远距离设施点的路径时尤为有用,因为长途驾驶员往往更偏好于在高速公路上行驶,这样可以避免停靠、交叉路口和转弯。应用等级可实现更快的计算速度,尤其是对于长途路径来说,因为该工具需要在相对较小的街道子集中标识最佳路径。
  • 未选中(在 Python 中为 False)- 查找路径时不会使用等级。如果没有应用等级,该工具就会考虑所有的街道且在选择路线时并不一定标识等级较高的街道。这常用于在市内查找短途路径。

如果设施点和事件点间的直线距离大于 50 英里,即使未选中此参数(在 Python 中设置为 False),工具也会自动恢复为使用等级。

Boolean
Time_of_Day
(可选)

路线开始或结束的时间和日期。该值根据时间用法参数的值可用作路径的起始时间或结束时间。如果您指定当前日期和时间作为该参数的值,则工具将使用实时交通状况查找最近设施点,并且总行驶时间将基于交通状况提供。

指定时间可实现更加准确的事件点和设施点之间的行驶时间评估,因为行驶时间会考虑该日期和时间对应的交通状况。

时间的时区参数指定该时间和日期是参考 UTC 还是设施点或事件点所在时区。

Date
Time_of_Day_Usage
(可选)

指定时间参数值是表示路径的到达时间还是出发时间。

  • Start Time该工具会将时间参数值视为从设施点或事件点开始寻找最佳路径的出发时间。
  • End Time该工具会将时间参数值视为从设施点或事件点开始寻找最佳路径的到达时间。 如果想知道从地点出发的时间,从而能在时间指定的时间到达目的地,该选项将十分有用。
String
UTurn_at_Junctions
(可选)

指定交汇点的 U 形转弯策略。 允许 U 形转弯表示求解程序可以在交汇点处转向并沿同一街道往回行驶。 考虑到交汇点表示街道交叉路口和死角,不同的车辆可以在某些交汇点转弯,而在其他交汇点则不行 - 这取决于交汇点是交叉路口还是死角。 为适应此情况,U 形转弯策略参数由连接到交汇点的边数隐性指定,这称为交汇点价。 此参数可接受的值如下所列;每个值的后面是根据交汇点价对其含义的描述。

  • Allowed无论在交汇点处有几条连接的边,均允许 U 形转弯。 这是默认值。
  • Not Allowed在所有交汇点处均禁止 U 形转弯,不管交汇点原子价如何。 但是,即使已选择该选项,在网络位置仍允许 U 形转弯;但是也可以通过设置个别网络位置的 CurbApproach 属性来禁止 U 形转弯。
  • Allowed Only at Dead Ends除仅有一条相邻边的交汇点(死角)外,其他交汇点均禁止 U 形转弯。
  • Allowed Only at Intersections and Dead Ends在恰好有两条相邻边相遇的交汇点处禁止 U 形转弯,但是交叉点(三条或三条以上相邻边的交汇点)和死角(仅有一条相邻边的交汇点)处允许。 通常,网络在路段中间有多余的交汇点。 此选项可防止车辆在这些位置掉头。

除非将出行模式设置为自定义,否则会忽略此参数。

String
Point_Barriers
(可选)

使用此参数可指定一个或多个点作为临时限制,或表示在基础街道上行驶可能需要的附加时间或距离。 例如,点障碍可用来显示一棵沿街倒下的树或是铁路道口上的时间延迟。

工具限制了可添加为障碍的点不得超过 250 个。

指定点障碍后,可通过使用以下属性为每个事件点设置属性,例如其名称或障碍类型:

Name

障碍名称。

BarrierType

指定点障碍是完全限制通行还是增加通过障碍时的时间或距离。 此特性值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0(限制型)- 禁止穿过障碍。 此障碍称为限制型点障碍,因为它作为限制使用。

  • 2(增加成本型)- 穿过此障碍会增加通过 Additional_TimeAdditional_DistanceAdditionalCost 字段指定的行驶时间或行驶距离的数值。 此障碍类型称为增加成本型点障碍。

Additional_Time

穿越障碍时增加的行驶时间。 此字段仅适用于增加成本型障碍,且仅在测量单位参数值基于时间时适用。

此字段值必须大于或等于零,并且其单位必须与在测量单位参数中指定的单位相同。

Additional_Distance

穿越障碍时增加的距离。 此字段仅适用于增加成本型障碍,且仅在测量单位参数值基于距离时适用。

该字段值必须大于或等于零,并且其单位必须与在测量单位参数中指定的单位相同。

AdditionalCost

穿越障碍时增加的成本。 当测量单位参数值不基于时间或距离时,此字段仅适用于增加成本型障碍。

FullEdge

指定分析期间如何将限制点障碍应用于边元素。 该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0 (False) - 允许沿边行进到障碍,但不允许穿过障碍。 这是默认值。
  • 1 (True) - 禁止沿关联边的任何位置行进。

CurbApproach

指定受障碍影响的行驶方向。 该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0(车辆的任一侧)- 障碍将影响在边左右两个方向上行驶的车辆。
  • 1(车辆右侧)- 只会影响车辆的右行方向(障碍位于车辆左侧)。 在同一条边上行驶但从左侧接近障碍的车辆不会受到障碍的影响。
  • 2(车辆左侧)- 只会影响车辆的左行方向(障碍位于车辆左侧)。 在同一条边上行驶但从右侧接近障碍的车辆不会受到障碍的影响。

由于交汇点是点且不分左右侧,所以无论路边通道如何设置,交汇点上的障碍都会影响所有车辆。

CurbApproach 属性适用于以下两种国家驾驶标准:右侧通行(美国)和左侧通行(英国)。 首先,考虑位于车辆左侧的设施点。 不管车辆行驶在左车道还是右车道,停靠点始终位于车辆的左侧。 不同国家的驾驶标准可能会要求您从这两种方向中的其中一个接近设施点,也就是说,只能从车辆的右侧或左侧接近设施点。 例如,要到达一个设施点并且在车辆与设施点之间不存在其他交通车道,应在美国请选择 1(车辆的右侧),而在英国请选择 2(车辆的左侧)。

Bearing

点移动的方向。 单位为度,从正北开始沿顺时针方向进行测量。 该字段与 BearingTol 字段结合使用。

方位角数据通常会从配有 GPS 接收器的移动设备自动发送。 如果正在加载移动输入位置(例如行人或车辆),请尝试包括方位角数据。

使用该字段可以防止将位置添加到错误的边上,例如,车辆刚好在交叉路口或天桥附近时。 方位角也可帮助工具确定点在街道的哪一边上。

BearingTol

使用 Bearing 字段在边上定位移动点时,方位角容差值将创建一个可接受方位角值的范围。 如果 Bearing 字段值在可接受值范围(由边上的方位角容差生成)内,则可以将该点作为网络位置添加在此处,否则,将计算下一个最近边上的最近点。

单位为度,默认值为 30。 值必须大于 0 且小于 180。 值为 30 表示,Network Analyst 尝试在边上添加网络位置时,在边的每一侧(左侧和右侧)的两个数字化方向上都将生成一个 15 度的可接受方位角值。

NavLatency

如果 BearingBearingTol 也具有值,则该字段只在求解过程中使用;但是,即使当 BearingBearingTolNavLatency 字段中有值时,NavLatency 值的输入也是可选的。NavLatency 表示 GPS 信息从移动的车辆上发送到服务器以及车辆导航设备接收到处理后路径这两个时刻之间预期要花费的成本。

NavLatency 的单位与阻抗属性的单位相同。

Feature Set
Line_Barriers
(可选)

使用此参数可指定一条或多条线,用于禁止在线与街道相交的位置通行。 例如,线障碍可用于对阻塞若干个路段交通的游行或抗议队伍进行建模。 线障碍还可隔离多条道路以禁止进行遍历,从而在可能的路径中去除不符合要求的街道网络部分。

该工具限制了您可以使用线障碍参数限制的街道数量。 可指定为线障碍的线数没有限制时,所有线的相交街道的合并数不能超过 500

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

Name

障碍名称。

Feature Set
Polygon_Barriers
(可选)

使用此参数可指定面,用于完全限制通行或按比例调整行驶在面相交的街道上所需的行驶时间或距离。

该服务限制了您可以使用面障碍参数限制的街道数量。 可指定为面障碍的面数没有限制时,所有面的相交街道的合并数不能超过 2,000

指定面障碍时,可通过使用以下属性为每个面障碍设置属性,例如名称或障碍类型:

Name

障碍名称。

BarrierType

指定障碍是完全禁止通行还是按比例调整穿过成本(例如时间或距离)。 该字段值可指定为以下整数之一(请使用数值代码而非括号中的名称):

  • 0(限制型)- 禁止穿过障碍的任何部分。 此障碍称作限制型面障碍,因为它禁止在与障碍相交的街道上行驶。 此类障碍的一个具体应用是对覆盖街道中某些区域且导致街道无法通行的洪水进行建模。

  • 1(按比例调整成本型)- 根据使用 ScaledTimeFactorScaledDistanceFactor 字段指定的系数,按比例调整在基础街道上行驶所需的成本(例如行驶时间或距离)。 如果障碍部分覆盖了街道,则会按比例调整行驶时间或行驶距离。 例如,系数 0.25 表示在基础街道上行进的速度是正常速度的四倍。 系数 3.0 表示预期在基础街道上行进相同距离所花费的时间为正常值的三倍。 此障碍类型称为调整成本型面障碍。 例如,可使用该障碍对导致特定区域的行进速度减慢的暴风雨进行建模。

ScaledTimeFactor

它是与障碍相交街道的行驶时间要乘以的因子。 该字段值必须大于零。

此字段仅适用于按比例调整成本型障碍且仅在测量单位参数基于时间时适用。

ScaledDistanceFactor

它是与障碍相交街道的距离要乘以的因子。 该字段值必须大于零。

此字段仅适用于按比例调整成本型障碍且仅在测量单位参数基于距离时适用。

ScaledCostFactor

这是与障碍相交的街道的成本要乘以的系数。 该字段值必须大于零。

此字段仅适用于按比例调整成本型障碍且仅在测量单位参数既不基于时间也不基于距离时适用。

Feature Set
Restrictions
[Restrictions,...]
(可选)

在查找最佳路径时工具应使用的限制。

限制表示行驶偏好或要求。 大多数情况下,限制条件会导致道路禁行。 例如,使用“避开收费公路”限制的结果是,仅在访问某一事件点或设施点需要借道收费公路时,才会生成一条包含该收费公路的路径。 高度限制则使您可以绕开低于车辆高度的间隙。 如果车辆上装载着腐蚀性物质,使用“禁止任何危险物品”限制将防止在标记着运输腐蚀性材料为非法行为的路上运输这些材料。

注:

除非将出行模式设置为自定义,否则会忽略您为此参数提供的值。

注:

某些限制需要指定一个额外值以供它们使用。 该值必须与限制名称和用于限制的特定参数相关联。 可识别名称在属性参数值参数的 AttributeName 列中显示的限制。 在查找可遍历道路时,要正确使用限制,请指定属性参数值参数的 ParameterValue 字段。

注:

有些限制仅适用于某些国家/地区;下表按区域显示了这些限制的可用性。 关于在某区域内可用性有限的限制,通过在网络分析覆盖范围上查看“国家/地区列表”部分中的表,可以确定该限制在特定国家/地区是否可用。 如果一个国家/地区具有 Logistics Attribute 列的 Yes 值,则该国家/地区支持具有区域可选性的限制。 如果您指定的限制名称在事件点所在的国家/地区不可用,该服务会忽略无效限制。 该服务还会忽略约束条件用法属性参数值为 0 到 1(请参阅属性参数值参数)时的约束条件。 它会禁止约束条件用法参数值大于 0 时的所有约束条件。

该工具支持以下约束条件:

  • Any Hazmat Prohibited结果将不包含禁止运输任何危险类型材料的道路。可用性:在北美洲及欧洲选择国家
  • Avoid Carpool Roads结果将避开专供拼车(高承载)车辆行使的道路。可用性:所有国家
  • Avoid Express Lanes结果将避开指定为快速车道的道路。可用性:所有国家
  • Avoid Ferries结果将避开轮渡。可用性:所有国家
  • Avoid Gates结果将避开存在关键通道或守卫控制入口等关口的道路。可用性:所有国家
  • Avoid Limited Access Roads结果将避开限制进入高速公路的道路。可用性:所有国家
  • Avoid Private Roads结果将避开非公有和维护的道路。可用性:所有国家
  • Avoid Roads Unsuitable for Pedestrians结果将避开不适合行人的道路。可用性:所有国家
  • Avoid Stairways结果将避开行人适合路线上的所有楼梯。可用性:所有国家
  • Avoid Toll Roads结果将避开汽车收费公路。可用性:所有国家
  • Avoid Toll Roads for Trucks结果将避开卡车收费公路。可用性:所有国家
  • Avoid Truck Restricted Roads结果将避开禁止货车通行的道路,除非正在进行配送。可用性:所有国家
  • Avoid Unpaved Roads结果将避开未铺设(例如,泥土、砾石等)的道路。可用性:所有国家
  • Axle Count Restriction结果将不包含具有指定轴数的卡车禁行的道路。 可使用车轴数限制参数指定车轴数。可用性:在北美洲及欧洲选择国家
  • Driving a Bus结果将不包含公共汽车禁行的道路。 使用此约束条件还将确保结果支持单行道。可用性:所有国家
  • Driving a Taxi结果将不包含出租车禁行的道路。 使用此约束条件还将确保结果支持单行道。可用性:所有国家
  • Driving a Truck结果将不包含卡车禁行的道路。 使用此约束条件还将确保结果支持单行道。可用性:所有国家
  • Driving an Automobile结果将不包含汽车禁行的道路。 使用此约束条件还将确保结果支持单行道。可用性:所有国家
  • Driving an Emergency Vehicle结果将不包含急救车辆禁行的道路。 使用此约束条件还将确保结果支持单行道。可用性:所有国家
  • Height Restriction结果将不包含车辆高度超出道路所允许的最大高度的道路。 可使用“车辆高度(米)”限制参数指定车辆高度。可用性:在北美洲及欧洲选择国家
  • Kingpin to Rear Axle Length Restriction结果将不包含车辆长度超出路上所有货车所允许的主销到后轴最大长度的道路。 可使用“车辆主销到后轴长度(米)”限制参数指定车辆中心立轴与后轴之间的长度。可用性:在北美洲及欧洲选择国家
  • Length Restriction结果将不包含车辆长度超出道路所允许的最大长度的道路。 可使用“车辆长度(单位为米)”限制参数指定车辆长度。可用性:在北美洲及欧洲选择国家
  • Preferred for Pedestrians结果将使用适合行人导航的首选路线。可用性:在北美洲及欧洲选择国家
  • Riding a Motorcycle结果将不包含摩托车禁行的道路。 使用此约束条件还将确保结果支持单行道。可用性:所有国家
  • Roads Under Construction Prohibited结果将不包含在建道路。可用性:所有国家
  • Semi or Tractor with One or More Trailers Prohibited结果将不包含带有一个或多个拖车的半挂车或牵引车禁行的道路。可用性:在北美洲及欧洲选择国家
  • Single Axle Vehicles Prohibited结果将不包含单轴车辆禁行的道路。可用性:在北美洲及欧洲选择国家
  • Tandem Axle Vehicles Prohibited结果将不包含双轴车辆禁行的道路。可用性:在北美洲及欧洲选择国家
  • Through Traffic Prohibited结果将不包含禁止过境交通(非本地)的道路。可用性:所有国家
  • Truck with Trailers Restriction结果将不包含具有指定拖车数量的货车禁行的道路。 可使用“卡车上的拖车数量”限制参数指定卡车的拖车数量。可用性:在北美洲及欧洲选择国家
  • Use Preferred Hazmat Routes结果将优先选择专用于运输危险类型材料的道路。可用性:在北美洲及欧洲选择国家
  • Use Preferred Truck Routes结果将优先选择指定为卡车路径的道路,例如,由美国的《国家地面交通援助法案》指定为国家网络的一部分的道路,由州或省指定为卡车路径的道路,或在某区域内驾驶卡车的首选道路。可用性:在北美洲及欧洲选择国家
  • Walking结果将不包含行人禁行的道路。可用性:所有国家
  • Weight Restriction结果将不包含车辆重量超出道路所允许的最大重量的道路。 可使用“车辆重量(千克)”限制参数指定车辆重量。可用性:在北美洲及欧洲选择国家
  • Weight per Axle Restriction结果将不包含车辆轴负重超出道路所允许的最大轴负重的道路。 可使用“车辆轴负重(千克)”限制参数指定车辆轴负量。可用性:在北美洲及欧洲选择国家
  • Width Restriction结果将不包含车辆宽度超出道路所允许的最大宽度的道路。 可使用“车辆宽度(单位为米)”限制参数指定车辆宽度。可用性:在北美洲及欧洲选择国家
String
Attribute_Parameter_Values
(可选)

使用此参数可指定属性或限制条件所需的其他值,例如,指定限制对在受限道路上行驶是禁止、避免还是首选。 如果该限制要避免或首选道路,您可以使用此参数进一步指定要避免或首选的程度。 例如,您可以选择从不使用收费公路,尽可能的避开它们,或倾向于它们。

注:

除非将出行模式设置为自定义,否则会忽略您为此参数提供的值。

如果指定了要素类的属性参数值参数,则要素类上的字段名称必须与如下所示字段相匹配:

  • AttributeName- 限制的名称。
  • ParameterName- 与限制关联的参数名称。 限制根据其用途可具有一个或多个 ParameterName 字段值。
  • ParameterValue- 工具在评估限制时使用的 ParameterName 的值。

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

属性参数值中,每个限制(以 AttributeName 形式列出)具有一个 ParameterName 字段值,指定限制的行程是禁止、避免还是首选的限制用法与道路选择避免或首选的限制和程度相关联。 可为限制用法 ParameterName 分配下列字符串值,或在括号内列出等效数值:

  • PROHIBITED (-1) - 完全禁止在使用限制的道路上行驶。
  • AVOID_HIGH (5) - 极不可能将工具包括在与限制相关的道路中。
  • AVOID_MEDIUM (2) - 不太可能将工具包括在与限制相关的道路中。
  • AVOID_LOW (1.3) - 一定程度上不太可能将工具包括在与限制相关的道路中。
  • PREFER_LOW (0.8) - 一定程度上有可能将工具包括在与限制相关的道路中。
  • PREFER_MEDIUM (0.5) - 有可能将工具包括在与限制相关的道路中。
  • PREFER_HIGH (0.2) - 极有可能将工具包括在与限制相关的道路中。

大多数情况下,如果约束条件取决于车辆特征(如车辆高度),则可以使用默认值 PROHIBITED 作为“约束条件用法”值。 但是在某些情况下,“限制用法”的值取决于您的路径偏好。 例如,“避开收费公路”限制具有“限制用法”属性的默认值 AVOID_MEDIUM。 这表示在使用限制时,在可能的情况下工具将绕开收费公路。 AVOID_MEDIUM 也表示查找最佳路径时避开收费公路的重要性,即优先级为中等。 选择 AVOID_LOW 会降低避开收费公路的重要性;而选择 AVOID_HIGH 则会增加其重要性,因此服务为避开收费公路而生成更长的路径时更容易为人所接受。 选择 PROHIBITED 则会完全不允许在收费公路上行驶,因此路径不可能经过收费公路的所有部分。 但是请注意,避开或禁止收费公路以及避开公路通行费只是一部分人的目的。 对另外一部分人来说,因为避开拥堵的交通比交一些公路通行费更为重要,会宁愿走收费公路。 在后一种情况中,您可以选择 PREFER_LOW、PREFER_MEDIUM 或 PREFER_HIGH 作为“限制用法”的值。 首选的等级越高,工具在与限制相关的道路上行驶的距离越远。

Record Set
Route_Shape
(可选)

指定工具将输出的路径要素的类型。

  • True Shape返回基于基础街道的生成路径的精确形状。
  • True Shape with Measures返回基于基础街道的生成路径的精确形状。 此外,会对该形状进行测量以便其可用于线性参考中。 测量值从第一个停靠点开始增加,并以测量单位参数所指定的单位来记录累积行驶时间或累积行驶距离。
  • Straight Line返回两个停靠点之间的一条直线。
  • None将不返回路径形状。 此值在您只想确定路径的总行程时间或行程距离时十分有用,并可以快速返回结果。

路径形状参数设置为实际形状具有测量值的实际形状时,可以使用适当的路线简化容差参数值对路径形状的简化进行进一步控制。

无论为路径形状参数选择哪个值,最佳路径始终通过最大限度地缩短行驶时间或行驶距离来确定,从不使用停靠点间的直线距离进行确定。 这意味着只有路径形状是不同的,而非查找路径时搜索的基础街道。

String
Route_Line_Simplification_Tolerance
(可选)

用于简化路径和方向的输出线几何的距离。

如果路径形状参数未设置为实际形状,则工具将忽略此参数。

简化将保留路径上定义路径基本形状所需的关键点(例如交点处的转弯)而删除其他点。 指定的简化距离为简化线偏离原始线的最大允许偏移。 简化线将减少路径几何中的折点数。 这提高了工具处理时间。

Linear Unit
Populate_Directions
(可选)

指定工具是否将为每条路径生成行驶方向。

  • 选中(在 Python 中为 True)- 将根据方向语言方向样式名称方向距离单位参数值生成和配置方向。
  • 未选中(在 Python 中为 False)- 将不会生成方向,且工具将返回一个空的 Directions 图层。

Boolean
Directions_Language
(可选)

在生成行驶方向时使用的语言。

此参数仅在选中填充方向参数(在 Python 中为 True)时使用。

可使用下列两位或五位字符语言代码指定参数值:

  • ar - 阿拉伯语
  • bg - 保加利亚语
  • bs - 波斯尼亚语
  • ca - 加泰罗尼亚语
  • cs - 捷克语
  • da - 丹麦语
  • de - 德语
  • el - 希腊语
  • en - 英语
  • es - 西班牙语
  • et - 爱沙尼亚语
  • fi - 芬兰语
  • fr - 法语
  • he - 希伯来语
  • hr - 克罗地亚语
  • hu - 匈牙利语
  • id - 印度尼西亚语
  • it - 意大利语
  • ja - 日语
  • ko - 朝鲜语
  • lt - 立陶宛语
  • lv - 拉脱维亚语
  • nb - 挪威语
  • nl - 荷兰语
  • pl - 波兰语
  • pt-BR - 葡萄牙语(巴西)
  • pt-PT - 葡萄牙语(葡萄牙)
  • ro - 罗马尼亚语
  • ru - 俄语
  • sk - 斯洛伐克语
  • sl - 斯洛文尼亚语
  • sr - 塞尔维亚语
  • sv - 瑞典语
  • th - 泰语
  • tr - 土耳其语
  • uk - 乌克兰语
  • vi - 越南语
  • zh-CN - 简体中文(中国)
  • zh-HK - 繁体中文(中国香港)
  • zh-TW - 繁体中文(中国台湾)

工具首先在全部本地化语言中搜索与指定值完全匹配的语言。 如果未找到完全匹配,则会尝试匹配语系。 如果仍未找到匹配,该工具将会使用默认语言(英语)返回方向。 例如,如果将方向指示语言指定为 es-MX(墨西哥西班牙语),则工具将返回西班牙语的指示,因为它支持 es 语言代码但不支持 es-MX。

警告:

如果某种语言支持本地化,例如巴西葡萄牙语 (pt-BR) 和欧洲葡萄牙语 (pt-PT),则指定语系和地区。 如果您只指定语系,则工具将无法与具体语系匹配,而使用默认语言(英语)返回方向。 例如,如果方向语言指定为 pt,则工具将返回英文指示,因为它无法确定应该使用 pt-BR 还是 pt-PT 返回方向。

String
Directions_Distance_Units
(可选)

指定在行驶方向中显示行驶距离的单位。 此参数仅在选中填充方向参数(在 Python 中为 True)时使用。

  • Miles线性单位将为英里。
  • Kilometers线性单位将为公里。
  • Meters线性单位将为米。
  • Feet线性单位将为英尺。
  • Yards线性单位将为码。
  • NauticalMiles线性单位将为海里。
String
Directions_Style_Name
(可选)

指定方向的格式化样式名称。 此参数仅在选中填充方向参数(在 Python 中为 True)时使用。

  • NA Desktop此样式适合打印的转弯说明。
  • NA Navigation此样式针对车载导航设备的转弯说明。
String
Time_Zone_for_Time_of_Day
(可选)

指定时间参数的时区。

  • Geographically Local时间参数采用设施点或事件点所处的时区。如果将时间用法设置为起始时间行驶方向设置为设施点到事件点,则该时间为设施点所在时区。如果将时间用法设置为起始时间行驶方向设置为事件点到设施点,则为事件点所在时区。如果将时间用法设置为结束时间行驶方向设置为设施点到事件点,则为事件点所在时区。如果将时间用法设置为结束时间行驶方向设置为事件点到设施点,则为设施点所在时区。
  • UTC时间参数是指协调世界时间 (UTC)。 如果您想要在指定时间内(如现在)找到最近位置,但不确定设施点或事件点所在的时区,请选择此选项。

无论时间的时区如何设置,如果您的设施点和事件点在多个时区中,则工具将强制执行以下规则: 在以下情况中,所有事件点和设施点必须在同一时区内:

  • 指定起始时间并从事件点行驶至设施点
  • 指定结束时间并从设施点行驶至事件点
  • 指定起始时间并从设施点行驶至事件点
  • 指定结束时间并从事件点行驶至设施点

String
Travel_Mode
(可选)

用于在分析中建模的交通模式。 出行模式在 ArcGIS Online 中进行管理,组织管理员可通过对其进行配置,以反映组织工作流。 指定组织所支持的出行模式名称。

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

默认值,自定义,可以使用自定义出行模式参数(在交汇点处 U 形转弯应用等级限制属性参数值阻抗)配置您自己的出行模式。 自定义出行模式参数的默认值对使用汽车的出行方式建模。 您还可以选择自定义并设置上述自定义出行模式参数,从而以快速步行速度对行人建模,或以给定高度、重量和特定危险材料货物对卡车建模。 您可以尝试不同的设置以获取所需的分析结果。 一旦确定了分析设置,则可使用组织管理员身份并将这些设置保存为新建或现有出行模式的一部分,以便您组织中的所有人均运行相同设置的分析。

警告:

选择自定义后,您为自定义出行模式参数设置的值便会包含在分析中。 指定您组织定义的其他出行模式,将忽略为自定义出行模式参数设置的所有值;该工具将用您所指定的出行模式中的值将其覆盖。

String
Impedance
(可选)

指定阻抗,该值表示沿交通网络的路段或其他部分行进所需的精力或成本。

行程时间是一种阻抗,比如,汽车花费 1 分钟沿空无一人的道路行驶一公里。 行程时间会随出行模式的不同而不同(行人可能需要 20 多分钟才能走完一公里),所以在建模时为出行模式选择正确的阻抗非常重要。

行程距离也是一种阻抗,可将以千米表示的道路长度作为阻抗。 从这个意义上,行程距离对所有模式均相同,即对行人而言 1 千米的距离对汽车而言也是 1 千米。 (但不同模式所允许行进的线路可能会有变化,而这会影响两点间的距离,可通过出行模式设置对此进行建模。)

警告:

除非将出行模式设置为自定义(这是默认值),否则会忽略您为此参数提供的值。

  • TravelTime使用历史和实时流量数据。 此选项适用于在每天的特定时间使用实时流量速度数据(如果适用)对汽车沿道路行驶的时间进行建模。 如果使用 TravelTime,则可以选择设置 TravelTime::车辆最大速度 (km/h) 属性参数来指定车辆能够行驶的速度的物理限制。
  • Minutes不使用实时流量数据,而是使用汽车的历史平均速度。
  • TruckTravelTime使用历史和实时流量数据,但将速度限制为发布的卡车限速要求。 这有助于模拟卡车在特定时间沿着道路行驶所需的时间。 如果使用 TruckTravelTime,则可以选择设置 TruckTravelTime::车辆最大速度 (km/h) 属性参数来指定卡车能够行驶的速度的物理限制。
  • TruckMinutes不使用实时流量数据,而是使用汽车历史平均速度的较小值以及发布的卡车限速要求。
  • WalkTime在所有道路和路径上的默认速度为 5 千米/小时,但可以通过 WalkTime::步行速度 (km/h) 属性参数进行配置。
  • Miles以英里为单位存储沿道路的长度测量值,可用于基于最短距离执行分析。
  • Kilometers以公里为单位存储沿道路的长度测量值,可用于基于最短距离进行分析。
  • TimeAt1KPH默认将所有道路和路径上的速度都设为 1 千米/小时。 使用任何属性参数都无法更改速度。
  • Drive Time为小型汽车的行程时间建模。 这些行驶时间是动态的,会随交通数据可用区域的交通流量而波动。 这是默认值。
  • Truck Time为卡车的行程时间建模。 这些行驶时间对于每条道路都是静态的,不会随交通流量而波动。
  • Walk Time为行人的出行时间建模。
  • Travel Distance存储沿道路和路径测得的距离长度。 要对步行距离建模,请选择此选项并确保在限制参数中设置了步行。 同样,若对行驶距离或货运距离建模,则在此处选择行程距离并设置相应限制,以使车辆仅在允许的道路上行进。

如果选择基于时间的阻抗(例如 TravelTimeTruckTravelTimeMinutesTruckMinutesWalkTime),则必须将中断单位参数设置为基于时间的值;如果您选择基于距离的阻抗(例如 MilesKilometers),则中断单位必须为基于距离的值。

旧版本:

不再支持行驶时间卡车时间步行时间行驶距离阻抗值,且将在未来版本中删除。 如果您使用上述任一值,则工具将为基于时间的值使用时间阻抗参数,为基于距离的值使用距离阻抗参数。

String
Save_Output_Network_Analysis_Layer
(可选)

指定是否将分析设置保存为网络分析图层文件。 即使在 ArcGIS Desktop 应用程序(例如 ArcMap)中打开文件,仍然无法直接使用此文件。 需要将其发送至 Esri 技术支持以诊断工具所返回结果的质量。

  • 选中(在 Python 中为 True)- 输出将另存为网络分析图层文件。 文件将下载到计算机上的临时目录中。 在 ArcGIS Pro 中,可以通过查看输出网络分析图层参数的值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具服务相对应的条目中。 在 ArcMap 中,可以通过访问输出网络分析图层参数的快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具服务对应的条目中。
  • 未选中(在 Python 中为 False)- 输出不会另存为网络分析图层文件。 这是默认设置。

Boolean
Overrides
(可选)

注:

此参数仅供内部使用。

String
Save_Route_Data
(可选)

指定输出中是否包括含有某类文件地理数据库的 .zip 文件,该类文件地理数据库通过可与 ArcGIS OnlinePortal for ArcGIS 共享路径图层的格式保存分析的输入和输出。

  • 选中(在 Python 中为 True)- 路径数据将另存为为 .zip 文件。 文件将下载到计算机上的临时目录中。 在 ArcGIS Pro 中,可以通过查看输出路径数据参数值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具执行相对应的条目中。 在 ArcMap 中,可以通过访问输出路径数据参数快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具执行对应的条目中。
  • 未选中(在 Python 中为 False)- 路径数据将不会另存为 .zip 文件。 这是默认设置。

Boolean
Time_Impedance
(可选)

基于时间的阻抗值表示沿交通网络的路段或其他部分行进所需的出行时间。

注:
如果使用阻抗参数指定的出行模式阻抗是基于时间的,则时间阻抗阻抗参数的值必须相同。 否则,服务将返回错误。
  • Minutes时间阻抗为分钟。
  • TravelTime时间阻抗为行驶时间。
  • TimeAt1KPH时间阻抗为每小时一公里的时间。
  • WalkTime时间阻抗为步行时间。
  • TruckMinutes时间阻抗为卡车分钟。
  • TruckTravelTime时间阻抗为卡车行驶时间。
String
Distance_Impedance
(可选)

基于距离的阻抗值表示沿交通网络的路段或其他部分行进所需的出行时间。

注:
如果使用阻抗参数指定的出行模式阻抗是基于距离的,则距离阻抗阻抗参数的值必须相同。 否则,服务将返回错误。
  • Miles距离阻抗为英里。
  • Kilometers距离阻抗为千米。
String
Output_Format
(可选)

指定将返回输出要素的格式。

  • Feature Set输出要素将作为要素类和表返回。 这是默认设置。
  • JSON File输出要素将作为包含输出的 JSON 表示的压缩文件返回。 指定此选项时,输出将是包含由服务针对每个输出创建的一个或多个 JSON 文件(扩展名为 .zip)的单个文件(扩展名为 .json)。
  • GeoJSON File输出要素将作为包含输出的 GeoJSON 表示的压缩文件返回。 指定此选项时,输出将是包含由服务针对每个输出创建的一个或多个 GeoJSON 文件(扩展名为 .zip)的单个文件(扩展名为 .geojson)。

如果指定基于文件的输出格式(如 JSON 文件GeoJSON 文件),则不会向显示添加输出,因为应用程序(例如 ArcMapArcGIS Pro)无法绘制结果文件的内容。 相反,结果文件将下载到计算机上的临时目录中。 在 ArcGIS Pro 中,可以通过查看输出结果文件参数值来确定已下载文件的位置,该参数位于与工程地理处理历史中的工具执行相对应的条目中。 在 ArcMap 中,可以通过访问输出结果文件参数快捷菜单中的复制位置选项来确定文件的位置,该参数位于与地理处理结果窗口中的工具执行对应的条目中。

String
Ignore_Invalid_Locations
(可选)

指定是否忽略无效的输入位置。

  • SKIP将忽略未定位的网络位置,并且将仅使用有效网络位置运行分析。 如果这些位置位于不可遍历的元素上或有其他错误,则分析仍会继续进行。 如果您已知网络位置并不完全正确,但是希望对有效的网络位置运行分析,则此选项将非常有用。 这是默认设置。
  • HALT不会忽略无效位置。 如果存在无效位置,请勿运行分析。 更正无效位置,然后重新运行分析。
Boolean
Locate_Settings
(可选)

使用此参数指定影响输入定位方式的设置,例如在网络上定位输入时使用的最大搜索距离或用于定位的网络源。

了解有关定位输入的更多信息

定位器 JSON 对象具有以下属性:

  • tolerancetoleranceUnits - 允许您控制定位输入时的最大搜索距离。 如果在此距离内未发现有效的网络位置,则输入要素将被视为未定位。 小的搜索容差会降低定位到错误街道的可能性,但会增加找不到任何有效网络位置的可能性。 toleranceUnits 参数值可指定为下列值之一:
    • esriCentimeters
    • esriDecimalDegrees
    • esriDecimeters
    • esriFeet
    • esriInches
    • esriIntFeet
    • esriIntInches
    • esriIntMiles
    • esriIntNauticalMiles
    • esriIntYards
    • esriKilometers
    • esriMeters
    • esriMiles
    • esriMillimeters
    • esriNauticalMiles
    • esriYards
  • sources - 允许您控制可用于定位的网络源。 例如,您可以将分析配置为在街道上而不是在人行道上定位输入。 可用于定位的源列表特定于此服务引用的网络数据集。 只有源数组中存在的源将用于定位。 源指定为对象数组,每个对象具有以下属性:
    • name - 可用于定位输入的网络源要素类的名称。
  • allowAutoRelocate - 允许您控制是否可以在求解时自动重定位具有现有网络位置字段的输入,以确保分析的位置字段有效并且可以用于路径选择。 如果值为 true,则位于限制网络元素上的点和受障碍影响的点将重定位至最近的可路由位置。 如果值为 false,则网络位置字段将按原样使用(即使点无法访问),并且这可能会导致求解失败。 即使值为 false,没有位置字段或位置字段不完整的输入也会在求解运算期间定位。
注:
目前,无法为 sources 数组指定不同的源名称。 此外,由于服务不支持位置字段,因此 allowAutoRelocate 始终设置为 true

参数值指定为 JSON 对象。 您可通过 JSON 对象为分析中的所有输入要素指定定位器 JSON,或者可以为特定输入指定覆盖。 您可通过覆盖对每个分析输入使用不同的设置。 例如,您可以禁止将停靠点定位于高速公路匝道上,并允许将点障碍定位于高速公路匝道上。 指定 Locate_Settings JSON 时,必须提供tolerancetoleranceUnitsallowAutoRelocate 属性。 如果需要为特定输入类提供不同的定位器 JSON,则必须为该输入添加覆盖属性。 属性名称必须与输入参数名匹配。 特定输入的定位器 JSON 不需要包含所有属性;仅需要包含与默认定位器 JSON 属性不同的属性。

String

派生输出

名称说明数据类型
Output_Routes

将提供对生成的路径或设施点与事件点之间路径的访问权限。

Feature Set
Output_Directions

将提供对每个生成路径转弯方向的访问权限。

Feature Set
Solve_Succeeded

指示是否成功求解最近设施点分析。

Boolean
Output_Closest_Facilities

将提供对最近设施点分析中的输出设施点的访问权限。

Feature Set
Output_Network_Analysis_Layer

网络分析图层可用于在地图中进行进一步分析或调试,其属性可在工具参数中配置。

File
Output_Route_Data

包含特定路径的所有信息的 .zip 文件。

File
Output_Incidents

将提供对在最近设施点分析中用作起点或终点的位置的访问权限。

Feature Set
Output_Facilities

分析中使用的设施点。

Feature Set
Output_Result_File

.zip 文件包含分析结果,每个输出对应一个或多个文件。 单个文件的格式由输出格式参数指定。

File
Output_Network_Analysis_Layer_Package

此图层包包含网络分析图层,该图层包含用于分析的数据和设置。

File
Output_Direction_Points

此参数用于访问分析中计算的路径的转弯方向,表示为沿发生特定方向事件或行进策略的路径上的点位置。

Feature Set
Output_Direction_Lines

此参数用于访问在分析中计算的输出路径线,经过剖切以表示 DirectionPoints 事件或行进策略位置之间的每个路径段。

Feature Set
Usage_Cost

此参数可返回分析使用的配额

注:

每个分析可以生成不同数量的付费对象,因此将使用不同数量的配额。 如果服务无法确定配额,则 usage_cost 参数会为 credits 返回值 -1

JSON

代码示例

FindClosestFacilities 示例(独立脚本)

以下 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/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.ClosestFacility.FindClosestFacilities(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)
FindClosestFacilities 示例 2(独立脚本)

以下示例将显示如何使用自定义出行模式来执行最近设施点分析。

"""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.ClosestFacility.FindClosestFacilities(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)

环境

此工具不使用任何地理处理环境。