求解 (Network Analyst)

摘要

基于网络位置和属性求解网络分析图层问题。

使用情况

• 求解失败时，警告和错误消息可提供有关失败原因的有用信息。

• 运行此工具前，请确保为网络分析图层指定了求解问题所需的所有参数。

• 网络分析图层引用 ArcGIS Online 作为网络数据源时，该工具将消耗配额。 有关详细信息，请参阅配额。

参数

对话框

标注	说明	数据类型
输入网络分析图层	要进行分析计算的网络分析图层。	Network Analyst Layer
忽略无效的位置 (可选)	指定是否忽略无效的输入位置。 通常，如果无法在网络上定位，则位置无效。 当无效位置被忽略时，求解器将跳过它们并尝试使用剩余位置执行分析。 选中 - 将忽略无效的输入位置，并且仅使用有效的位置。 未选中 - 将使用所有输入位置。 无效的位置将导致求解失败。 默认值将与指定输入网络分析图层值上的求解时忽略无效位置设置相匹配。	Boolean
因求解出错而终止 (可选)	指定在求解过程中遇到错误时是否终止工具执行。 选中 - 该工具在求解程序遇到错误时将无法执行操作。 这是默认设置。 未选中 - 即使求解程序遇到错误，该工具也不停止，而是继续执行操作。 求解器返回的所有错误消息都将转换为警告消息。 如果在应用程序中启用了后台处理，则使用该选项。	Boolean
简化容差 (可选)	容差确定输出几何的简化程度。 如果已指定了容差，容差必须大于零。 可以选择首选单位；默认单位为十进制度。 指定简化容差会减少渲染路径或服务区的时间。 但缺点是，简化几何移除了折点，这样会降低以更大比例输出的空间精确度。 由于带两个折点的线不能再简化，所以此参数对单一线段输出的绘制时间没有影响，例如直线路线、 OD 成本矩阵线和位置分配线。	Linear Unit
覆盖 (可选)	求解网络分析问题时可影响求解程序行为的其他设置。 必须在 JavaScript 对象表示法 (JSON) 中指定此参数的值。 例如，有效值的格式如下：{"overrideSetting1" : "value1", "overrideSetting2" : "value2"}。 覆盖设置名称始终以双引号括起。 该值可以是数字、布尔值或字符串。 此参数的默认值为无值，表示不会覆盖求解器设置。 覆盖是高级设置，应仅在谨慎分析应用设置前后得到的结果之后使用。 要获取每个求解程序支持的覆盖设置及其可接受值的列表，请联系 Esri 技术支持。	String

派生输出

标注	说明	数据类型
网络分析图层	已求解的网络分析图层。	Network Analyst Layer
求解成功	指示求解是否成功的布尔值。	Boolean

Python

arcpy.na.Solve(in_network_analysis_layer, {ignore_invalids}, {terminate_on_solve_error}, {simplification_tolerance}, {overrides})

名称	说明	数据类型
in_network_analysis_layer	要进行分析计算的网络分析图层。	Network Analyst Layer
ignore_invalids (可选)	指定是否忽略无效的输入位置。 通常，如果无法在网络上定位，则位置无效。 当无效位置被忽略时，求解器将跳过它们并尝试使用剩余位置执行分析。 SKIP—无效的输入位置将被忽略，只使用有效的位置。 HALT—将使用所有输入位置。 无效的位置将导致求解失败。 默认值将匹配指定 in_network_analysis_layer 值的 ignoreInvalidLocations 属性。	Boolean
terminate_on_solve_error (可选)	指定在求解过程中遇到错误时是否终止工具执行。 TERMINATE—该工具将在求解程序遇到错误时无法执行操作。 这是默认设置。 使用该选项时，如果工具因求解程序遇到错误而无法执行操作，则不创建任何 Result 对象。 查看来自 ArcPy 对象的地理处理消息。 CONTINUE—即使求解程序遇到错误，该工具也不停止，而是继续执行操作。 求解器返回的所有错误消息都将转换为警告消息。 使用该选项时，即使求解程序遇到错误，也始终创建 Result 对象，并将 Result 对象的 maxSeverity 属性设置为 1。 将 Result 对象的 getOutput 方法和索引值 1 结合使用可确定求解程序是否成功。	Boolean
simplification_tolerance (可选)	容差确定输出几何的简化程度。 如果已指定了容差，容差必须大于零。 可以选择首选单位；默认单位为十进制度。 指定简化容差会减少渲染路径或服务区的时间。 但缺点是，简化几何移除了折点，这样会降低以更大比例输出的空间精确度。 由于带两个折点的线不能再简化，所以此参数对单一线段输出的绘制时间没有影响，例如直线路线、 OD 成本矩阵线和位置分配线。	Linear Unit
overrides (可选)	求解网络分析问题时可影响求解程序行为的其他设置。 必须在 JavaScript 对象表示法 (JSON) 中指定此参数的值。 例如，有效值的格式如下：{"overrideSetting1" : "value1", "overrideSetting2" : "value2"}。 覆盖设置名称始终以双引号括起。 该值可以是数字、布尔值或字符串。 此参数的默认值为无值，表示不会覆盖求解器设置。 覆盖是高级设置，应仅在谨慎分析应用设置前后得到的结果之后使用。 要获取每个求解程序支持的覆盖设置及其可接受值的列表，请联系 Esri 技术支持。	String

派生输出

名称	说明	数据类型
output_layer	已求解的网络分析图层。	Network Analyst Layer
solve_succeeded	指示求解是否成功的布尔值。	Boolean

代码示例

求解示例 1（Python 窗口）

使用所有参数执行工具。

arcpy.na.Solve("Route", "HALT", "TERMINATE", "10 Meters")

求解示例 2（工作流）

以下独立 Python 脚本演示了如何使用 Solve 工具执行最近设施点分析并将结果保存到图层文件中。

# Name: Solve_Workflow.py
# Description: Solve a closest facility analysis to 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:
    #Check out Network Analyst license if available. Fail if the Network Analyst license is not available.
    if arcpy.CheckExtension("network") == "Available":
        arcpy.CheckOutExtension("network")
    else:
        raise arcpy.ExecuteError("Network Analyst Extension license is not available.")
    
    #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))

环境

当前工作空间

特殊情况

许可信息

• Basic: 受限
• Standard: 受限
• Advanced: 受限