创建废弃物收集分析图层 (Network Analyst 工具)

汇总

创建废弃物收集网络分析图层并设置其分析属性。废弃物收集分析图层对于优化使用车队收集城市废弃物的路线很有用。可使用网络数据集生成图层。

用法

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

了解有关网络分析图层工作流的详细信息
用于废弃物收集分析的分析网络必须至少具有一个出行模式、一个具有时间单位的成本属性和一个具有距离单位的成本属性。
默认情况下，将在当前工作空间地理处理环境（通常为工程地理数据库）中新建的、自动命名的要素数据集中创建新分析图层的数据。将在相同地理数据库的根级别创建基于表的数据，因为无法将表存储在要素数据集中。可以使用分析地理数据库和分析要素数据集名称参数来覆盖此行为。
虽然该工具可以在 Python 脚本中使用，但在 Python 中执行网络分析的最佳实践是使用 arcpy.nax 模块中的求解程序类。

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

标注	说明	数据类型
网络数据源	将对其执行网络分析的网络数据集或服务。可以使用以下值来指定该参数：网络数据集的目录路径。网络数据集图层网络必须至少具有一个出行模式、一个具有时间单位的成本属性和一个具有距离单位的成本属性。	Network Dataset Layer; String
图层名称（可选）	将创建的网络分析图层的名称。	String
出行模式（可选）	要在分析中使用的出行模式名称。出行模式代表一组网络设置（例如出行限制和 U 形转弯策略），用于确定行人、汽车、卡车或其他交通媒介在网络中的移动方式。出行模式在网络数据源中进行定义。 `arcpy.na.TravelMode` 对象和包含出行模式有效 JSON 表示的字符串也可用作此参数的输入。出行模式的阻抗属性必须具有时间单位。对于废弃物收集分析，必须在死胡同处允许调头。如果出行模式不允许任何调头，则求解程序将放宽出行模式的调头策略以允许在死胡同处调头。	String
时间单位（可选）	指定将用于分析图层的属性和分析图层的子图层和表（网络分析类）的时态字段所用的时间单位。该值不需要与时间成本属性的单位匹配。分—时间单位将为分钟。这是默认设置。秒—时间单位将为秒。小时—时间单位将为小时。天—时间单位将为天。	String
距离单位（可选）	指定将用于分析图层的属性和分析图层的子图层和表（网络分析类）的距离字段所用的距离单位。该值不需要与可选距离成本属性的单位匹配。英里—距离单位将为英里。这是默认设置。千米—距离单位将为千米。英尺—距离单位将为英尺。码—距离单位将为码。米—距离单位将为米。英寸—距离单位为英寸。厘米—距离单位为厘米。毫米—距离单位为毫米。分米—距离单位为分米。海里—距离单位将为海里。	String
路径开始时间（可选）	路径的默认开始时间。此时间用于 Routes 子图层中 `StartTime` 字段为空值的所有路径。如果未指定参数值，则 Routes 子图层中的所有行必须指定 `StartTime` 字段值。虽然可以为此参数同时指定日期和时间，但仅会使用时间。	Date
最长路径总时间（可选）	每条路径允许的最大总时间。值可为任意正数。该值将用于 Routes 子图层中 `MaxTotalTime` 字段为空值的所有路径。如果未指定值，则 Routes 子图层中的所有行必须指定 `MaxTotalTime` 字段值。该值以时间单位参数指定的单位来解释。	Double
停靠点收集模式（可选）	指定每个停靠点的默认停靠点收集模式。该值可以是下面列出的选项之一，也可以留空（默认）。该值将用于 Stops 子图层中 `CollectionMode` 字段为空值的所有停靠点。如果未指定值，则 Stops 子图层中的所有行必须指定 `CollectionMode` 字段值。单侧—该停靠点所在的街道两侧分别收集，每侧沿街道边缘采用不同的路线进行收集。两侧—将在该停靠点所在的街道两侧沿着街道边缘通过一次性收集。	String
分析地理数据库（可选）	存储新网络分析图层的子图层的文件地理数据库工作空间。当未指定此参数时，将在当前工作空间地理处理环境（通常为工程地理数据库）中创建子图层的数据。了解有关网络分析图层的分析数据源的详细信息	Workspace
分析要素数据集名称（可选）	用于命名该工具将在分析地理数据库中创建的新要素数据集的名称，该数据集将用于存储网络分析图层的子图层数据。如未指定，要素数据集将以随机唯一名称创建。了解有关网络分析图层的分析数据源的详细信息	String

