最寄り施設の検出レイヤーの作成 (Make Closest Facility Layer) (Network Analyst ツール)

サマリー

最寄り施設の検出ネットワーク解析レイヤーを作成し、解析プロパティを設定します。最寄り施設の検出解析レイヤーは、指定したネットワークコストに基づいて、インシデントまでの最寄り施設の検出を検出する際に役立ちます。

レガシー:

これは非推奨のツールです。この機能は、最寄り施設の検出解析レイヤーの作成 ツールに置き換えられています。

使用法

このツールで解析レイヤーを作成した後は、ロケーションの追加 ツールを使用して解析レイヤーにネットワーク解析オブジェクトを追加し、解析の実行 ツールを使用して解析を実行し、レイヤーファイルの保存 ツールを使用して結果をディスクに保存できます。
このツールをジオプロセシングモデルに使用するときは、モデルをツールとして動作させる場合、出力ネットワーク解析レイヤーにモデルパラメーターを作成する必要があります。そうしないと、出力レイヤーはマップのコンテンツに追加されません。

ラベル	説明	データタイプ
入力ネットワークデータセット	最寄り施設の検出の解析が実行されるネットワークデータセット。	Network Dataset Layer
出力レイヤー名	作成する最寄り施設の検出ネットワーク解析レイヤーの名前。	String
インピーダンス属性	解析でインピーダンスとして使用されるコスト属性。	String
移動方向 (オプション)	施設とインシデントの間で移動する方向を指定します。このオプションを使用することで、移動する方向に基づいた一方通行規制およびさまざまなインピーダンスを考慮した、ネットワーク上のさまざまな施設の検索が可能になります。たとえば、インシデントから施設に向かった場合に要する時間が 10 分間であったとしても、施設からインシデントに向かった場合は方向が異なるために、15 分間を要する場合があります。施設からインシデントへ—移動する方向は施設からインシデントの方向です。消防署の場合、消防署 (施設) から緊急事態の場所 (インシデント) まで移動する時間が重視されるため、通常はこの設定が使用されます。インシデントから施設へ—移動する方向はインシデントから施設の方向です。小売店の場合、買物客 (インシデント) が小売店に到達するまでの時間が重視されるため、通常はこの設定が使用されます。	String
デフォルトのカットオフ値 (オプション)	指定されたインシデントに対する施設の検索を中止するデフォルトのインピーダンス値。移動方向がインシデントから施設の向きである場合にインシデントのカットオフ値を指定することによって、または移動方向が施設からインシデントの向きである場合に施設のカットオフ値を指定することによって、デフォルトをオーバーライドすることができます。	Double
検出する施設数 (オプション)	インシデントごとに検出する最寄り施設のデフォルトの数。インシデントの TargetFacilityCount プロパティの値を指定することでデフォルトをオーバーライドすることができます。	Long
累積 (オプション)	解析中に累積されるコスト属性のリスト。これらの累積属性は、参考情報としてのみ使用されます。解析では、インピーダンス属性パラメーターで指定されているコスト属性のみを使用してルートを計算します。累積されるコスト属性ごとに、解析で出力されたルートに `Total_` [Impedance] プロパティが追加されます。	String
U ターンポリシー (オプション)	ジャンクションで使用される U ターンポリシーを指定します。 U ターンを許可するということは、解析においてジャンクションで方向転換し、同じ道路を引き返すことができるということを意味します。ジャンクションが道路の交差と行き止まりを表すことを前提に、さまざまな車両が、一部のジャンクションでは方向転換でき、他のジャンクションでは方向転換できない、というように設定できます。これは、ジャンクションが交差と行き止まりのどちらを表すかによって変わります。これに対応するには、ジャンクションに接続するエッジの数 (ジャンクションでのノードへの接続数) によって、暗黙的に U ターンポリシーを指定します。以下では、このパラメーターで選択できる値と、ジャンクションの接続におけるそれぞれの意味について示します。 U ターンポリシーをさらに正確に定義する必要がある場合、グローバルターン遅延エバリュエーターをネットワークコスト属性に追加するか、すでに存在する場合はそれを調整することを検討してください。その際、逆ターンの設定には特に注意が必要です。また、ネットワークロケーションの `CurbApproach` プロパティも設定できます。許可—任意の数の接続されたエッジを持つジャンクションで U ターンを許可します。これがデフォルト値です。許可しない—ジャンクションの接続にかかわらず、すべてのジャンクションで U ターンを禁止します。ただし、このオプションが指定されている場合でも、ネットワークロケーションでは U ターンが許可されます。同様に、個々のネットワークロケーションの `CurbApproach` プロパティで U ターンを禁止するように設定できます。行き止まりでのみ許可—1 つの隣接エッジを持つジャンクション (行き止まり) を除くすべてのジャンクションでの U ターンを禁止します。行き止まりと交差点でのみ許可—2 つの隣接するエッジが接するジャンクションでの U ターンを禁止します。ただし、交差点 (3 つ以上の隣接エッジを持つジャンクション) および行き止まり (1 つの隣接エッジを持つジャンクション) では U ターンを許可します。ネットワークには、道路セグメントの中間に無関係のジャンクションが存在する場合があります。このオプションは、これらの場所で車両が U ターンすることを防ぎます。	String
規制 (オプション)	解析中に適用される規制属性のリスト。	String
解析に階層を使用 (オプション)	解析を実行するネットワークデータセットに使用する階層属性が定義されていない場合、このパラメーターは使用されません。オン—階層属性が解析に使用されます。階層を使用すると、解析は下位ランクのエッジよりも上位ランクのエッジを優先します。階層解析は、より高速で、運転者が遠回りであっても一般道路よりも高速道路を利用する状況をシミュレートするのに使用できます。このオプションは入力ネットワークデータセットが階層属性を持つ場合のみ有効です。オフ—階層属性は解析に使用されず、ネットワークデータセットの正確なルートが出力されます。	Boolean
階層ランクの設定 (オプション)	レガシー: 10 より前のバージョンでは、このパラメーターによって、解析のためにネットワークデータセット構築時のデフォルトの階層範囲から階層範囲の変更を行うことを許可していました。バージョン 10 では、このパラメーターはサポートされていません。解析のために階層範囲を変更するには、ネットワークデータセットのデフォルトの階層範囲を更新します。	Network Analyst Hierarchy Settings
出力経路の形状 (オプション)	解析で出力されるルートフィーチャに使用される形状タイプを指定します。指定した出力形状のタイプに関係なく、常に最適なルートはユークリッド距離ではなくネットワークインピーダンスによって決定されます。これは、ルート形状のみが異なり、ネットワークの基となっているトラバースは同じであることを意味します。メジャー値を含む正確なライン形状—出力ルートはネットワークソースの正確な形状を保持します。リニアリファレンスのためのルートのメジャー値が出力に含まれます。メジャー値は、最初のストップから増加し、指定された位置に到着するまでの累積インピーダンスを記録します。メジャー値を含まない正確なライン形状—出力ルートはネットワークソースの正確な形状を保持します。直線—出力ルート形状はペアリングされたインシデントと施設を結ぶ 1 本の直線になります。ラインなし—出力ルートに形状は生成されません。	String
時刻 (オプション)	ルートの開始または終了の日時を指定します。この値の解釈は、時刻の設定をルートの開始時間に設定するか、終了時間に設定するかによって変わります。交通量ベースのインピーダンス属性を選択した場合、ここで指定した時刻での動的な交通状況に対する解決策が生成されます。日時は、「2012/05/14 10:30」のように指定できます。特定の日付を使用する代わりに、次の日付を使用して曜日を指定できます。 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 たとえば、移動を火曜日の午後 5:00 に開始するよう指定するには、パラメーター値を 1/2/1900 5:00 PM に指定します。	Date
時刻の設定 (オプション)	時刻パラメーターの値がルートの到着時間と出発時間のどちらを表すかを示します。開始時間—時刻は、施設またはインシデントからの出発時間として解釈されます。この設定が選択されている場合、時刻は、解析が指定された出発時間における最善のルートを検出できることを示しています。終了時間—時刻は、施設またはインシデントへの到着時間として解釈されます。このオプションは、時刻で指定した時間に目的地に到着するために、ある場所から出発すべき時間を知りたい場合に便利です。未使用—時刻に値がない場合、必ずこの設定を選択します。時刻に値がある場合、この設定は使用できません。	String

