“最佳路径为线”工具以线形式确定从目的地到源的最佳路径。
注：
要运行此工具，门户必须针对栅格分析进行配置。
目前，此功能仅在 Map Viewer 经典版（之前称为 Map Viewer）中受支持。 该功能将在新 Map Viewer 的未来版本中提供。 如果在 Map Viewer 经典版 中没有看到该工具，请联系您的组织管理员。 您的门户可能无法配置为用于路径选择，或者您不具备运行该工具所需的权限。
工作流示意图
示例
示例应用如下：
- 根据建设成本寻找新道路的最佳路线。
- 查找目的地和当前位置之间的最佳航行路线。
用法说明
“最佳路径为线”工具会生成输出线要素服务，该服务会记录一条从目的地到累积成本表面中定义的最接近源的一条或多条最佳路径。
在生成最佳路径之前，通常使用以下工具之一来创建距离累积栅格和反向栅格：距离累积或距离分配。 这些是生成最佳路径所需的输入。
创建的最佳路径可以是基于 D8 流向的流动路径。 要以此方式生成最佳路径，将 D8 流向栅格用作输入反向或流向栅格的输入。 还需要提供输入距离累积栅格；输入距离累积栅格不用于确定路径。 无论您使用常量栅格还是数字高程模型 (DEM)，您的路径都是相同的；只有路径上的属性值会有所不同。 流向栅格函数可用于生成 D8 流向栅格。
当输入目标数据是栅格时，目标像元集包括输入栅格中的所有像元或具有有效值的要素目标数据。 具有 NoData 值的像元不包括在源集内。 值零将被视为合法目标。
使用输入目标的要素数据时，必须注意输出像元大小的管理方式，特别是在输出像元相对于输入中的详细信息较为粗略时尤其如此。 系统将应用使用“要素转栅格”工具的内部栅格化过程。 这意味着，不在像元中心的数据将不会包含在中间栅格化目标输出中，也不会在距离计算中表示出来。 例如，如果您的目标是一系列相对于输出像元大小偏小的面，如建筑物覆盖区，则可能只有一部分面会落入输出栅格像元的中心，从而导致分析中会缺少其他许多面。
输出线要素具有一个名为 DestID 的字段和一个名为 PathCost 的字段。 DestID 字段用于标识每条线通向的目的地。 PathCost 字段显示每条路径的总累积成本。
要生成最佳路径，将忽略范围、像元大小和捕捉栅格环境设置，并且使用反向栅格的特征计算输出栅格。 如果对反向栅格重采样或重新捕捉或改变范围，则该栅格的模式将被严重更改。
下表列出了此工具的参数：
| 参数 | 说明 |
|---|---|
| 选择目标栅格或要素 | 用于识别像元的栅格或要素输入（将确定的最佳路径为该像元与最佳源之间的路径）。 如果输入是栅格，则它必须由具有有效目标值（零是有效值）的像元组成，并且必须为其余的像元指定 NoData。 输入栅格类型必须为整型。 |
| 目标字段 | 要用于获得目标位置的值的字段。 该字段必须为整型。 |
| 选择距离累积栅格 | 距离累积栅格将用于确定从目的地到源的最佳路径。 距离累积栅格通常使用距离累积或距离分配工具进行创建。 距离累积栅格中的每个像元表示表面上从每个像元到源像元集的最小累积成本距离。 |
| 选择反向或流向栅格 | 反向栅格包含以度为单位的计算方向。 该方向用于标识沿最佳路径返回最小累积成本源同时避开障碍的下一个像元。 反向栅格通常使用距离累积或距离分配工具进行创建。 在本例中，值的范围是 0 度到 360 度。 值 0 留供源像元使用。 正东（右侧）是 90 度，且值以顺时针方向增加（180 是南方、270 是西方、360 是北方）。 创建的最佳路径可以是基于 D8 流向的流动路径。 要以此方式生成最佳路径，请将 D8 流向栅格用作此参数的输入。 |
| 路径类型（可选） | 用于指定对输入目标数据中的值和区域在成本路径计算中的解释方式进行定义的关键字。
|
| 结果要素图层名称 | 将在我的内容中创建并添加到地图中的图层的名称。 默认名称基于工具名称以及输入图层名称。 如果该名称的图层已存在，则系统将提示您提供其他名称。 您可以使用将结果保存在下拉框指定我的内容中的文件夹名称，结果将保存到该文件夹中。 |
环境
分析环境设置是影响工具执行结果的附加参数。 您可以通过单击工具窗格顶部的齿轮图标 
来访问该工具的分析环境设置。
该工具支持以下分析环境：
- 输出坐标系 - 指定输出图层的坐标系。
类似的工具和栅格函数
“最佳路径为线”工具以线形式确定从目的地到源的最佳路径。 其他工具或许在解决类似问题时十分有用。
Map Viewer 经典版 分析工具和栅格函数
使用最佳路径为栅格工具或最佳路径为栅格函数计算最佳路径并创建影像服务输出。
ArcGIS Pro 分析工具和栅格函数
最佳路径为栅格和最佳路径为线地理处理工具在 Spatial Analyst 和 Raster Analysis 工具箱中受支持。
最佳路径为栅格和最佳路径为线地理处理工具在 Raster Analysis 工具箱中受支持。
最佳路径为栅格可作为栅格函数。
ArcGIS Enterprise 开发者资源
如果您正在使用 ArcGIS REST API，请使用 Optimal Path As Line 和 Optimal Path As Raster 任务。
如果您正在使用 ArcGIS API for Python，则请使用来自 arcgis.raster.analytics 模块的 optimal_path_as_line 
或使用来自 arcgis.raster.functions.gbl 模块的 optimal_path_as_raster 。