ロケーションの追加 (Add Locations) (Network Analyst ツール)

サマリー

ネットワーク解析レイヤーに入力フィーチャやレコードを追加します。これらの入力は、ストップやバリアなどの特定のサブレイヤーに追加されます。ネットワーク解析レイヤーが、ネットワークデータセットをネットワークデータソースとして参照する場合、事前に計算されたネットワークロケーションフィールドが入力からマッピングされない限り、このツールは、入力のネットワークロケーションを計算します。

ロケーションの追加 ツールがネットワーク上の解析の入力を検索する方法の詳細

使用法

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

ネットワーク解析レイヤーのワークフローの詳細
入力の配置時に、ネットワーク解析レイヤーの移動モードと既存のバリアが考慮されます。このため、他の解析の入力を読み込む前に、解析の移動モードの設定とバリアの読み込みを行っておくことをおすすめします。
検索許容値、検索基準、および 検索クエリー パラメーターの値は、入力ネットワーク解析レイヤーに格納されているロケーションプロパティに基づいて自動的に入力されます。ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。

ネットワーク解析レイヤーのロケーション設定の詳細
検索許容値、検索基準、または 検索クエリー パラメーターの値を変更した場合、このツールを実行すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。これらのロケーション設定をネットワーク解析レイヤーに格納することによって、解析時に実行されたすべての自動再配置が、ネットワークロケーションを最初に計算したときに使用したロケーション設定と同じロケーション設定に確実に従うようになります。
解析レイヤーがポータルサービスを参照する場合、ロケーションフィールドは、解析を実行するまでは計算されません。これらのレイヤーの場合、ロケーションの追加 ツールは、ロケーションフィールドを計算せずに、解析レイヤーに入力をアペンドします。このため、一部のツールパラメーターはこれらのレイヤーに適用されず、ジオプロセシング ウィンドウで非表示になるか、Python で無視されます。
このツールは Python スクリプトで使用できますが、Python でネットワーク解析を実行する際に推奨されるベストプラクティスは、代わりに arcpy.nax モジュールの解析クラスを使用することです。

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