派生した出力

ラベル	説明	データタイプ
Network Analyst レイヤー	新しく作成されたネットワーク解析レイヤー。	Network Analyst Layer

arcpy.na.MakeClosestFacilityLayer(in_network_dataset, out_network_analysis_layer, impedance_attribute, {travel_from_to}, {default_cutoff}, {default_number_facilities_to_find}, {accumulate_attribute_name}, {UTurn_policy}, {restriction_attribute_name}, {hierarchy}, {hierarchy_settings}, {output_path_shape}, {time_of_day}, {time_of_day_usage})

名前	説明	データタイプ
in_network_dataset	最寄り施設の検出の解析が実行されるネットワークデータセット。	Network Dataset Layer
out_network_analysis_layer	作成する最寄り施設の検出ネットワーク解析レイヤーの名前。	String
impedance_attribute	解析でインピーダンスとして使用されるコスト属性。	String
travel_from_to (オプション)	施設とインシデントの間で移動する方向を指定します。このオプションを使用することで、移動する方向に基づいた一方通行規制およびさまざまなインピーダンスを考慮した、ネットワーク上のさまざまな施設の検索が可能になります。たとえば、インシデントから施設に向かった場合に要する時間が 10 分間であったとしても、施設からインシデントに向かった場合は方向が異なるために、15 分間を要する場合があります。 `TRAVEL_FROM`—移動する方向は施設からインシデントの方向です。消防署の場合、消防署 (施設) から緊急事態の場所 (インシデント) まで移動する時間が重視されるため、通常はこの設定が使用されます。 `TRAVEL_TO`—移動する方向はインシデントから施設の方向です。小売店の場合、買物客 (インシデント) が小売店に到達するまでの時間が重視されるため、通常はこの設定が使用されます。	String
default_cutoff (オプション)	指定されたインシデントに対する施設の検索を中止するデフォルトのインピーダンス値。移動方向がインシデントから施設の向きである場合にインシデントのカットオフ値を指定することによって、または移動方向が施設からインシデントの向きである場合に施設のカットオフ値を指定することによって、デフォルトをオーバーライドすることができます。	Double
default_number_facilities_to_find (オプション)	インシデントごとに検出する最寄り施設のデフォルトの数。インシデントの TargetFacilityCount プロパティの値を指定することでデフォルトをオーバーライドすることができます。	Long
accumulate_attribute_name [accumulate_attribute_name,...] (オプション)	解析中に累積されるコスト属性のリスト。これらの累積属性は、参考情報としてのみ使用されます。解析では、インピーダンス属性パラメーターで指定されているコスト属性のみを使用してルートを計算します。累積されるコスト属性ごとに、解析で出力されたルートに `Total_` [Impedance] プロパティが追加されます。	String
UTurn_policy (オプション)	ジャンクションで使用される U ターンポリシーを指定します。 U ターンを許可するということは、解析においてジャンクションで方向転換し、同じ道路を引き返すことができるということを意味します。ジャンクションが道路の交差と行き止まりを表すことを前提に、さまざまな車両が、一部のジャンクションでは方向転換でき、他のジャンクションでは方向転換できない、というように設定できます。これは、ジャンクションが交差と行き止まりのどちらを表すかによって変わります。これに対応するには、ジャンクションに接続するエッジの数 (ジャンクションでのノードへの接続数) によって、暗黙的に U ターンポリシーを指定します。以下では、このパラメーターで選択できる値と、ジャンクションの接続におけるそれぞれの意味について示します。 U ターンポリシーをさらに正確に定義する必要がある場合、グローバルターン遅延エバリュエーターをネットワークコスト属性に追加するか、すでに存在する場合はそれを調整することを検討してください。その際、逆ターンの設定には特に注意が必要です。また、ネットワークロケーションの `CurbApproach` プロパティも設定できます。 `ALLOW_UTURNS`—任意の数の接続されたエッジを持つジャンクションで U ターンを許可します。これがデフォルト値です。 `NO_UTURNS`—ジャンクションの接続にかかわらず、すべてのジャンクションで U ターンを禁止します。ただし、このオプションが指定されている場合でも、ネットワークロケーションでは U ターンが許可されます。同様に、個々のネットワークロケーションの `CurbApproach` プロパティで U ターンを禁止するように設定できます。 `ALLOW_DEAD_ENDS_ONLY`—1 つの隣接エッジを持つジャンクション (行き止まり) を除くすべてのジャンクションでの U ターンを禁止します。 `ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY`—2 つの隣接するエッジが接するジャンクションでの U ターンを禁止します。ただし、交差点 (3 つ以上の隣接エッジを持つジャンクション) および行き止まり (1 つの隣接エッジを持つジャンクション) では U ターンを許可します。ネットワークには、道路セグメントの中間に無関係のジャンクションが存在する場合があります。このオプションは、これらの場所で車両が U ターンすることを防ぎます。	String
restriction_attribute_name [restriction_attribute_name,...] (オプション)	解析中に適用される規制属性のリスト。	String
hierarchy (オプション)	解析を実行するネットワークデータセットに使用する階層属性が定義されていない場合、このパラメーターは使用されません。 `USE_HIERARCHY`—階層属性が解析に使用されます。階層を使用すると、解析は下位ランクのエッジよりも上位ランクのエッジを優先します。階層解析は、より高速で、運転者が遠回りであっても一般道路よりも高速道路を利用する状況をシミュレートするのに使用できます。このオプションは入力ネットワークデータセットが階層属性を持つ場合のみ有効です。 `NO_HIERARCHY`—階層属性は解析に使用されず、ネットワークデータセットの正確なルートが出力されます。	Boolean
hierarchy_settings (オプション)	レガシー: 10 より前のバージョンでは、このパラメーターによって、解析のためにネットワークデータセット構築時のデフォルトの階層範囲から階層範囲の変更を行うことを許可していました。バージョン 10 では、このパラメーターはサポートされていないため、空の文字列を指定する必要があります。解析のために階層範囲を変更するには、ネットワークデータセットのデフォルトの階層範囲を更新します。	Network Analyst Hierarchy Settings
output_path_shape (オプション)	解析で出力されるルートフィーチャに使用される形状タイプを指定します。指定した出力形状のタイプに関係なく、常に最適なルートはユークリッド距離ではなくネットワークインピーダンスによって決定されます。これは、ルート形状のみが異なり、ネットワークの基となっているトラバースは同じであることを意味します。 `TRUE_LINES_WITH_MEASURES`—出力ルートはネットワークソースの正確な形状を保持します。リニアリファレンスのためのルートのメジャー値が出力に含まれます。メジャー値は、最初のストップから増加し、指定された位置に到着するまでの累積インピーダンスを記録します。 `TRUE_LINES_WITHOUT_MEASURES`—出力ルートはネットワークソースの正確な形状を保持します。 `STRAIGHT_LINES`—出力ルート形状はペアリングされたインシデントと施設を結ぶ 1 本の直線になります。 `NO_LINES`—出力ルートに形状は生成されません。	String
time_of_day (オプション)	ルートの開始または終了の日時を指定します。この値の解釈は、時刻の設定をルートの開始時間に設定するか、終了時間に設定するかによって変わります。交通量ベースのインピーダンス属性を選択した場合、ここで指定した時刻での動的な交通状況に対する解決策が生成されます。日時は、「2012/05/14 10:30」のように指定できます。特定の日付を使用する代わりに、次の日付を使用して曜日を指定できます。 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 たとえば、移動を火曜日の午後 5:00 に開始するよう指定するには、パラメーター値を 1/2/1900 5:00 PM に指定します。	Date
time_of_day_usage (オプション)	時刻パラメーターの値がルートの到着時間と出発時間のどちらを表すかを示します。 `START_TIME`—時刻は、施設またはインシデントからの出発時間として解釈されます。この設定が選択されている場合、時刻は、解析が指定された出発時間における最善のルートを検出できることを示しています。 `END_TIME`—時刻は、施設またはインシデントへの到着時間として解釈されます。このオプションは、時刻で指定した時間に目的地に到着するために、ある場所から出発すべき時間を知りたい場合に便利です。 `NOT_USED`—時刻に値がない場合、必ずこの設定を選択します。時刻に値がある場合、この設定は使用できません。	String

