解析の実行 (Solve) (Network Analyst ツール)

サマリー

入力データと解析の設定に基づいて、ネットワーク解析レイヤーを実行します。解析の出力はネットワーク解析レイヤーに追加され、マップテーブルと属性テーブルで調べたり、詳細な解析に使用したりできます。

使用法

このツールは通常、ネットワーク解析ワークフローの一部として使用されます。

ネットワーク解析レイヤーのワークフローの詳細
解析が失敗すると、警告およびエラーメッセージにより失敗の原因に関する有用な情報が表示されます。
ArcGIS Online を使用してルート検索サービスが構成されている ArcGIS Online または ArcGIS Enterprise ポータルを入力ネットワーク解析レイヤーが参照している場合、解析を実行するとクレジットが消費され、特定の制限 (許可された入力の数など) の対象になります。

ネットワーク解析のクレジット消費量と解析の制限の詳細
このツールは Python スクリプトで使用できますが、Python でネットワーク解析を実行する際に推奨されるベストプラクティスは、代わりに arcpy.nax モジュールの解析クラスを使用することです。

Python でのネットワーク解析の実行についての詳細。

ラベル	説明	データタイプ
入力ネットワーク解析レイヤー	解析が実行されるネットワーク解析レイヤー。	Network Analyst Layer
無効なロケーションを除外 (オプション)	無効な入力ロケーションを除外するかどうかを指定します。通常、ネットワーク上で特定できないロケーションは無効になります。無効なロケーションを除外する場合は、そのロケーションがスキップされ、残りのロケーションを使用して解析が実行されます。デフォルト値は、指定された入力ネットワーク解析レイヤー値の解析時に無効なロケーションを除外設定と一致します。オン—無効な入力ロケーションが除外され、有効なロケーションだけが使用されます。オフ—すべての入力ロケーションが使用されます。ロケーションが無効な場合は、解析が正常に実行されません。	Boolean
解析エラー時に処理を終了する (オプション)	解析中にエラーが発生した場合、ツールが実行を停止して終了するかどうかを指定します。オン—エラーが発生した場合、ツールが実行を停止して終了します。これがデフォルトです。オフ—エラーが発生してもツールは停止せず、実行を継続します。解析から返されたすべてのエラーメッセージが警告メッセージとして表示されます。	Boolean
単純化許容値 (オプション)	出力ジオメトリーの単純化の度合いを決定する許容値。許容値を指定する場合、ゼロより大きい値を指定する必要があります。優先的に適用される単位を選択できます。デフォルトの単位は度 (10 進) です。単純化許容値を指定すると、ルートや到達圏のレンダリングにかかる時間を短縮できます。一方で、ジオメトリーを単純化すると、頂点が削除されるので、大縮尺で出力の位置正確度が低下するという欠点があります。頂点が 2 つしかないラインはそれ以上単純化できないため、このパラメーターは、直線ルート、OD コストマトリックスライン、ロケーション-アロケーションラインなどの単一セグメント出力の描画時間には影響を与えません。	Linear Unit
オーバーライド (オプション)	注意: このパラメーターは、内部的な目的のみで使用されます。	String

派生した出力

ラベル	説明	データタイプ
Network Analyst レイヤー	解析されたネットワーク解析レイヤー。	Network Analyst Layer
解析済み	解析が正常に実行されたかどうかを示すブール値。	Boolean

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 (オプション)	無効な入力ロケーションを除外するかどうかを指定します。通常、ネットワーク上で特定できないロケーションは無効になります。無効なロケーションを除外する場合は、そのロケーションがスキップされ、残りのロケーションを使用して解析が実行されます。デフォルト値は、指定された `in_network_analysis_layer` 値の `ignoreInvalidLocations` プロパティと一致します。 `SKIP`—無効な入力ロケーションが除外され、有効なロケーションだけが使用されます。 `HALT`—すべての入力ロケーションが使用されます。ロケーションが無効な場合は、解析が正常に実行されません。	Boolean
terminate_on_solve_error (オプション)	解析中にエラーが発生した場合、ツールが実行を停止して終了するかどうかを指定します。 `TERMINATE`—エラーが発生した場合、ツールが実行を停止して終了します。これがデフォルトです。このオプションを使用すると、ツールが解析中のエラーによって終了した場合に `Result` オブジェクトが作成されません。 ArcPy オブジェクトから取得されたジオプロセシングメッセージを確認してください。 `CONTINUE`—エラーが発生してもツールは停止せず、実行を継続します。解析から返されたすべてのエラーメッセージが警告メッセージとして表示されます。このオプションを使用すると、`Result` オブジェクトが常に作成され、`Result` オブジェクトの `maxSeverity` プロパティは 1 に設定されます。インデックス値を 1 にして `Result` オブジェクトの `getOutput` メソッドを使用すると、解析が正常に実行されたかどうかを判断できます。	Boolean
simplification_tolerance (オプション)	出力ジオメトリーの単純化の度合いを決定する許容値。許容値を指定する場合、ゼロより大きい値を指定する必要があります。優先的に適用される単位を選択できます。デフォルトの単位は度 (10 進) です。単純化許容値を指定すると、ルートや到達圏のレンダリングにかかる時間を短縮できます。一方で、ジオメトリーを単純化すると、頂点が削除されるので、大縮尺で出力の位置正確度が低下するという欠点があります。頂点が 2 つしかないラインはそれ以上単純化できないため、このパラメーターは、直線ルート、OD コストマトリックスライン、ロケーション-アロケーションラインなどの単一セグメント出力の描画時間には影響を与えません。	Linear Unit
overrides (オプション)	注意: このパラメーターは、内部的な目的のみで使用されます。	String

派生した出力

名前	説明	データタイプ
output_layer	解析されたネットワーク解析レイヤー。	Network Analyst Layer
solve_succeeded	解析が正常に実行されたかどうかを示すブール値。	Boolean

コードのサンプル

ヒント:

このツールは Python スクリプトで使用できますが、Python でネットワーク解析を実行する際に推奨されるベストプラクティスは、代わりに arcpy.nax モジュールの解析クラスを使用することです。 Python でのネットワーク解析の実行についての詳細。

Solve の例 1 (Python ウィンドウ)

すべてのパラメーターを使用してツールを実行します。

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

Solve の例 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:
    #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: 限定的
解析中のレイヤーのネットワークデータソースがネットワークデータセットである場合、このツールを使用するには Network Analyst ライセンスが必要ですが、ネットワークデータソースがサービスである場合、Network Analyst ライセンスは不要です。
Standard: 限定的
解析中のレイヤーのネットワークデータソースがネットワークデータセットである場合、このツールを使用するには Network Analyst ライセンスが必要ですが、ネットワークデータソースがサービスである場合、Network Analyst ライセンスは不要です。
Advanced: 限定的
解析中のレイヤーのネットワークデータソースがネットワークデータセットである場合、このツールを使用するには Network Analyst ライセンスが必要ですが、ネットワークデータソースがサービスである場合、Network Analyst ライセンスは不要です。

解析の実行 (Solve) (Network Analyst ツール)

サマリー

使用法

パラメーター

注意:

派生した出力

環境

ライセンス情報

関連トピック