派生输出

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

arcpy.na.MakeWasteCollectionAnalysisLayer(network_data_source, {layer_name}, {travel_mode}, {time_units}, {distance_units}, {route_start_time}, {max_route_total_time}, {stop_collection_mode}, {analysis_geodatabase}, {analysis_feature_dataset_name})

名称	说明	数据类型
network_data_source	将对其执行网络分析的网络数据集或服务。可以使用以下值来指定该参数：网络数据集的目录路径网络数据集图层对象网络数据集图层的字符串名称网络必须至少具有一个出行模式、一个具有时间单位的成本属性和一个具有距离单位的成本属性。	Network Dataset Layer; String
layer_name （可选）	将创建的网络分析图层的名称。	String
travel_mode （可选）	要在分析中使用的出行模式名称。出行模式代表一组网络设置（例如出行限制和 U 形转弯策略），用于确定行人、汽车、卡车或其他交通媒介在网络中的移动方式。出行模式在网络数据源中进行定义。 `arcpy.na.TravelMode` 对象和包含出行模式有效 JSON 表示的字符串也可用作此参数的输入。出行模式的阻抗属性必须具有时间单位。对于废弃物收集分析，必须在死胡同处允许调头。如果出行模式不允许任何调头，则求解程序将放宽出行模式的调头策略以允许在死胡同处调头。	String
time_units （可选）	指定将用于分析图层的属性和分析图层的子图层和表（网络分析类）的时态字段所用的时间单位。该值不需要与时间成本属性的单位匹配。 `Minutes`—时间单位将为分钟。这是默认设置。 `Seconds`—时间单位将为秒。 `Hours`—时间单位将为小时。 `Days`—时间单位将为天。	String
distance_units （可选）	指定将用于分析图层的属性和分析图层的子图层和表（网络分析类）的距离字段所用的距离单位。该值不需要与可选距离成本属性的单位匹配。 `Miles`—距离单位将为英里。这是默认设置。 `Kilometers`—距离单位将为千米。 `Feet`—距离单位将为英尺。 `Yards`—距离单位将为码。 `Meters`—距离单位将为米。 `Inches`—距离单位为英寸。 `Centimeters`—距离单位为厘米。 `Millimeters`—距离单位为毫米。 `Decimeters`—距离单位为分米。 `NauticalMiles`—距离单位将为海里。	String
route_start_time （可选）	路径的默认开始时间。此时间用于 Routes 子图层中 `StartTime` 字段为空值的所有路径。如果未指定参数值，则 Routes 子图层中的所有行必须指定 `StartTime` 字段值。请使用 `datetime.time` 对象指定此参数值。	Date
max_route_total_time （可选）	每条路径允许的最大总时间。值可为任意正数。该值将用于 Routes 子图层中 `MaxTotalTime` 字段为空值的所有路径。如果未指定值，则 Routes 子图层中的所有行必须指定 `MaxTotalTime` 字段值。值以 `time_units` 参数中指定的单位进行解释。	Double
stop_collection_mode （可选）	指定每个停靠点的默认停靠点收集模式。该值可以是下面列出的选项之一，也可以留空（默认）。该值将用于 Stops 子图层中 `CollectionMode` 字段为空值的所有停靠点。如果未指定值，则 Stops 子图层中的所有行必须指定 `CollectionMode` 字段值。 `ONE_SIDE`—该停靠点所在的街道两侧分别收集，每侧沿街道边缘采用不同的路线进行收集。 `BOTH_SIDES`—将在该停靠点所在的街道两侧沿着街道边缘通过一次性收集。	String
analysis_geodatabase （可选）	存储新网络分析图层的子图层的文件地理数据库工作空间。当未指定此参数时，将在当前工作空间地理处理环境（通常为工程地理数据库）中创建子图层的数据。了解有关网络分析图层的分析数据源的详细信息	Workspace
analysis_feature_dataset_name （可选）	用于命名该工具将在分析地理数据库中创建的新要素数据集的名称，该数据集将用于存储网络分析图层的子图层数据。如未指定，要素数据集将以随机唯一名称创建。了解有关网络分析图层的分析数据源的详细信息	String

