创建最后一公里配送分析图层 (Network Analyst 工具)

汇总

创建最后一公里配送网络分析图层并设置其分析属性。最后一公里配送分析图层可用于在使用一支车队时对一组路径进行优化。该图层可通过本地网络数据集进行创建，也可通过在线托管服务或门户托管服务进行创建。

用法

该工具通常用作网络分析工作流的第一步。图层创建后，您可以使用添加位置工具将输入添加到图层，并使用求解工具求解分析。

了解有关网络分析图层工作流的详细信息
用于最后一公里配送分析的分析网络必须至少包含一个出行模式、一个成本属性（以时间单位计）、一个成本属性（以距离单位计），以及一个时区属性。
当使用 ArcGIS Online 或使用 ArcGIS Online 配置路径服务的 ArcGIS Enterprise 门户作为输入网络数据源时，解决分析将消耗配额并受到某些限制，例如允许的输入数量。

了解关于网络分析中配额消耗和分析限制的详细信息
默认情况下，将在当前工作空间地理处理环境（通常为工程地理数据库）中新建的、自动命名的要素数据集中创建新分析图层的数据。将在相同地理数据库的根级别创建基于表的数据，因为无法将表存储在要素数据集中。可以使用分析地理数据库和分析要素数据集名称参数来覆盖此行为。
虽然该工具可以在 Python 脚本中使用，但在 Python 中执行网络分析的最佳实践是使用 arcpy.nax 模块中的求解程序类。

了解有关在 Python 中执行网络分析的详细信息。