ラベル	説明	データタイプ
入力ネットワーク解析レイヤー	ネットワーク解析オブジェクトが追加されるネットワーク解析レイヤー。	Network Analyst Layer
サブレイヤー	ネットワーク解析オブジェクトが追加されるネットワーク解析レイヤーのサブレイヤーの名前。	String
入力ロケーション	ネットワーク解析サブレイヤーに追加されるロケーションを含むフィーチャクラスまたはテーブル。	Table View
フィールドマッピング (オプション)	位置が追加されるネットワーク解析サブレイヤーの入力フィールドと、入力データまたは指定された定数内のフィールドとの間のマッピング。ネットワーク解析レイヤーの入力サブレイヤーには、解析動作を変更または制御するために入力できる一連の入力フィールドがあります。サブレイヤーに位置を追加すると、このパラメーターを使用して、入力テーブルのフィールド値をサブレイヤー内のそれらのフィールドにマッピングできます。フィールドマッピングを使用して、プロパティごとにデフォルトの定数値を指定することもできます。フィールドもデフォルト値もプロパティに設定されていない場合、作成されたネットワーク解析オブジェクトではこのプロパティに NULL 値が設定されます。各ネットワーク解析レイヤーのサブレイヤーごとの入力フィールドの完全なリストは、各レイヤーのドキュメントに記載されています。たとえば、ルートレイヤーのストップサブレイヤーの入力フィールドを調べます。読み込まれるデータに、解析に使用するネットワークデータセットおよび移動モードに基づく事前に計算されたネットワークロケーションまたはロケーション範囲が含まれている場合は、ドロップダウンメニューからネットワークロケーションフィールドの使用オプションを選択します。ネットワークロケーションフィールドを使用したネットワーク解析オブジェクトの追加は、ジオメトリーによる読み込みより高速です。ネットワークロケーションフィールドの詳細注意: ArcGIS Online および一部の ArcGIS Enterprise ポータルは、ネットワークロケーションフィールドの使用をサポートしていません。これらのポータルのいずれかをネットワークデータソースとして使用するネットワーク解析レイヤーの場合、すべての入力が解析時に配置され、マッピングされたロケーションフィールドが無視されます。	Network Analyst Class FieldMap
検索許容値 (オプション)	入力フィーチャをネットワークに配置する際に使用される最大検索距離。検索許容値の外側にあるフィーチャは配置されません。パラメーターには値と単位が含まれます。このパラメーターのデフォルト値は、入力ネットワーク解析レイヤーに格納されているロケーションプロパティに基づいて決定されます。ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。デフォルト以外の値をこのパラメーターに設定すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。ラインバリアやポリゴンバリアなど、ラインまたはポリゴンジオメトリーを含むサブレイヤーに場所を追加する場合、このパラメーターは使用しません。既存のネットワークロケーションフィールドを使用して位置を追加する場合、このパラメーターは使用されません。レガシー: ネットワーク解析レイヤーのネットワークデータソースが、11.0 より前のバージョンの ArcGIS Enterprise を実行しているポータルの場合、このパラメーターは使用されません。	Linear Unit
並べ替えフィールド (オプション)	ネットワーク解析オブジェクトをネットワーク解析レイヤーに追加する際に、ネットワーク解析オブジェクトをソートする基準となるフィールド。デフォルトは入力フィーチャクラスまたはテーブルの `ObjectID` フィールドです。	Field
検索基準 (オプション)	入力をネットワークに配置するときに検索されるネットワークデータセット内のエッジおよびジャンクションソース。たとえば、ネットワークデータセットが道路と歩道を表す個別のフィーチャクラスを参照する場合、入力を道路上に配置できますが、歩道上に配置できません。注意: 廃棄物収集解析の場合、ジャンクション上にストップが配置されると解析処理は失敗します。廃棄物収集解析レイヤーにストップを追加する際には、ジャンクションソースへの配置を許可するようにこのパラメーターを構成しないでください。このパラメーターのデフォルト値は、入力ネットワーク解析レイヤーに格納されているロケーションプロパティに基づいて決定されます。ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。デフォルト以外の値をこのパラメーターに設定すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。既存のネットワークロケーションフィールドを使用して位置を追加する場合、このパラメーターは使用されません。ネットワーク解析レイヤーのネットワークデータソースが ArcGIS Online の場合、このパラメーターは使用されません。レガシー: ネットワーク解析レイヤーのネットワークデータソースが、11.0 より前のバージョンの ArcGIS Enterprise を実行しているポータルの場合、このパラメーターは使用されません。値テーブル列: Source—The edge and junction sources in the network dataset. Snap Type—Specifies the snap type options for each network source. None—The point will not locate on elements in this network source. Shape—The point will locate on the closest point of an element in this network source. Middle—This option is deprecated and behaves the same as Shape. End—This option is deprecated and behaves the same as Shape.	Value Table
すべてのクラスの最近接を検索 (オプション)	レガシー: このパラメーターは非推奨であり、後方互換性のみのために維持されています。 `MATCH_TO_CLOSEST` または `True` のパラメーター値に対応する、検索に使用されるすべてのソースのうちの最寄りのネットワークソースが、常に入力と照合されます。オン—検索に使用されるすべてのソースのうちの最寄りのネットワークソースが、入力と照合されます。オフ—このオプションは非推奨であり、後方互換性のみのために維持されています。検索に使用されるすべてのソースのうちの最寄りのネットワークソースが、入力と照合されます。	Boolean
既存のロケーションにアペンド (オプション)	新しいネットワーク解析オブジェクトを既存のオブジェクトにアペンドするかどうかを指定します。オン—選択されたサブレイヤー内に存在する一連のオブジェクトに新しいネットワーク解析オブジェクトがアペンドされます。これがデフォルトです。オフ—既存のネットワーク解析オブジェクトが削除され、新しいオブジェクトに置き換えられます。	Boolean
ネットワークへスナップ (オプション)	入力内容を計算済みのネットワークロケーションにスナップするか、元の地理的位置に表示するかを指定します。解析でアプローチ制限を使用して、ロケーションにアプローチするために車両が道路のどちら側を走行する必要があるかを制御する場合は、入力内容をネットワークロケーションにスナップしないか、スナップオフセットを使用して、道路の片側にポイントがはっきりと表示されたままになるようにします。ラインバリアやポリゴンバリアなど、ラインまたはポリゴンジオメトリーを含むサブレイヤーに場所を追加する場合、このパラメーターは使用しません。入力ネットワーク解析レイヤーのネットワークデータソースがポータルサービスの場合、このパラメーターは使用されません。オン—ネットワークロケーションのジオメトリーがそのネットワークロケーションにスナップされます。オフ—ネットワークロケーションのジオメトリーが入力フィーチャのジオメトリーに基づきます。これがデフォルトです。	Boolean
スナップオフセット (オプション)	ポイントをネットワークにスナップする際に適用されるオフセット距離。オフセット距離がゼロだと、ポイントはネットワークフィーチャ (一般的にライン) と一致します。ネットワークフィーチャからポイントをオフセットする場合、オフセット距離を入力します。オフセットは、元のポイントの場所に関連しています。つまり、元のポイントが左側にあった場合、新しい場所は左にオフセットされます。元のポイントが右側にあれば、新しいロケーションも右側にオフセットされます。デフォルトは 5 メートルです。ただし、ネットワークへスナップがオフの場合、このパラメーターは無視されます。ラインバリアやポリゴンバリアなど、ラインまたはポリゴンジオメトリーを含むサブレイヤーに場所を追加する場合、このパラメーターは使用しません。入力ネットワーク解析レイヤーのネットワークデータソースがポータルサービスの場合、このパラメーターは使用されません。	Linear Unit
ネットワークの制限部分を除外 (オプション)	レガシー: このパラメーターは非推奨であり、後方互換性のみのために維持されています。解析の入力は、`EXCLUDE` または `True` のパラメーター値に対応する、制限されたネットワークエレメントには配置されません。オン—解析の入力は、制限されたネットワークエレメントには配置されません。オフ—このオプションは非推奨であり、後方互換性のみのために維持されています。解析の入力は、制限されたネットワークエレメントには配置されません。	Boolean
検索クエリー (オプション)	検索をソースフィーチャクラス内のフィーチャのサブセットに制限するクエリー。この機能は、ネットワークロケーションとして適切でないフィーチャを検索したくない場合に有用です。たとえば、高速道路のランプに配置したくない場合は、高速道路のランプを除外するクエリーを定義できます。ネットワークデータセットのエッジまたはジャンクションソースフィーチャクラスごとに個別の SQL 式を指定できます。ジオプロセシングウィンドウで明示的に指定されていないネットワークソースには、クエリーは適用されません。このパラメーターのデフォルト値は、入力ネットワーク解析レイヤーに格納されているロケーションプロパティに基づいて決定されます。ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。デフォルト以外の値をこのパラメーターに設定すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。既存のネットワークロケーションフィールドを使用して位置を追加する場合、このパラメーターは使用されません。ネットワーク解析レイヤーのネットワークデータソースが ArcGIS Online の場合、このパラメーターは使用されません。レガシー: ネットワーク解析レイヤーのネットワークデータソースが、11.0 より前のバージョンの ArcGIS Enterprise を実行しているポータルの場合、このパラメーターは使用されません。値テーブル列: Name—The edge and junction sources in the network dataset. Query—The query for each network source.	Value Table
解析時の自動再配置を許可 (オプション)	解析で有効かつルート検索可能なロケーションフィールドを保証するために、既存のネットワークロケーションフィールドを含む入力を解析時に自動的に再配置できるかどうかを指定します。このパラメーターのデフォルト値は、入力ネットワーク解析レイヤーに格納されているロケーションプロパティに基づいて決定されます。ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。デフォルト以外の値をこのパラメーターに設定すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。解析時の自動再配置が許可されない場合でも、ロケーションフィールドを含まないか、不完全なロケーションフィールドを含む入力が解析時に配置されます。ネットワーク解析レイヤーのネットワークデータソースが ArcGIS Online の場合、このパラメーターは使用されません。入力ネットワーク解析レイヤーのネットワークデータソースが、ネットワークロケーションフィールドの使用をサポートしていない ArcGIS Enterprise ポータルの場合、このパラメーターは使用されません。レガシー: ネットワーク解析レイヤーのネットワークデータソースが、11.0 より前のバージョンの ArcGIS Enterprise を実行しているポータルの場合、このパラメーターは使用されません。オン—制限されたネットワークエレメント上にあるポイントおよびバリアの影響を受けるポイントが、解析時に最も近いルート検索可能な位置に再配置されます。これがデフォルトです。オフ—ポイントに到達できない場合でも、解析時にネットワークロケーションフィールドがそのまま使用されます。ポイントに到達できない場合、解析が失敗することがあります。	Boolean

