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

摘要

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

使用情况

• 用于废弃物收集分析的分析网络必须至少具有一个出行模式、一个具有时间单位的成本属性和一个具有距离单位的成本属性。

• 通过此工具创建分析图层后，您可以使用添加位置工具向图层中添加网络分析对象；使用求解工具来求解分析；以及使用保存至图层文件工具将结果保存到磁盘中。

• 在地理处理模型中使用此工具时，如果模型作为工具来运行，则必须将输出网络分析图层创建为模型参数；否则，输出图层将无法添加到地图内容中。

• 尽管此工具可在 Python 中运行，在 Python 中自动化废弃物收集工作流的更好方式是使用 arcpy.nax Network Analyst 模块中的 WasteCollection 求解对象。

参数

对话框

标注	说明	数据类型
网络数据源	将对其执行网络分析的网络数据集。 网络必须至少具有一个出行模式、一个具有时间单位的成本属性和一个具有距离单位的成本属性。	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

派生输出

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

Python

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

名称	说明	数据类型
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

派生输出

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

代码示例

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),
)

环境

当前工作空间

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是