派生输出

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

代码示例

提示：

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

MakeWasteCollectionAnalysisLayer 示例 1（Python 窗口）

运行指定参数子集的 MakeWasteCollectionAnalysisLayer 函数。

import datetime

arcpy.na.MakeWasteCollectionAnalysisLayer(
    r"C:\Data\SanFrancisco.gdb\Transportation\Streets_ND",
    "Waste Collection Option B",
    "Garbage Truck Time",
    time_units="Hours",
    max_route_total_time=6.5,
    route_start_time=datetime.time(6, 30, 0),
)

环境

当前工作空间

许可信息

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

标注	说明	数据类型
网络数据源	将对其执行网络分析的网络数据集或服务。可以使用以下值来指定该参数：网络数据集的目录路径。网络数据集图层网络必须至少具有一个出行模式、一个具有时间单位的成本属性和一个具有距离单位的成本属性。	Network Dataset Layer; String
图层名称（可选）	将创建的网络分析图层的名称。	String
出行模式（可选）	要在分析中使用的出行模式名称。出行模式代表一组网络设置（例如出行限制和 U 形转弯策略），用于确定行人、汽车、卡车或其他交通媒介在网络中的移动方式。出行模式在网络数据源中进行定义。 `arcpy.na.TravelMode` 对象和包含出行模式有效 JSON 表示的字符串也可用作此参数的输入。出行模式的阻抗属性必须具有时间单位。对于废弃物收集分析，必须在死胡同处允许调头。如果出行模式不允许任何调头，则求解程序将放宽出行模式的调头策略以允许在死胡同处调头。	String
时间单位（可选）	指定将用于分析图层的属性和分析图层的子图层和表（网络分析类）的时态字段所用的时间单位。该值不需要与时间成本属性的单位匹配。分—时间单位将为分钟。这是默认设置。秒—时间单位将为秒。小时—时间单位将为小时。天—时间单位将为天。	String
距离单位（可选）	指定将用于分析图层的属性和分析图层的子图层和表（网络分析类）的距离字段所用的距离单位。该值不需要与可选距离成本属性的单位匹配。英里—距离单位将为英里。这是默认设置。千米—距离单位将为千米。英尺—距离单位将为英尺。码—距离单位将为码。米—距离单位将为米。英寸—距离单位为英寸。厘米—距离单位为厘米。毫米—距离单位为毫米。分米—距离单位为分米。海里—距离单位将为海里。	String
路径开始时间（可选）	路径的默认开始时间。此时间用于 Routes 子图层中 `StartTime` 字段为空值的所有路径。如果未指定参数值，则 Routes 子图层中的所有行必须指定 `StartTime` 字段值。虽然可以为此参数同时指定日期和时间，但仅会使用时间。	Date
最长路径总时间（可选）	每条路径允许的最大总时间。值可为任意正数。该值将用于 Routes 子图层中 `MaxTotalTime` 字段为空值的所有路径。如果未指定值，则 Routes 子图层中的所有行必须指定 `MaxTotalTime` 字段值。该值以时间单位参数指定的单位来解释。	Double
停靠点收集模式（可选）	指定每个停靠点的默认停靠点收集模式。该值可以是下面列出的选项之一，也可以留空（默认）。该值将用于 Stops 子图层中 `CollectionMode` 字段为空值的所有停靠点。如果未指定值，则 Stops 子图层中的所有行必须指定 `CollectionMode` 字段值。单侧—该停靠点所在的街道两侧分别收集，每侧沿街道边缘采用不同的路线进行收集。两侧—将在该停靠点所在的街道两侧沿着街道边缘通过一次性收集。	String
分析地理数据库（可选）	存储新网络分析图层的子图层的文件地理数据库工作空间。当未指定此参数时，将在当前工作空间地理处理环境（通常为工程地理数据库）中创建子图层的数据。了解有关网络分析图层的分析数据源的详细信息	Workspace
分析要素数据集名称（可选）	用于命名该工具将在分析地理数据库中创建的新要素数据集的名称，该数据集将用于存储网络分析图层的子图层数据。如未指定，要素数据集将以随机唯一名称创建。了解有关网络分析图层的分析数据源的详细信息	String

创建废弃物收集分析图层 (Network Analyst 工具)

汇总

用法

参数

派生输出

环境

许可信息

相关主题