派生した出力

名前	説明	データタイプ
output_layer	新しく作成されたネットワーク解析レイヤー。	Network Analyst Layer

コードのサンプル

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

必須パラメーターのみを使用して、ツールを実行します。

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

MakeClosestFacilityLayer の例 2 (Python ウィンドウ)

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

network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.MakeClosestFacilityLayer(network, "ClosestHospitals", "TravelTime",
                                    "TRAVEL_TO", 5 ,3, ["Meters", "TravelTime"],
                                    "ALLOW_UTURNS", ["Oneway"], "USE_HIERARCHY",
                                    "", "TRUE_LINES_WITH_MEASURES")

MakeClosestFacilityLayer の例 3 (ワークフロー)

次のスタンドアロン Python スクリプトは、MakeClosestFacilityLayer 関数を使用して店舗の場所から最寄りの倉庫を検索する方法を示しています。

# Name: MakeClosestFacilityLayer_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"
    impedance = "DriveTime"
    accumulate_attributes = ["Meters"]
    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. Apart from finding the drive
    #time to the closest warehouse, we also want to find the total distance, so
    #we will accumulate the "Meters" impedance attribute.
    result_object = arcpy.na.MakeClosestFacilityLayer(network, layer_name,
                                                   impedance, "TRAVEL_TO",
                                                   "", 1, accumulate_attributes,
                                                   "NO_UTURNS")

    #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: はい

最寄り施設の検出レイヤーの作成 (Make Closest Facility Layer) (Network Analyst ツール)

サマリー

レガシー:

使用法

パラメーター

レガシー:

派生した出力

環境

ライセンス情報

関連トピック