创建最近设施点分析图层 (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
行驶方向（可选）	指定设施点与事件点之间的行驶方向。如果网络包含基于出行方向的单行道或阻抗，则出行方向可能会影响找到的设施点。例如，从特定事件点到特定设施点驾车可能需要 10 分钟，但是从另一个方向，即设施点到事件点可能需要 15 分钟，因为存在单行线或交通状况不同。朝向设施点—行进方向为从事件点到设施点。零售店通常使用该设置，因为他们需要关注购物者（事件点）到达商店（设施点）所需的时间。这是默认设置。远离设施点—行驶方向 - 从设施点到事件点。消防部门通常使用该设置，因为他们需要关注从消防站（设施点）行驶到紧急救援位置（事件点）所需的时间。	String
中断（可选）	阻抗值到达该值后将停止搜索指定事件点的设施点（以出行模式值使用的阻抗属性为单位）。当将行驶方向参数设置为朝向设施点时，在事件点子图层中指定单个中断值可按事件点覆盖中断，当将行驶方向参数设置为远离设施点时，在设施点子图层中指定单个中断值可按设施点覆盖中断。默认情况下分析不使用中断。	Double
要查找的设施点数（可选）	要按事件点查找的最近设施点数。可通过在事件点子图层中指定 `TargetFacilityCount` 属性的各个值来覆盖此默认值。要查找的设施点默认数量为一。	Long
时间（可选）	路径开始或结束的时间和日期。对该值的解释取决于是将时间用法设置为路径的起始时间还是终止时间。如果您选择基于流量的阻抗属性，将会根据特定的某天某时的动态交通状况来生成解决方案。日期和时间可被指定为 5/14/2012 10:30 AM。将分析配置为使用以下特殊日期之一以针对一周中的某天或当前日期建模（而非使用特定静态日期）： Today—12/30/1899 Sunday—12/31/1899 Monday—1/1/1900 Tuesday—1/2/1900 Wednesday—1/3/1900 Thursday—1/4/1900 Friday—1/5/1900 Saturday—1/6/1900 了解如何在网络分析中使用和解释日期和时间的详细信息	Date
时区（可选）	时间参数的时区。各位置的本地时间—时间参数采用设施点或事件点所处的时区。这是默认设置。如果将时间用法设置为开始时间，行驶方向设置为远离设施点，则为设施点所在时区。如果将时间用法设置为开始时间，行驶方向设置为朝向设施点，则为事件点所在时区。如果将时间用法设置为结束时间，行驶方向设置为远离设施点，则为事件点所在时区。如果将时间用法设置为结束时间，行驶方向设置为朝向设施点，则为设施点所在时区。 UTC—时间参数指协调世界时间 (UTC)。如果您要查找指定时间内（如现在）的最近位置，但不确定设施点或事件所在的时区，请选择此选项。	String
时间用法（可选）	指定时间参数值是表示路径的到达时间还是出发时间。开始时间—时间参数值可理解为从设施点或事件点出发的时间。这是默认设置。当选择此设置时，时间参数表示求解程序将基于给定离开时间找到最佳路径。结束时间—时间参数值可理解为到达设施点或事件点的时间。如果您想知道从一个地点的出发时间，从而能在时间参数中所指定的时间到达目的地，此选项将十分有用。	String
线状（可选）	指定将用于分析所输出的路径要素的形状类型。无论指定的输出形状类型为何，最佳路径始终由网络阻抗（而非欧氏距离）决定。这表示只是路径形状不同，而对网络进行的基础遍历则相同。沿网络—输出路径将具有基础网络源的精确形状。输出包含路径测量值以用于线性参考。测量值从第一个停靠点增加并将记录到达指定位置的累积阻抗。无线—将不会为输出路径生成任何形状。直线—输出路径形状为两个停靠点之间的一条直线。	String
累积属性（可选）	分析过程中要累积的成本属性的列表。这些累积属性仅供参考；求解程序仅使用求解分析时指定的出行模式所使用的成本属性。对于每个累积的成本属性，会在网络分析输出要素中填充 `Total_` [阻抗] 属性。如果网络数据源为 ArcGIS Online 服务，或如果网络数据源是不支持累积的 Portal for ArcGIS 版本上的服务，则此参数不可用。	String
根据求解生成方向（可选）	指定运行分析时是否生成方向。对于不需要生成转向指示的分析，关闭方向生成可以减少求解分析的时间。选中—求解时会生成转向指示。未选中—求解时不会生成转向指示。这是默认设置。	Boolean
在求解时忽略无效的位置（可选）	指定是否忽略无效的输入位置。通常，如果无法在网络上定位，则位置无效。当无效位置被忽略时，求解程序将跳过它们并尝试使用剩余位置执行分析。选中—将忽略无效输入位置并仅使用有效位置。这是默认设置。未选中—将使用所有输入位置。无效位置将导致分析失败。	Boolean
分析地理数据库（可选）	存储新网络分析图层的子图层的文件地理数据库工作空间。当未指定此参数时，将在当前工作空间地理处理环境（通常为工程地理数据库）中创建子图层的数据。了解有关网络分析图层的分析数据源的详细信息	Workspace
分析要素数据集名称（可选）	用于命名该工具将在分析地理数据库中创建的新要素数据集的名称，该数据集将用于存储网络分析图层的子图层数据。如未指定，要素数据集将以随机唯一名称创建。了解有关网络分析图层的分析数据源的详细信息	String

派生输出

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

arcpy.na.MakeClosestFacilityAnalysisLayer(network_data_source, {layer_name}, {travel_mode}, {travel_direction}, {cutoff}, {number_of_facilities_to_find}, {time_of_day}, {time_zone}, {time_of_day_usage}, {line_shape}, {accumulate_attributes}, {generate_directions_on_solve}, {ignore_invalid_locations}, {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
travel_direction （可选）	指定设施点与事件点之间的行驶方向。如果网络包含基于出行方向的单行道或阻抗，则出行方向可能会影响找到的设施点。例如，从特定事件点到特定设施点驾车可能需要 10 分钟，但是从另一个方向，即设施点到事件点可能需要 15 分钟，因为存在单行线或交通状况不同。 `TO_FACILITIES`—行进方向为从事件点到设施点。零售店通常使用该设置，因为他们需要关注购物者（事件点）到达商店（设施点）所需的时间。这是默认设置。 `FROM_FACILITIES`—行驶方向 - 从设施点到事件点。消防部门通常使用该设置，因为他们需要关注从消防站（设施点）行驶到紧急救援位置（事件点）所需的时间。	String
cutoff （可选）	阻抗值到达该值后将停止搜索指定事件点的设施点（以 `travel_mode` 值使用的阻抗属性为单位）。当 `travel_direction` 参数设置为 `TO_FACILITIES` 时，可在事件点子图层中指定各个中断值以按事件点覆盖中断；当 `travel_direction` 参数设置为 `FROM_FACILITIES` 时，可在设施点子图层中指定各个中断值以按设施点覆盖中断。默认情况下分析不使用中断。	Double
number_of_facilities_to_find （可选）	要按事件点查找的最近设施点数。可通过在事件点子图层中指定 `TargetFacilityCount` 属性的各个值来覆盖此默认值。要查找的设施点默认数量为一。	Long
time_of_day （可选）	路径开始或结束的时间和日期。对该值的解释取决于是将 `time_of_day_usage` 设置为路径的起始时间还是终止时间。如果您选择基于流量的阻抗属性，将会根据特定的某天某时的动态交通状况来生成解决方案。日期和时间可被指定为 5/14/2012 10:30 AM。将分析配置为使用以下特殊日期之一以针对一周中的某天或当前日期建模（而非使用特定静态日期）： Today—12/30/1899 Sunday—12/31/1899 Monday—1/1/1900 Tuesday—1/2/1900 Wednesday—1/3/1900 Thursday—1/4/1900 Friday—1/5/1900 Saturday—1/6/1900 了解如何在网络分析中使用和解释日期和时间的详细信息	Date
time_zone （可选）	指定 `time_of_day` 参数的时区。 `LOCAL_TIME_AT_LOCATIONS`—`time_of_day` 参数采用设施点或事件点所处的时区。这是默认设置。如果将 `time_of_day_usage` 设置为 `START_TIME`，`travel_direction` 设置为 `FROM_FACILITIES`，则为设施点所在时区。如果将 `time_of_day_usage` 设置为 `START_TIME`，`travel_direction` 设置为 `TO_FACILITIES`，则为事件点所在时区。如果将 `time_of_day_usage` 设置为 `END_TIME`，`travel_direction` 设置为 `FROM_FACILITIES`，则为事件点所在时区。如果将 `time_of_day_usage` 设置为 `END_TIME`，`travel_direction` 设置为 `TO_FACILITIES`，则为设施点所在时区。 `UTC`—`time_of_day` 参数采用协调世界时间 (UTC)。如果您要查找指定时间内（如现在）的最近位置，但不确定设施点或事件所在的时区，请选择此选项。	String
time_of_day_usage （可选）	指定 `time_of_day` 参数值是表示路径的到达时间还是出发时间。 `START_TIME`—`time_of_day` 参数值可理解为从设施点或事件点出发的时间。这是默认设置。当选择此设置时，`time_of_day` 参数表示求解程序将基于给定离开时间找到最佳路径。 `END_TIME`—`time_of_day` 参数值可理解为到达设施点或事件点的时间。如果您想知道从一个地点的出发时间，从而能在 `time_of_day` 参数所指定的时间到达目的地，该选项将十分有用。	String
line_shape （可选）	指定将用于分析所输出的路径要素的形状类型。无论指定的输出形状类型为何，最佳路径始终由网络阻抗（而非欧氏距离）决定。这表示只是路径形状不同，而对网络进行的基础遍历则相同。 `ALONG_NETWORK`—输出路径将具有基础网络源的精确形状。输出包含路径测量值以用于线性参考。测量值从第一个停靠点增加并将记录到达指定位置的累积阻抗。 `NO_LINES`—将不会为输出路径生成任何形状。 `STRAIGHT_LINES`—输出路径形状为两个停靠点之间的一条直线。	String
accumulate_attributes [accumulate_attributes,...] （可选）	分析过程中要累积的成本属性的列表。这些累积属性仅供参考；求解程序仅使用求解分析时指定的出行模式所使用的成本属性。对于每个累积的成本属性，会在网络分析输出要素中填充 `Total_` [阻抗] 属性。如果网络数据源为 ArcGIS Online 服务，或如果网络数据源是不支持累积的 Portal for ArcGIS 版本上的服务，则此参数不可用。	String
generate_directions_on_solve （可选）	指定运行分析时是否生成方向。对于不需要生成转向指示的分析，关闭方向生成可以减少求解分析的时间。 `DIRECTIONS`—求解时会生成转向指示。 `NO_DIRECTIONS`—求解时不会生成转向指示。这是默认设置。	Boolean
ignore_invalid_locations （可选）	指定是否忽略无效的输入位置。通常，如果无法在网络上定位，则位置无效。当无效位置被忽略时，求解程序将跳过它们并尝试使用剩余位置执行分析。 `SKIP`—将忽略无效输入位置并仅使用有效位置。这是默认设置。 `HALT`—将使用所有输入位置。无效位置将导致分析失败。	Boolean
analysis_geodatabase （可选）	存储新网络分析图层的子图层的文件地理数据库工作空间。当未指定此参数时，将在当前工作空间地理处理环境（通常为工程地理数据库）中创建子图层的数据。了解有关网络分析图层的分析数据源的详细信息	Workspace
analysis_feature_dataset_name （可选）	用于命名该工具将在分析地理数据库中创建的新要素数据集的名称，该数据集将用于存储网络分析图层的子图层数据。如未指定，要素数据集将以随机唯一名称创建。了解有关网络分析图层的分析数据源的详细信息	String

派生输出

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

代码示例

提示：

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

MakeClosestFacilityAnalysisLayer 示例 1（Python 窗口）

仅使用必需参数运行该工具。

network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.MakeClosestFacilityAnalysisLayer(network, "ClosestFireStations")

MakeClosestFacilityAnalysisLayer 示例 2（Python 窗口）

使用所有参数运行该工具。

network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.MakeClosestFacilityAnalysisLayer(network, "ClosestHospitals",
                                "Driving Time", "TO_FACILITIES", 5, 3,
                                "1/1/1900 9:00 AM", "UTC", "START_TIME",
                                "ALONG_NETWORK", ["Meters", "TravelTime"])

MakeClosestFacilityAnalysisLayer 示例 3（独立脚本）

以下独立 Python 脚本演示了如何使用 MakeClosestFacilityAnalysisLayer 函数查找距商店位置最近的仓库。

# Name: MakeClosestFacilityAnalysisLayer_Workflow.py
# Description: Find the closest warehouse from the store locations and save the
#              results to a layer file on disk.
# Requirements: Network Analyst extension

#Import system modules
import arcpy
from arcpy import env
import os

try:
    #Set environment settings
    output_dir = "C:/Data"
    #The NA layer's data will be saved to the workspace specified here
    env.workspace = os.path.join(output_dir, "Output.gdb")
    env.overwriteOutput = True

    #Set local variables
    input_gdb = "C:/Data/Paris.gdb"
    network = os.path.join(input_gdb, "Transportation", "ParisMultimodal_ND")
    layer_name = "ClosestWarehouse"
    travel_mode = "Driving Time"
    facilities = os.path.join(input_gdb, "Analysis", "Warehouses")
    incidents = os.path.join(input_gdb, "Analysis", "Stores")
    output_layer_file = os.path.join(output_dir, layer_name + ".lyrx")

    #Create a new closest facility analysis layer.
    result_object = arcpy.na.MakeClosestFacilityAnalysisLayer(network,
                                    layer_name, travel_mode, "TO_FACILITIES",
                                    number_of_facilities_to_find=1)

    #Get the layer object from the result object. The closest facility layer can
    #now be referenced using the layer object.
    layer_object = result_object.getOutput(0)

    #Get the names of all the sublayers within the closest facility layer.
    sublayer_names = arcpy.na.GetNAClassNames(layer_object)
    #Stores the layer names that we will use later
    facilities_layer_name = sublayer_names["Facilities"]
    incidents_layer_name = sublayer_names["Incidents"]

    #Load the warehouses as Facilities using the default field mappings and
    #search tolerance
    arcpy.na.AddLocations(layer_object, facilities_layer_name,
                            facilities, "", "")

    #Load the stores as Incidents. Map the Name property from the NOM field
    #using field mappings
    field_mappings = arcpy.na.NAClassFieldMappings(layer_object,
                                                    incidents_layer_name)
    field_mappings["Name"].mappedFieldName = "NOM"
    arcpy.na.AddLocations(layer_object, incidents_layer_name, incidents,
                          field_mappings, "")

    #Solve the closest facility layer
    arcpy.na.Solve(layer_object)

    #Save the solved closest facility layer as a layer file on disk
    layer_object.saveACopy(output_layer_file)

    print("Script completed successfully")

except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    print("An error occurred on line %i" % tb.tb_lineno)
    print(str(e))

环境

当前工作空间

许可信息

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

创建最近设施点分析图层 (Network Analyst 工具)

汇总

用法

参数

派生输出

环境

许可信息

相关主题