派生した出力

ラベル	説明	データタイプ
更新された入力ネットワーク解析レイヤー	更新されたネットワーク解析レイヤー。	Network Analyst Layer

arcpy.na.AddLocations(in_network_analysis_layer, sub_layer, in_table, {field_mappings}, {search_tolerance}, {sort_field}, {search_criteria}, {match_type}, {append}, {snap_to_position_along_network}, {snap_offset}, {exclude_restricted_elements}, {search_query}, {allow_auto_relocate})

名前	説明	データタイプ
in_network_analysis_layer	ネットワーク解析オブジェクトが追加されるネットワーク解析レイヤー。	Network Analyst Layer
sub_layer	ネットワーク解析オブジェクトが追加されるネットワーク解析レイヤーのサブレイヤーの名前。	String
in_table	ネットワーク解析サブレイヤーに追加されるロケーションを含むフィーチャクラスまたはテーブル。	Table View
field_mappings (オプション)	位置が追加されるネットワーク解析サブレイヤーの入力フィールドと、入力データまたは指定された定数内のフィールドとの間のマッピング。ネットワーク解析レイヤーの入力サブレイヤーには、解析動作を変更または制御するために入力できる一連の入力フィールドがあります。サブレイヤーに位置を追加すると、このパラメーターを使用して、入力テーブルのフィールド値をサブレイヤー内のそれらのフィールドにマッピングできます。フィールドマッピングを使用して、プロパティごとにデフォルトの定数値を指定することもできます。フィールドもデフォルト値もプロパティに設定されていない場合、作成されたネットワーク解析オブジェクトではこのプロパティに NULL 値が設定されます。各ネットワーク解析レイヤーのサブレイヤーごとの入力フィールドの完全なリストは、各レイヤーのドキュメントに記載されています。たとえば、ルートレイヤーのストップサブレイヤーの入力フィールドを調べます。パラメーター値を指定するために、`NAClassFieldMappings` クラスから取得された `NAClassFieldMappings` オブジェクトを使用します。 `NAClassFieldMappings` オブジェクトは `NAClassFieldMap` オブジェクトのコレクションで、これを使用すると、ネットワーク解析オブジェクトのプロパティに対して、デフォルト値を指定したり、入力フィーチャからフィールド名をマップしたりできます。読み込まれるデータに、解析に使用するネットワークデータセットに基づくネットワークロケーションまたはネットワークロケーション範囲属性がある場合、入力フィーチャのネットワークロケーションフィールドをネットワークロケーションプロパティに割り当てます。フィールドマッピングでネットワークロケーションフィールドを指定することは、ツールダイアログボックスでネットワークロケーションフィールドの使用オプションを使用するのと同様です。ネットワークロケーションフィールドの詳細注意: ArcGIS Online および一部の ArcGIS Enterprise ポータルは、ネットワークロケーションフィールドの使用をサポートしていません。これらのポータルのいずれかをネットワークデータソースとして使用するネットワーク解析レイヤーの場合、すべての入力が解析時に配置され、マッピングされたロケーションフィールドが無視されます。	Network Analyst Class FieldMap
search_tolerance (オプション)	入力フィーチャをネットワークに配置する際に使用される最大検索距離。検索許容値の外側にあるフィーチャは配置されません。パラメーターには値と単位が含まれます。このパラメーターのデフォルト値は、入力ネットワーク解析レイヤーに格納されているロケーションプロパティに基づいて決定されます。ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。デフォルト以外の値をこのパラメーターに設定すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。ラインバリアやポリゴンバリアなど、ラインまたはポリゴンジオメトリーを含むサブレイヤーに場所を追加する場合、このパラメーターは使用しません。既存のネットワークロケーションフィールドを使用して位置を追加する場合、このパラメーターは使用されません。レガシー: ネットワーク解析レイヤーのネットワークデータソースが、11.0 より前のバージョンの ArcGIS Enterprise を実行しているポータルの場合、このパラメーターは使用されません。	Linear Unit
sort_field (オプション)	ネットワーク解析オブジェクトをネットワーク解析レイヤーに追加する際に、ネットワーク解析オブジェクトをソートする基準となるフィールド。デフォルトは入力フィーチャクラスまたはテーブルの `ObjectID` フィールドです。	Field
search_criteria [[Source, SnapType],...] (オプション)	入力をネットワークに配置するときに検索されるネットワークデータセット内のエッジおよびジャンクションソース。たとえば、ネットワークデータセットが道路と歩道を表す個別のフィーチャクラスを参照する場合、入力を道路上に配置できますが、歩道上に配置できません。パラメーター値は、ネストされたリストとともにリストとして指定されます。ネストしたリストは各ネットワークソースの名前とスナップタイプを示す 2 つの値で構成されます。たとえば、`[["Streets","SHAPE"],["Streets_ND_Junctions","NONE"]]` のパラメーター値は、`Streets` ソースでなく `Streets_ND_Junctions` ソースの形状に基づいた検索が可能であることを示します。このリストに入っていないネットワークのエッジまたはジャンクションソースでは、デフォルトスナップタイプが使用されます。すべてのネットワークソースをリストに入れ、ネットワークソースごとにスナップタイプを明示的に設定することをおすすめします。レガシー: これまで、このツールは、スナップタイプオプション `MIDDLE`、`END`、および `MIDDLE_END` をサポートしていました。これらのオプションは非推奨であり、後方互換性のみのために維持されています。これらのオプションのいずれかを指定した場合、このツールは、そのネットワークソースの `SHAPE` オプションに戻します。注意: 廃棄物収集解析の場合、ジャンクション上にストップが配置されると解析処理は失敗します。廃棄物収集解析レイヤーにストップを追加する際には、ジャンクションソースへの配置を許可するようにこのパラメーターを構成しないでください。このパラメーターのデフォルト値は、入力ネットワーク解析レイヤーに格納されているロケーションプロパティに基づいて決定されます。ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。デフォルト以外の値をこのパラメーターに設定すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。既存のネットワークロケーションフィールドを使用して位置を追加する場合、このパラメーターは使用されません。ネットワーク解析レイヤーのネットワークデータソースが ArcGIS Online の場合、このパラメーターは使用されません。レガシー: ネットワーク解析レイヤーのネットワークデータソースが、11.0 より前のバージョンの ArcGIS Enterprise を実行しているポータルの場合、このパラメーターは使用されません。値テーブル列: `Source`—The edge and junction sources in the network dataset. `Snap Type`—Specifies the snap type options for each network source. `NONE`—The point will not locate on elements in this network source. `SHAPE`—The point will locate on the closest point of an element in this network source. `MIDDLE`—This option is deprecated and behaves the same as Shape. `END`—This option is deprecated and behaves the same as Shape.	Value Table
match_type (オプション)	レガシー: このパラメーターは非推奨であり、後方互換性のみのために維持されています。 `MATCH_TO_CLOSEST` または `True` のパラメーター値に対応する、検索に使用されるすべてのソースのうちの最寄りのネットワークソースが、常に入力と照合されます。 `MATCH_TO_CLOSEST`—検索に使用されるすべてのソースのうちの最寄りのネットワークソースが、入力と照合されます。 `PRIORITY`—このオプションは非推奨であり、後方互換性のみのために維持されています。検索に使用されるすべてのソースのうちの最寄りのネットワークソースが、入力と照合されます。	Boolean
append (オプション)	新しいネットワーク解析オブジェクトを既存のオブジェクトにアペンドするかどうかを指定します。 `APPEND`—選択されたサブレイヤー内に存在する一連のオブジェクトに新しいネットワーク解析オブジェクトがアペンドされます。これがデフォルトです。 `CLEAR`—既存のネットワーク解析オブジェクトが削除され、新しいオブジェクトに置き換えられます。	Boolean
snap_to_position_along_network (オプション)	入力内容を計算済みのネットワークロケーションにスナップするか、元の地理的位置に表示するかを指定します。解析でアプローチ制限を使用して、ロケーションにアプローチするために車両が道路のどちら側を走行する必要があるかを制御する場合は、入力内容をネットワークロケーションにスナップしないか、スナップオフセットを使用して、道路の片側にポイントがはっきりと表示されたままになるようにします。ラインバリアやポリゴンバリアなど、ラインまたはポリゴンジオメトリーを含むサブレイヤーに場所を追加する場合、このパラメーターは使用しません。入力ネットワーク解析レイヤーのネットワークデータソースがポータルサービスの場合、このパラメーターは使用されません。 `SNAP`—ネットワークロケーションのジオメトリーがそのネットワークロケーションにスナップされます。 `NO_SNAP`—ネットワークロケーションのジオメトリーが入力フィーチャのジオメトリーに基づきます。これがデフォルトです。	Boolean
snap_offset (オプション)	ポイントをネットワークにスナップする際に適用されるオフセット距離。オフセット距離がゼロだと、ポイントはネットワークフィーチャ (一般的にライン) と一致します。ネットワークフィーチャからポイントをオフセットする場合、オフセット距離を入力します。オフセットは、元のポイントの場所に関連しています。つまり、元のポイントが左側にあった場合、新しい場所は左にオフセットされます。元のポイントが右側にあれば、新しいロケーションも右側にオフセットされます。デフォルトは 5 メートルです。ただし、このパラメーターは、`snap_to_position_along_network` を `NO_SNAP` に設定すると無視されます。ラインバリアやポリゴンバリアなど、ラインまたはポリゴンジオメトリーを含むサブレイヤーに場所を追加する場合、このパラメーターは使用しません。入力ネットワーク解析レイヤーのネットワークデータソースがポータルサービスの場合、このパラメーターは使用されません。	Linear Unit
exclude_restricted_elements (オプション)	レガシー: このパラメーターは非推奨であり、後方互換性のみのために維持されています。解析の入力は、`EXCLUDE` または `True` のパラメーター値に対応する、制限されたネットワークエレメントには配置されません。 `EXCLUDE`—解析の入力は、制限されたネットワークエレメントには配置されません。 `INCLUDE`—このオプションは非推奨であり、後方互換性のみのために維持されています。解析の入力は、制限されたネットワークエレメントには配置されません。	Boolean
search_query [[Source, Expression],...] (オプション)	検索をソースフィーチャクラス内のフィーチャのサブセットに制限するクエリー。この機能は、ネットワークロケーションとして適切でないフィーチャを検索したくない場合に有用です。たとえば、高速道路のランプに配置したくない場合は、高速道路のランプを除外するクエリーを定義できます。ネットワークデータセットのエッジまたはジャンクションソースフィーチャクラスごとに個別の SQL 式を指定できます。パラメーター値は、ネットワークソースごとに 1 つのエントリーを含んでいる、ネストされたリストを含むリストとして指定されます。内部の各リストは、ネットワークソースの名前と、そのソースに対するクエリーとして使用される SQL 式を示す 2 つの値で構成されます。空の文字列 `""` は、特定のソースに対するクエリーがないことを示します。たとえば、値 `[["Streets", "ROAD_CLASS <> 3"], ["Streets_ND_Junctions", ""]]` では、`Streets` ソースフィーチャクラスに対する SQL 式を定義し、`Streets_ND_Junctions` ソースフィーチャクラスには SQL 式を定義しません。リストに含まれていないネットワークソースには、クエリーがないと解釈されます。値 `[["Streets", "ROAD_CLASS <> 3"]]` は、`[["Streets", "ROAD_CLASS <> 3"], ["Streets_ND_Junctions", ""]]` と同等です。 SQL 構文の詳細については、「ArcGIS で使用されるクエリー式の SQL リファレンス」をご参照ください。このパラメーターのデフォルト値は、入力ネットワーク解析レイヤーに格納されているロケーションプロパティに基づいて決定されます。ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。デフォルト以外の値をこのパラメーターに設定すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。既存のネットワークロケーションフィールドを使用して位置を追加する場合、このパラメーターは使用されません。ネットワーク解析レイヤーのネットワークデータソースが ArcGIS Online の場合、このパラメーターは使用されません。レガシー: ネットワーク解析レイヤーのネットワークデータソースが、11.0 より前のバージョンの ArcGIS Enterprise を実行しているポータルの場合、このパラメーターは使用されません。値テーブル列: `Name`—The edge and junction sources in the network dataset. `Query`—The query for each network source.	Value Table
allow_auto_relocate (オプション)	解析で有効かつルート検索可能なロケーションフィールドを保証するために、既存のネットワークロケーションフィールドを含む入力を解析時に自動的に再配置できるかどうかを指定します。このパラメーターのデフォルト値は、入力ネットワーク解析レイヤーに格納されているロケーションプロパティに基づいて決定されます。ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。デフォルト以外の値をこのパラメーターに設定すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。解析時の自動再配置が許可されない場合でも、ロケーションフィールドを含まないか、不完全なロケーションフィールドを含む入力が解析時に配置されます。ネットワーク解析レイヤーのネットワークデータソースが ArcGIS Online の場合、このパラメーターは使用されません。入力ネットワーク解析レイヤーのネットワークデータソースが、ネットワークロケーションフィールドの使用をサポートしていない ArcGIS Enterprise ポータルの場合、このパラメーターは使用されません。レガシー: ネットワーク解析レイヤーのネットワークデータソースが、11.0 より前のバージョンの ArcGIS Enterprise を実行しているポータルの場合、このパラメーターは使用されません。 `ALLOW`—制限されたネットワークエレメント上にあるポイントおよびバリアの影響を受けるポイントが、解析時に最も近いルート検索可能な位置に再配置されます。これがデフォルトです。 `NO_ALLOW`—ポイントに到達できない場合でも、解析時にネットワークロケーションフィールドがそのまま使用されます。ポイントに到達できない場合、解析が失敗することがあります。	Boolean

