将计算从目的地到源的最佳路径。
在成本距离方面，此函数可生成用于记录最佳路径或从所选位置到距离累积表面内所定义的最近源像元之间的路径的输出栅格。
此为全局栅格函数。
备注
要运行“最佳路径为栅格”函数，通常需要提供距离累积函数的结果。 您可通过运行“距离累积”函数来创建距离累积栅格和反向栅格，这些栅格是“最佳路径为栅格”函数所需的输入栅格图层。
创建的最佳路径可以是基于 D8 流向的流动路径。 要以此方式生成最佳路径，将 D8 流向栅格用作反向栅格或流向栅格的输入。 还需要提供输入距离累积栅格；输入距离累积栅格不用于确定路径。 无论您使用常量栅格还是数字高程模型 (DEM)，您的路径都是相同的；只有路径上的属性值会有所不同。 有关 D8 流向栅格的详细信息，请参见流向函数。
输入目标数据必须为栅格图层。 目标像元集包括输入栅格中具有有效值的所有像元。 具有 NoData 值的像元不包括在集内。 值零将被视为合法目标。 使用提取工具可创建目标栅格。
如果您具有目标或源要素，则可以使用栅格化要素函数将其转换为栅格。 使用距离累积或反向栅格作为栅格化函数的栅格输入。 这将确保使用与进入“最佳路径为栅格”函数的其他栅格相同的像元大小、范围和空间参考对要素进行栅格化。
输出最佳路径上的值表示给定位置处的路径数。 在许多情况下，路径随沿相同的路线，留下一个源，然后发散到不同的目的地。 例如，值 1 表示在给定位置只有一条最佳路径，而值 5 表示在该位置存在 5 条经过研究区域中的该像元的最佳路径。
要创建穿过投影边的路径，必须在整个全球范围内（圆柱投影或地理输出坐标系中）创建相应栅格，这些栅格用作距离累积栅格和反向栅格参数的输入，同时使用距离方法参数的测地线选项。
参数
下表中描述了“最佳路径为栅格”函数参数：
| 参数 | 描述 |
|---|---|
目标栅格 （必填） | 用于识别位置的整型栅格数据集图层（将确定的最佳路径为这些位置与成本最低的源之间的路径）。 该输入栅格图层必须由具有有效值（零是有效值）的像元组成，并且必须为其余的像元指定 NoData。 |
目标字段 | 用于获得目标位置的值的字段。 |
距离累积栅格 （必填） | 距离累积栅格用于确定从目的地到源的最佳路径。 距离累积栅格通常使用距离累积函数进行创建。 距离累积栅格中的每个像元表示表面上从每个像元到源像元集的最小累积成本距离。 |
反向栅格或流向栅格 （必填） | 返回方向栅格包含以度为单位的计算方向。 该方向用于标识沿最佳路径返回最小累积成本源同时避开障碍的下一个像元。 值的范围是 0 度到 360 度，并为源像元保留 0 度。 正东（右侧）是 90 度，且值以顺时针方向增加（180 是南方、270 是西方、360 是北方）。 |
路径类型 | 用于指定对输入目标数据上的值和区域在成本路径计算中的解释方式进行定义的关键字。
|