标注	说明	数据类型
网络数据源	将对其执行网络分析的网络数据集或服务。可以使用以下值来指定该参数：网络数据集的目录路径。网络数据集图层已使用标准路由服务配置了 ArcGIS Online 或 ArcGIS Enterprise 门户的 URL 要使用门户 URL，您必须使用具有路径选择权限的账户登录门户。了解有关使用路径服务的网络分析详细信息当使用 ArcGIS Online 或使用 ArcGIS Online 配置路径服务的 ArcGIS Enterprise 门户作为输入网络时，解决分析将消耗配额并受到某些限制，例如允许的输入数量。了解关于网络分析中配额消耗和分析限制的详细信息此网络必须至少包含一个出行模式、一个成本属性（以时间单位计）、一个成本属性（以距离单位计），以及一个时区属性。	Network Dataset Layer; String
图层名称（可选）	将创建的网络分析图层的名称。	String
出行模式（可选）	要在分析中使用的出行模式名称。出行模式为一组网络设置（例如行驶限制和 U 形转弯），用于确定行人、车辆、卡车或其他交通媒介在网络中的移动方式。出行模式在网络数据源中进行定义。 `arcpy.na.TravelMode` 对象和包含出行模式有效 JSON 表示的字符串也可用作此参数的输入。出行模式的阻抗属性必须具有时间单位。	String
时间单位（可选）	指定将用于分析图层的属性和分析图层的子图层和表（网络分析类）的时态字段所用的时间单位。该值不需要与时间成本属性的单位匹配。分—时间单位将为分钟。这是默认设置。秒—时间单位将为秒。小时—时间单位将为小时。天—时间单位将为天。	String
距离单位（可选）	指定将用于分析图层的属性和分析图层的子图层和表（网络分析类）的距离字段所用的距离单位。该值不需要与可选距离成本属性的单位匹配。注意：当网络数据源是服务时，英寸、厘米、毫米和分米选项不可用。英里—距离单位将为英里。这是默认设置。千米—距离单位将为千米。英尺—距离单位将为英尺。码—距离单位将为码。米—距离单位将为米。英寸—距离单位为英寸。厘米—距离单位为厘米。毫米—距离单位为毫米。分米—距离单位为分米。海里—距离单位将为海里。	String
最早路径开始日期（可选）	默认最早路径开始日期。此日期用于所有在 `Routes` 子图层中 `EarliestStartDate` 字段为 null 的路径。当未指定参数值时，`Routes` 子图层中的所有行都必须在 `EarliestStartDate` 字段中指定一个值。虽然可以为此参数同时指定日期和时间，但仅会使用日期。要设置最早路径开始时间，请使用最早路径开始时间参数。注意：虽然其他 Network Analyst 求解程序允许您使用特殊日期来模拟一周中的某一天或当前日期（而非特定静态日期），但最后一公里配送求解程序不支持此操作。必须选择具体日期。	Date
最早路径开始时间（可选）	默认最早路径开始时间。此时间用于所有在 `Routes` 子图层中 `EarliestStartTime` 字段为 null 的路径。当未指定参数值时，`Routes` 子图层中的所有行都必须在 `EarliestStartTime` 字段中指定一个值。虽然可以为此参数同时指定日期和时间，但仅会使用时间。要设置最早路径开始日期，请使用最早路径开始日期参数。	Date
最长路径总时间（可选）	每条路径允许的最大总时间。值可为任意正数。此值用于所有在 `Routes` 子图层中 `MaxTotalTime` 字段为 null 的路径。当未指定参数值时，`Routes` 子图层中的所有行都必须在 `MaxTotalTime` 字段中指定一个值。该值以时间单位参数指定的单位来解释。	Double
时间字段的时区（可选）	指定将用于工具支持的输入日期时间字段的时区。如果不知道停靠点或站点所在的时区，或者停靠点或站点处在多个时区内并且您想要所有的日期时间值同时启动，那么在 UTC 中指定日期时间值非常有用。各位置的本地时间—与停靠点或站点相关的日期时间值位于停靠点和站点所在的时区内。对于路径，日期时间值基于路径的起始站点所在的时区。如果路径没有起始站点，则路径上的所有停靠点和站点必须位于一个时区中。这是默认设置。 UTC—与停靠点、站点和路径相关的日期时间值采用协调世界时间 (UTC)，且不基于停靠点或站点所在的时区。	String
序列间距（可选）	求解分析时 Orders 子图层 `Sequence` 字段中填写的相邻停靠点间距的数值。该值作为各个路径上实际停靠点序列的乘数。例如，如果间距为 5，则路径上的第一个停靠点的 `Sequence` 字段值为 5，路径上第二个停靠点的 `Sequence` 字段值为 10，第三个为 15，以此类推。此参数有助于在最初路径计划创建后插入停靠点，因为新停靠点可以插入到序列间距中。值必须为正整数。默认值为 1。首次求解分析时，`Sequence` 字段值将使用指定的序列间距填充顺序值。在同一分析的后续求解中，将保留现有停靠点的 `Sequence` 字段值，新的停靠点会将未被其他停靠点使用的可用整数用于 `Sequence` 字段，插入到间距中。如果序列间距设置为 1，则每次求解时，序列值都会更新为连续的值。	Long
求解时忽略无效的停靠点位置（可选）	指定是否忽略无效的停靠点位置。选中—将忽略无效的停靠点位置，仅使用有效位置即可成功进行分析。未选中—不会忽略无效的停靠点位置，从而导致分析失败。这是默认设置。	Boolean
输出路径形状（可选）	指定将用于分析所输出的路径要素的形状类型。无论指定的输出形状类型为何，最佳路径始终由网络阻抗（而非欧氏距离）决定。这表示只是路径形状不同，而对网络进行的基础遍历则相同。沿网络—输出路径将具有基础网络源的精确形状。输出包含路径测量值以用于线性参考。测量值从第一个停靠点增加并将记录到达指定位置的累积阻抗。无线—将不会为输出路径生成任何形状。直线—输出路径形状为两个停靠点之间的一条直线。这是默认设置。	String
根据求解生成方向（可选）	指定运行分析时是否生成方向。对于不需要生成转向指示的分析，关闭方向生成可以减少求解分析的时间。选中—求解时会生成转向指示。未选中—求解时不会生成转向指示。这是默认设置。	Boolean
分析地理数据库（可选）	存储新网络分析图层的子图层的文件地理数据库工作空间。当未指定此参数时，将在当前工作空间地理处理环境（通常为工程地理数据库）中创建子图层的数据。了解有关网络分析图层的分析数据源的详细信息	Workspace
分析要素数据集名称（可选）	用于命名该工具将在分析地理数据库中创建的新要素数据集的名称，该数据集将用于存储网络分析图层的子图层数据。如未指定，要素数据集将以随机唯一名称创建。了解有关网络分析图层的分析数据源的详细信息	String

