添加位置 (Network Analyst 工具)
汇总
将输入要素或记录添加到网络分析图层。 向特定子图层(如“停靠点”图层和“障碍”图层)添加输入。 当网络分析图层引用网络数据集作为其网络数据源时,该工具会计算输入的网络位置,除非预先计算的网络位置字段是从输入映射的。
用法
该工具通常用作网络分析工作流的一部分。
在定位输入时,需考虑网络分析图层的出行模式和现有障碍。 因此,在加载其他分析输入之前,建议您先设置用于分析的出行模式并加载障碍。
将根据存储在输入网络分析图层中的位置属性自动填充搜索容差、搜索条件和搜索查询参数。 如果网络分析图层具有所选子图层的位置设置替代,则将使用这些设置。 否则,将使用网络分析图层的默认位置设置。
如您更改了搜索容差、搜索条件或搜索查询参数的值,则运行该工具将更新所选子图层的网络分析图层的位置设置替代。 将这些位置设置存储在网络分析图层中可确保在求解时完成的任何自动重定位都使用您在最初计算网络位置时已使用的相同位置设置。
如果您的分析图层引用门户服务,则不会计算位置字段,直到您求解分析为止。 对于这些图层,添加位置工具会将输入追加到分析图层,而无需计算位置字段。 因此,某些工具参数不适用于这些图层,并在地理处理窗格中被隐藏,且在 Python 中被忽略。
虽然该工具可以在 Python 脚本中使用,但在 Python 中执行网络分析的最佳实践是使用
arcpy.nax模块中的求解程序类。
参数
| 标注 | 说明 | 数据类型 |
|---|---|---|
|
输入网络分析图层 |
要添加网络分析对象的网络分析图层。 |
Network Analyst Layer |
|
子图层 |
要添加网络分析对象的网络分析图层的子图层名称。 |
String |
|
输入位置 |
包含要添加到网络分析子图层的位置的要素类或表。 |
Table View |
|
字段映射 (可选) |
您要添加位置的网络分析子图层的输入字段与输入数据或指定常量中的字段之间的映射。 网络分析图层的输入子图层具有一组输入字段,可以填充这些字段以修改或控制分析行为。 将位置添加到子图层时,可以使用此参数将输入表中的字段值映射到子图层中的这些字段。 您还可以使用字段映射为每个属性指定恒定默认值。 如果属性的字段和默认值都没有指定,则生成的网络分析对象的属性值为空。 每个图层的文档中提供了每种网络分析图层类型的每个子图层的输入字段的完整列表。 例如,检查 Route 图层 Stops 子图层的输入字段。 如果加载的数据包含基于用于分析的网络数据源和出行模式预先计算的网络位置或位置范围,请从下拉菜单中选择使用网络位置字段选项。 使用网络位置字段来添加网络分析对象比按照几何加载速度更快。 注:ArcGIS Online 和一些 ArcGIS Enterprise 门户不支持使用网络位置字段。 对于使用这些门户之一作为网络数据源的网络分析图层,所有输入都将在求解时定位,并且任何映射的位置字段都将被忽略。 |
Network Analyst Class FieldMap |
|
搜索容差 (可选) |
在网络上定位输入要素将使用的最大搜索距离。 搜索容差范围之外的要素将保持未定位状态。 该参数包含值和单位。 此参数的默认值取决于在输入网络分析图层中存储的位置属性。 如果网络分析图层具有所选子图层的位置设置替代,则将使用这些设置。 否则,将使用网络分析图层的默认位置设置。 如果为此参数设置非默认值,则将更新选定子图层的网络分析图层的位置设置覆盖。 当将位置添加至包含线或面几何的子图层(例如线障碍和面障碍)时,不会使用该参数。 当使用现有网络位置字段添加位置时,不会使用此参数。 旧版本:当网络分析图层的网络数据源为早于 11.0 版本的 ArcGIS Enterprise 门户时,不使用此参数。 |
Linear Unit |
|
排序字段 (可选) |
当网络分析对象被添加到网络分析图层时用于排序网络分析对象的字段。 默认设置为输入要素类或表中的 |
Field |
|
搜索条件 (可选) |
在网络上定位输入时将搜索的网络数据集中的边和交汇点源。 例如,如果网络数据集引用了表示街道和人行道的单独要素类,您可以将输入定位在街道上而不是人行道上。 注意:对于废弃物收集分析,如果任何停靠点位于交汇点,则求解操作将失败。 向垃废弃物收集分析图层添加停靠点时,请勿配置此参数以允许定位在交汇点源上。 此参数的默认值取决于在输入网络分析图层中存储的位置属性。 如果网络分析图层具有所选子图层的位置设置替代,则将使用这些设置。 否则,将使用网络分析图层的默认位置设置。 如果为此参数设置非默认值,则将更新选定子图层的网络分析图层的位置设置覆盖。 当使用现有网络位置字段添加位置时,不会使用此参数。 当网络分析图层的网络数据源为 ArcGIS Online 时,不使用此参数。 旧版本:当网络分析图层的网络数据源为早于 11.0 版本的 ArcGIS Enterprise 门户时,不使用此参数。 值表列:
|
Value Table |
|
在所有类中查找最近的 (可选) |
旧版本:此参数已弃用,并将仅针对向后兼容性进行维护。 输入将与用于定位的所有源中最近网络源进行匹配,对应
|
Boolean |
|
追加到现有位置 (可选) |
指定是否将新网络分析对象附加到现有对象。
|
Boolean |
|
捕捉到网络 (可选) |
指定将输入捕捉到其计算出的网络位置,还是由其原始地理位置表示它。 要在分析中使用路边通道来控制车辆在靠近位置时必须使用道路的哪一侧,请勿将输入捕捉到其网络位置,或使用捕捉偏移来确保该点始终清晰地保持在道路的一侧。 当将位置添加至包含线或面几何的子图层(例如线障碍和面障碍)时,不会使用该参数。 当输入网络分析图层的网络数据源是门户服务时,将不会使用此参数。
|
Boolean |
|
捕捉偏移 (可选) |
将点捕捉到网络时将应用的偏移距离。 偏移距离为零表示点将与网络要素(通常是线)重合。 要使点偏离网络要素,请输入偏移距离。 偏移与起始点的位置有关;即,如果起始点在左侧,它的新位置就会向左偏移。 如果起始点在右侧,它的新位置就会向右偏移。 默认设置为 5 米。 但是,如果未选中捕捉到网络,则会忽略此参数。 当将位置添加至包含线或面几何的子图层(例如线障碍和面障碍)时,不会使用该参数。 当输入网络分析图层的网络数据源是门户服务时,将不会使用此参数。 |
Linear Unit |
|
排除网络的受限部分 (可选) |
旧版本:此参数已弃用,并将仅针对向后兼容性进行维护。 永不在受限的网络元素上定位分析输入,对应于
|
Boolean |
|
搜索查询 (可选) |
此查询将搜索范围限制在源要素类的要素子集内。 这在不想查找可能不适合网络位置的要素时很有用。 例如,如果您不想定位在高速公路坡道上,则可定义一个查询将其排除。 可以为网络数据集的每个边或交汇点源要素类指定单独的 SQL 表达式。 不会向未在地理处理窗格中明确指定的任何网络源应用查询。 此参数的默认值取决于在输入网络分析图层中存储的位置属性。 如果网络分析图层具有所选子图层的位置设置替代,则将使用这些设置。 否则,将使用网络分析图层的默认位置设置。 如果为此参数设置非默认值,则将更新选定子图层的网络分析图层的位置设置覆盖。 当使用现有网络位置字段添加位置时,不会使用此参数。 当网络分析图层的网络数据源为 ArcGIS Online 时,不使用此参数。 旧版本:当网络分析图层的网络数据源为早于 11.0 版本的 ArcGIS Enterprise 门户时,不使用此参数。 值表列:
|
Value Table |
|
允许在求解时自动重新定位 (可选) |
指定是否可以在求解时自动重定位具有现有网络位置字段的输入,以确保分析的位置字段有效并且可路由。 此参数的默认值取决于在输入网络分析图层中存储的位置属性。 如果网络分析图层具有所选子图层的位置设置替代,则将使用这些设置。 否则,将使用网络分析图层的默认位置设置。 如果为此参数设置非默认值,则将更新选定子图层的网络分析图层的位置设置覆盖。 即使不允许在求解时自动重新定位,也将在求解时定位没有位置字段或位置字段不完整的输入。 当网络分析图层的网络数据源为 ArcGIS Online 时,不使用此参数。 当网络分析图层的网络数据源是不支持使用网络位置字段的 ArcGIS Enterprise 门户时,不使用此参数。 旧版本:当网络分析图层的网络数据源为早于 11.0 版本的 ArcGIS Enterprise 门户时,不使用此参数。
|
Boolean |
派生输出
| 标注 | 说明 | 数据类型 |
|---|---|---|
|
更新的输入网络分析图层 |
已更新的网络分析图层。 |
Network Analyst Layer |
环境
许可信息
- 基本: 是
- 标准: 是
- 高级: 是