派生した出力

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

コードのサンプル

ヒント:

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

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

Python ウィンドウでツールを実行し、Route という名前のルート解析レイヤーにストップを追加します。

import arcpy
hospitals = "C:/Data/SanFrancisco.gdb/Analysis/Hospitals"
arcpy.na.AddLocations("Route", "Stops", hospitals)

AddLocations の例 2 (ワークフロー)

次のスタンドアロン Python スクリプトは、AddLocations 関数を使用して起点と終点を OD コストマトリックスレイヤーに読み込む方法を示しています。

レガシー:

GetNASublayer 関数を使用して、ネットワーク解析レイヤーのサブレイヤーを取得できます。これは ArcGIS Pro 2.7 で導入されました。以前のソフトウェアバージョンでは、サブレイヤー名をワイルドカードとして使用するネットワーク解析の Layer オブジェクトの listLayers メソッドを使用することがネットワーク解析レイヤーのサブレイヤーオブジェクトを取得する最適な方法でした。

# Name: AddLocations_Workflow.py
# Description: Calculate a travel time matrix between stores. Use the Add
#               Locations tool to load origins and destinations into an OD Cost
#               Matrix layer. Since the origins and destinations are the same in
#               this case, the origins are first loaded from the stores feature
#               class using geometry, and the destinations are loaded from the
#               origins using network location fields in order to speed up the
#               load times.
# 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 inputs and outputs
    input_gdb = "C:/Data/SanFrancisco.gdb"
    network = os.path.join(input_gdb, "Transportation", "Streets_ND")
    layer_name = "StoreTravelTimeMatrix"
    travel_mode = "Driving Time"
    stores = os.path.join(input_gdb, "Analysis", "Stores")
    search_tolerance = "500 Meters"
    search_query = [["Streets", '"FREEWAY" = 0'], ["Streets_ND_Junctions", ""]]
    output_layer_file = os.path.join(output_dir, layer_name + ".lyrx")

    # Create a new OD cost matrix analysis layer. For this scenario, the default
    # value for all the remaining parameters statisfies the analysis requirements
    result_object = arcpy.na.MakeODCostMatrixAnalysisLayer(
        network, layer_name, travel_mode
    )

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

    # Get the names of all the sublayers within the OD layer.
    sublayer_names = arcpy.na.GetNAClassNames(layer_object)
    # Store the layer names for later use
    origins_layer_name = sublayer_names["Origins"]
    destinations_layer_name = sublayer_names["Destinations"]

    # Load store features as origins using the geometry of store features.
    # Ensure that the stores are not located on freeways by using a search query.
    arcpy.na.AddLocations(
        layer_object, origins_layer_name, stores, "",
        search_tolerance, search_query=search_query
    )

    # Because we want our origins and destinations to be the same, load the
    # origins as destinations using the network locations fields. Loading using
    # existing network location fields is much faster than loading using geometry
    # because the network locations have already been calculated.
    # Create a field mappings object that supports network location fields using
    # the candidate fields from origins
    origins_sublayer = arcpy.na.GetNASublayer(layer_object, "Origins")
    candidate_fields = arcpy.ListFields(origins_sublayer)
    field_mappings = arcpy.na.NAClassFieldMappings(
        layer_object, destinations_layer_name, True, candidate_fields
    )
    arcpy.na.AddLocations(
        layer_object, destinations_layer_name, origins_sublayer, field_mappings
    )

    # Solve the od cost matrix layer. Halt the execution if there is an
    # invalid location
    arcpy.na.Solve(layer_object, "HALT")

    # Save the solved OD cost matrix 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: はい

ロケーションの追加 (Add Locations) (Network Analyst ツール)

サマリー

使用法

パラメーター

注意:

レガシー:

注意:

レガシー:

レガシー:

レガシー:

レガシー:

レガシー:

派生した出力

環境

ライセンス情報

関連トピック