派生输出

标注	说明	数据类型
网络分析图层	新网络分析图层。	Network Analyst Layer

arcpy.na.MakeLastMileDeliveryAnalysisLayer(network_data_source, {layer_name}, {travel_mode}, {time_units}, {distance_units}, {earliest_route_start_date}, {earliest_route_start_time}, {max_route_total_time}, {time_zone_for_time_fields}, {sequence_gap}, {ignore_invalid_order_locations}, {line_shape}, {generate_directions_on_solve}, {analysis_geodatabase}, {analysis_feature_dataset_name})

名称	说明	数据类型
network_data_source	将对其执行网络分析的网络数据集或服务。可以使用以下值之一来指定该参数：网络数据集的目录路径网络数据集图层对象网络数据集图层的字符串名称已使用标准路由服务配置了 ArcGIS Online 或 ArcGIS Enterprise 门户的 URL 要使用门户 URL，您必须使用具有路径选择权限的账户登录门户。了解如何在 Python 中登录门户了解有关使用路径服务的网络分析详细信息当使用 ArcGIS Online 或使用 ArcGIS Online 配置路径服务的 ArcGIS Enterprise 门户作为输入网络时，解决分析将消耗配额并受到某些限制，例如允许的输入数量。了解关于网络分析中配额消耗和分析限制的详细信息此网络必须至少包含一个出行模式、一个成本属性（以时间单位计）、一个成本属性（以距离单位计），以及一个时区属性。	Network Dataset Layer; String
layer_name （可选）	将创建的网络分析图层的名称。	String
travel_mode （可选）	要在分析中使用的出行模式名称。出行模式为一组网络设置（例如行驶限制和 U 形转弯），用于确定行人、车辆、卡车或其他交通媒介在网络中的移动方式。出行模式在网络数据源中进行定义。 `arcpy.na.TravelMode` 对象和包含出行模式有效 JSON 表示的字符串也可用作此参数的输入。出行模式的阻抗属性必须具有时间单位。	String
time_units （可选）	指定将用于分析图层的属性和分析图层的子图层和表（网络分析类）的时态字段所用的时间单位。该值不需要与时间成本属性的单位匹配。 `Minutes`—时间单位将为分钟。这是默认设置。 `Seconds`—时间单位将为秒。 `Hours`—时间单位将为小时。 `Days`—时间单位将为天。	String
distance_units （可选）	指定将用于分析图层的属性和分析图层的子图层和表（网络分析类）的距离字段所用的距离单位。该值不需要与可选距离成本属性的单位匹配。注意：当网络数据源是服务时，`Inches`、`Centimeters`、`Millimeters` 和 `Decimeters` 选项不可用。 `Miles`—距离单位将为英里。这是默认设置。 `Kilometers`—距离单位将为千米。 `Feet`—距离单位将为英尺。 `Yards`—距离单位将为码。 `Meters`—距离单位将为米。 `Inches`—距离单位为英寸。 `Centimeters`—距离单位为厘米。 `Millimeters`—距离单位为毫米。 `Decimeters`—距离单位为分米。 `NauticalMiles`—距离单位将为海里。	String
earliest_route_start_date （可选）	默认最早路径开始日期。此日期用于所有在 `Routes` 子图层中 `EarliestStartDate` 字段为 null 的路径。当未指定参数值时，`Routes` 子图层中的所有行都必须在 `EarliestStartDate` 字段中指定一个值。请使用 `datetime.date` 对象指定此参数值。注意：虽然其他 Network Analyst 求解程序允许您使用特殊日期来模拟一周中的某一天或当前日期（而非特定静态日期），但最后一公里配送求解程序不支持此操作。必须选择具体日期。	Date
earliest_route_start_time （可选）	默认最早路径开始时间。此时间用于所有在 `Routes` 子图层中 `EarliestStartTime` 字段为 null 的路径。当未指定参数值时，`Routes` 子图层中的所有行都必须在 `EarliestStartTime` 字段中指定一个值。请使用 `datetime.time` 对象指定此参数值。	Date
max_route_total_time （可选）	每条路径允许的最大总时间。值可为任意正数。此值用于所有在 `Routes` 子图层中 `MaxTotalTime` 字段为 null 的路径。当未指定参数值时，`Routes` 子图层中的所有行都必须在 `MaxTotalTime` 字段中指定一个值。值以 `time_units` 参数中指定的单位进行解释。	Double
time_zone_for_time_fields （可选）	指定将用于工具支持的输入日期时间字段的时区。如果不知道停靠点或站点所在的时区，或者停靠点或站点处在多个时区内并且您想要所有的日期时间值同时启动，那么在 UTC 中指定日期时间值非常有用。 `LOCAL_TIME_AT_LOCATIONS`—与停靠点或站点相关的日期时间值位于停靠点和站点所在的时区内。对于路径，日期时间值基于路径的起始站点所在的时区。如果路径没有起始站点，则路径上的所有停靠点和站点必须位于一个时区中。这是默认设置。 `UTC`—与停靠点、站点和路径相关的日期时间值采用协调世界时间 (UTC)，且不基于停靠点或站点所在的时区。	String
sequence_gap （可选）	求解分析时 Orders 子图层 `Sequence` 字段中填写的相邻停靠点间距的数值。该值作为各个路径上实际停靠点序列的乘数。例如，如果间距为 5，则路径上的第一个停靠点的 `Sequence` 字段值为 5，路径上第二个停靠点的 `Sequence` 字段值为 10，第三个为 15，以此类推。此参数有助于在最初路径计划创建后插入停靠点，因为新停靠点可以插入到序列间距中。值必须为正整数。默认值为 1。首次求解分析时，`Sequence` 字段值将使用指定的序列间距填充顺序值。在同一分析的后续求解中，将保留现有停靠点的 `Sequence` 字段值，新的停靠点会将未被其他停靠点使用的可用整数用于 `Sequence` 字段，插入到间距中。如果序列间距设置为 1，则每次求解时，序列值都会更新为连续的值。	Long
ignore_invalid_order_locations （可选）	指定是否忽略无效的停靠点位置。 `SKIP`—将忽略无效的停靠点位置，仅使用有效位置即可成功进行分析。 `HALT`—不会忽略无效的停靠点位置，从而导致分析失败。这是默认设置。	Boolean
line_shape （可选）	指定将用于分析所输出的路径要素的形状类型。无论指定的输出形状类型为何，最佳路径始终由网络阻抗（而非欧氏距离）决定。这表示只是路径形状不同，而对网络进行的基础遍历则相同。 `ALONG_NETWORK`—输出路径将具有基础网络源的精确形状。输出包含路径测量值以用于线性参考。测量值从第一个停靠点增加并将记录到达指定位置的累积阻抗。 `NO_LINES`—将不会为输出路径生成任何形状。 `STRAIGHT_LINES`—输出路径形状为两个停靠点之间的一条直线。这是默认设置。	String
generate_directions_on_solve （可选）	指定运行分析时是否生成方向。对于不需要生成转向指示的分析，关闭方向生成可以减少求解分析的时间。 `DIRECTIONS`—求解时会生成转向指示。 `NO_DIRECTIONS`—求解时不会生成转向指示。这是默认设置。	Boolean
analysis_geodatabase （可选）	存储新网络分析图层的子图层的文件地理数据库工作空间。当未指定此参数时，将在当前工作空间地理处理环境（通常为工程地理数据库）中创建子图层的数据。了解有关网络分析图层的分析数据源的详细信息	Workspace
analysis_feature_dataset_name （可选）	用于命名该工具将在分析地理数据库中创建的新要素数据集的名称，该数据集将用于存储网络分析图层的子图层数据。如未指定，要素数据集将以随机唯一名称创建。了解有关网络分析图层的分析数据源的详细信息	String

派生输出

名称	说明	数据类型
out_network_analysis_layer	新网络分析图层。	Network Analyst Layer

代码示例

提示：

虽然该工具可以在 Python 脚本中使用，但在 Python 中执行网络分析的最佳实践是使用 arcpy.nax 模块中的求解程序类。了解有关在 Python 中执行网络分析的详细信息。

MakeLastMileDeliveryAnalysisLayer 示例 1（Python 窗口）

运行工具，指定一个参数子集。

import datetime

arcpy.na.MakeLastMileDeliveryAnalysisLayer(
    r"C:\Data\SanFrancisco.gdb\Transportation\Streets_ND",
    "Package Delivery",
    "Trucking Time",
    time_units="Hours",
    earliest_route_start_date=datetime.date(2023, 11, 28),
    earliest_route_start_time=datetime.time(7, 30, 0),
    route_start_flexibility=1.5,
    line_shape="NO_LINES"
)

环境

当前工作空间

许可信息

基本: 是
标准: 是
高级: 是

标注	说明	数据类型
网络数据源	将对其执行网络分析的网络数据集或服务。可以使用以下值来指定该参数：网络数据集的目录路径。网络数据集图层已使用标准路由服务配置了 ArcGIS Online 或 ArcGIS Enterprise 门户的 URL 要使用门户 URL，您必须使用具有路径选择权限的账户登录门户。了解有关使用路径服务的网络分析详细信息当使用 ArcGIS Online 或使用 ArcGIS Online 配置路径服务的 ArcGIS Enterprise 门户作为输入网络时，解决分析将消耗配额并受到某些限制，例如允许的输入数量。了解关于网络分析中配额消耗和分析限制的详细信息此网络必须至少包含一个出行模式、一个成本属性（以时间单位计）、一个成本属性（以距离单位计），以及一个时区属性。	Network Dataset Layer; String
图层名称（可选）	将创建的网络分析图层的名称。	String
出行模式（可选）	要在分析中使用的出行模式名称。出行模式为一组网络设置（例如行驶限制和 U 形转弯），用于确定行人、车辆、卡车或其他交通媒介在网络中的移动方式。出行模式在网络数据源中进行定义。 `arcpy.na.TravelMode` 对象和包含出行模式有效 JSON 表示的字符串也可用作此参数的输入。出行模式的阻抗属性必须具有时间单位。	String
时间单位（可选）	指定将用于分析图层的属性和分析图层的子图层和表（网络分析类）的时态字段所用的时间单位。该值不需要与时间成本属性的单位匹配。分—时间单位将为分钟。这是默认设置。秒—时间单位将为秒。小时—时间单位将为小时。天—时间单位将为天。	String
距离单位（可选）	指定将用于分析图层的属性和分析图层的子图层和表（网络分析类）的距离字段所用的距离单位。该值不需要与可选距离成本属性的单位匹配。注意：当网络数据源是服务时，英寸、厘米、毫米和分米选项不可用。英里—距离单位将为英里。这是默认设置。千米—距离单位将为千米。英尺—距离单位将为英尺。码—距离单位将为码。米—距离单位将为米。英寸—距离单位为英寸。厘米—距离单位为厘米。毫米—距离单位为毫米。分米—距离单位为分米。海里—距离单位将为海里。	String
最早路径开始日期（可选）	默认最早路径开始日期。此日期用于所有在 `Routes` 子图层中 `EarliestStartDate` 字段为 null 的路径。当未指定参数值时，`Routes` 子图层中的所有行都必须在 `EarliestStartDate` 字段中指定一个值。虽然可以为此参数同时指定日期和时间，但仅会使用日期。要设置最早路径开始时间，请使用最早路径开始时间参数。注意：虽然其他 Network Analyst 求解程序允许您使用特殊日期来模拟一周中的某一天或当前日期（而非特定静态日期），但最后一公里配送求解程序不支持此操作。必须选择具体日期。	Date
最早路径开始时间（可选）	默认最早路径开始时间。此时间用于所有在 `Routes` 子图层中 `EarliestStartTime` 字段为 null 的路径。当未指定参数值时，`Routes` 子图层中的所有行都必须在 `EarliestStartTime` 字段中指定一个值。虽然可以为此参数同时指定日期和时间，但仅会使用时间。要设置最早路径开始日期，请使用最早路径开始日期参数。	Date
最长路径总时间（可选）	每条路径允许的最大总时间。值可为任意正数。此值用于所有在 `Routes` 子图层中 `MaxTotalTime` 字段为 null 的路径。当未指定参数值时，`Routes` 子图层中的所有行都必须在 `MaxTotalTime` 字段中指定一个值。该值以时间单位参数指定的单位来解释。	Double
时间字段的时区（可选）	指定将用于工具支持的输入日期时间字段的时区。如果不知道停靠点或站点所在的时区，或者停靠点或站点处在多个时区内并且您想要所有的日期时间值同时启动，那么在 UTC 中指定日期时间值非常有用。各位置的本地时间—与停靠点或站点相关的日期时间值位于停靠点和站点所在的时区内。对于路径，日期时间值基于路径的起始站点所在的时区。如果路径没有起始站点，则路径上的所有停靠点和站点必须位于一个时区中。这是默认设置。 UTC—与停靠点、站点和路径相关的日期时间值采用协调世界时间 (UTC)，且不基于停靠点或站点所在的时区。	String
序列间距（可选）	求解分析时 Orders 子图层 `Sequence` 字段中填写的相邻停靠点间距的数值。该值作为各个路径上实际停靠点序列的乘数。例如，如果间距为 5，则路径上的第一个停靠点的 `Sequence` 字段值为 5，路径上第二个停靠点的 `Sequence` 字段值为 10，第三个为 15，以此类推。此参数有助于在最初路径计划创建后插入停靠点，因为新停靠点可以插入到序列间距中。值必须为正整数。默认值为 1。首次求解分析时，`Sequence` 字段值将使用指定的序列间距填充顺序值。在同一分析的后续求解中，将保留现有停靠点的 `Sequence` 字段值，新的停靠点会将未被其他停靠点使用的可用整数用于 `Sequence` 字段，插入到间距中。如果序列间距设置为 1，则每次求解时，序列值都会更新为连续的值。	Long
求解时忽略无效的停靠点位置（可选）	指定是否忽略无效的停靠点位置。选中—将忽略无效的停靠点位置，仅使用有效位置即可成功进行分析。未选中—不会忽略无效的停靠点位置，从而导致分析失败。这是默认设置。	Boolean
输出路径形状（可选）	指定将用于分析所输出的路径要素的形状类型。无论指定的输出形状类型为何，最佳路径始终由网络阻抗（而非欧氏距离）决定。这表示只是路径形状不同，而对网络进行的基础遍历则相同。沿网络—输出路径将具有基础网络源的精确形状。输出包含路径测量值以用于线性参考。测量值从第一个停靠点增加并将记录到达指定位置的累积阻抗。无线—将不会为输出路径生成任何形状。直线—输出路径形状为两个停靠点之间的一条直线。这是默认设置。	String
根据求解生成方向（可选）	指定运行分析时是否生成方向。对于不需要生成转向指示的分析，关闭方向生成可以减少求解分析的时间。选中—求解时会生成转向指示。未选中—求解时不会生成转向指示。这是默认设置。	Boolean
分析地理数据库（可选）	存储新网络分析图层的子图层的文件地理数据库工作空间。当未指定此参数时，将在当前工作空间地理处理环境（通常为工程地理数据库）中创建子图层的数据。了解有关网络分析图层的分析数据源的详细信息	Workspace
分析要素数据集名称（可选）	用于命名该工具将在分析地理数据库中创建的新要素数据集的名称，该数据集将用于存储网络分析图层的子图层数据。如未指定，要素数据集将以随机唯一名称创建。了解有关网络分析图层的分析数据源的详细信息	String

创建最后一公里配送分析图层 (Network Analyst 工具)

汇总

用法

参数

注意：

注意：

派生输出

环境

许可信息

相关主题