ロケーション フィールドの計算 (Calculate Locations) (Network Analyst)

サマリー

ネットワーク上の入力フィーチャを検索し、ネットワーク ロケーションを説明するフィールドを入力フィーチャに追加します。 このツールは、Network Analyst ワークフローで使用される入力のネットワーク ロケーションを事前計算し、解析時の解析のパフォーマンスを改善するために使用します。 このツールは、入力の計算されたネットワーク ロケーションを入力データのフィールドに格納します。

ネットワーク上でのフィーチャの検索の詳細

ネットワーク ロケーションの事前計算の詳細

使用法

• デフォルトでは、このツールは、計算されたネットワーク ロケーションを、すべての Network Analyst ワークフローによって認識される「ネットワーク ロケーション フィールド名」を持つ一連のフィールドに格納します。 ただし、計算されたネットワーク ロケーションが格納されているフィールドの名前を変更することができます。 この場合、事前計算されたネットワーク ロケーションをワークフローで使用するときに、フィールド マッピングを使用して、デフォルト以外のロケーション フィールドを正しいネットワーク ロケーション プロパティにマッピングします。

  フィールド名を変更する唯一の理由は、異なるネットワークまたは移動モードの別々のロケーション フィールドのセットを同じフィーチャクラスに格納するためです。 それ以外の場合は、デフォルトのフィールド名を常に使用します。

  代替フィールド名は、[ソース ID フィールド]、[ソース OID フィールド]、[割合フィールド]、[エッジ サイド フィールド]、[X 座標フィールド]、[Y 座標フィールド]、[フィーチャからの距離フィールド]、[Z 座標フィールド]、および [ロケーション範囲フィールド] パラメーターを使用して指定することができます。

• このツールは、ネットワーク データセットを使用する入力のネットワーク ロケーションのみを計算します。 ネットワーク解析サービスのネットワーク ロケーションを計算することはできません。

• 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、[検索許容値]、[検索基準]、および [検索クエリ] パラメーターは、入力ネットワーク解析レイヤーに格納されているロケーション プロパティに基づいて自動的に入力されます。 ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。 そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。

  ネットワーク解析レイヤーのロケーション設定の詳細

• 入力フィーチャがネットワーク解析レイヤーのサブレイヤーであり、[検索許容値]、[検索基準]、または [検索クエリ] パラメーターの値を変更した場合、このツールを実行すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。 これらのロケーション設定をネットワーク解析レイヤーに格納することによって、解析時に実行されたすべての自動再配置が、ネットワーク ロケーションを最初に計算したときに使用したロケーション設定と同じロケーション設定を確実に使用するようになります。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力フィーチャ	ネットワーク ロケーションを計算する対象となる入力フィーチャ。 ラインおよびポリゴン フィーチャは、ネットワーク ロケーション情報が BLOB フィールドに格納されているため、ジオデータベース フィーチャクラスのみでサポートされています。	Table View
入力ネットワーク データセット (オプション)	ロケーションを計算するために使用するネットワーク データセット。 ネットワーク解析レイヤーのサブレイヤーが入力フィーチャとして使用されない限り、このパラメーターは必須です。 ネットワーク解析レイヤーのサブレイヤーが入力フィーチャとして使用される場合、このパラメーターは非表示になり、ネットワーク解析レイヤーによって参照されているネットワーク データセットに自動的に設定されます。	Network Dataset Layer
検索許容値 (オプション)	入力フィーチャをネットワークに配置する際に使用される最大検索距離。 検索許容値の外側にあるフィーチャは配置されません。 パラメーターには値と単位が含まれます。 デフォルトは 5000 メートルです。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターのデフォルト値は、入力ネットワーク解析レイヤーに格納されているロケーション プロパティに基づいて決定されます。 ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。 そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。 デフォルト以外の値をこのパラメーターに設定すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。	Linear Unit
検索基準 (オプション)	入力をネットワークに配置するときに検索されるネットワーク データセット内のエッジおよびジャンクション ソース。 たとえば、ネットワーク データセットが道路と歩道を表す個別のフィーチャクラスを参照する場合、入力を道路上に配置できますが、歩道上に配置できません。 各ネットワーク ソースに使用できるスナップ タイプ オプションは、次のとおりです。 [なし] - 該当するネットワーク ソース内にあるエレメントにポイントが配置されません。 [シェープ] - 該当するネットワーク ソース内にあるエレメントの最近接点にポイントが配置されます。 [中間点] -このオプションは非推奨であり、[シェープ] と同じように動作します。 [端点] -このオプションは非推奨であり、[シェープ] と同じように動作します。 デフォルト値は、[ネットワークのディゾルブ (Dissolve Network)] ツールを実行して作成されたオーバーライド ジャンクションとシステム ジャンクションを除く、すべてのネットワーク ソースで検索することです。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターのデフォルト値は、入力ネットワーク解析レイヤーに格納されているロケーション プロパティに基づいて決定されます。 ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。 そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。 デフォルト以外の値をこのパラメーターに設定すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。	Value Table
すべてのクラスの最近接を検索 (オプション)	レガシー: このパラメーターは非推奨であり、下位互換性のみのために維持されています。 MATCH_TO_CLOSEST または True のパラメーター値に対応する、検索に使用されるすべてのソースのうちの最寄りのネットワーク ソースが、常に入力と照合されます。	Boolean
ソース ID フィールド (オプション)	作成または更新されるフィールドの名前。このフィールドには、入力フィーチャの計算済みネットワーク ロケーションのネットワーク データセットのソース フィーチャクラスの ID が入力されます。 デフォルト値は SourceID です。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
ソース OID フィールド (オプション)	作成または更新されるフィールドの名前。このフィールドには、入力フィーチャの計算済みネットワーク ロケーションのネットワーク データセットのソース フィーチャクラスの ObjectID フィールドの値が入力されます。 デフォルト値は SourceOID です。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
割合フィールド (オプション)	作成または更新されるフィールドの名前。このフィールドは、ネットワーク ロケーションが検索されたネットワーク エレメントとともに、計算されたネットワーク ロケーションの割合を表します。 デフォルト値は PosAlong です。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
エッジ サイド フィールド (オプション)	作成または更新されるフィールドの名前。このフィールドは、計算されたネットワーク ロケーションがネットワーク エッジのどちら側に位置しているかを表します。 デフォルト値は SideOfEdge です。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
X 座標フィールド (オプション)	計算されたネットワーク ロケーションの X 座標を作成または更新されるフィールドの名前。 デフォルト値は SnapX です。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
Y 座標フィールド (オプション)	計算されたネットワーク ロケーションの Y 座標を作成または更新されるフィールドの名前。 デフォルト値は SnapY です。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
フィーチャからの距離フィールド (オプション)	作成または更新されるフィールドの名前。このフィールドは、計算されたネットワーク ロケーションからの元のポイント フィーチャの距離をメートル単位で表します。 デフォルト値は DistanceToNetworkInMeters です。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
Z 座標フィールド (オプション)	計算されたネットワーク ロケーションの Z 座標を作成または更新されるフィールドの名前。 デフォルト値は SnapZ です。 このパラメーターは、入力ネットワーク データセットがネットワーク ソースの Z 座標値に基づいた接続性をサポートしている場合にのみ使用されます。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
ロケーション範囲フィールド (オプション)	ラインまたはポリゴン フィーチャの計算されたネットワーク ロケーションにおけるロケーション範囲を作成または更新されるフィールドの名前。 デフォルト値は Locations です。 このパラメーターは、ラインまたはポリゴン フィーチャのロケーションを計算する場合にのみ使用されます。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
ネットワークの制限部分を除外 (オプション)	レガシー: このパラメーターは非推奨であり、下位互換性のみのために維持されています。 解析の入力は、EXCLUDE または True のパラメーター値に対応する、制限されたネットワーク エレメントには配置されません。	Boolean
検索クエリ (オプション)	検索をソース フィーチャクラス内のフィーチャのサブセットに制限するクエリ。 この機能は、ネットワーク ロケーションとして適切でないフィーチャを検索したくない場合に有用です。 たとえば、高速道路のランプに配置したくない場合は、高速道路のランプを除外するクエリを定義できます。 ネットワーク データセットのエッジまたはジャンクション ソース フィーチャクラスごとに個別の SQL 式を指定できます。 [ジオプロセシング] ウィンドウで明示的に指定されていないネットワーク ソースには、クエリは適用されません。 デフォルトでは、ソースにクエリは使用されません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターのデフォルト値は、入力ネットワーク解析レイヤーに格納されているロケーション プロパティに基づいて決定されます。 ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。 そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。 デフォルト以外の値をこのパラメーターに設定すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。	Value Table
移動モード (オプション)	使用する「移動モード」の名前。 移動モードを選択した場合、ネットワーク ロケーションの計算時に、規制やインピーダンス属性などの移動モード設定が考慮されます。 たとえば、選択した移動モードが適用されるときに、入力ポイントの 1 つに最も近いネットワーク エッジが規制されている場合、このツールは、規制されていない次に近いネットワーク エッジ上のポイントを検索します。 利用可能な移動モードは、[入力解析ネットワーク] パラメーター値によって異なります。 ネットワーク解析レイヤーのサブレイヤーが入力フィーチャとして使用される場合、このパラメーターは非表示になり、使用できません。 ネットワーク ロケーションが計算されるときに、ネットワーク解析レイヤーの現在の移動モードが自動的に使用されます。	String

派生した出力

ラベル	説明	データ タイプ
更新された入力フィーチャ	更新された入力フィーチャ。	Table View
ネットワーク解析レイヤー	[入力フィーチャ] パラメーター値がネットワーク解析レイヤーのサブレイヤーだった場合、この派生した出力パラメーターは、サブレイヤーの親ネットワーク解析レイヤーを返します。 それ以外の場合、値は返されません。	Network Analyst Layer

Python

arcpy.na.CalculateLocations(in_point_features, {in_network_dataset}, {search_tolerance}, {search_criteria}, {match_type}, {source_ID_field}, {source_OID_field}, {position_field}, {side_field}, {snap_X_field}, {snap_Y_field}, {distance_field}, {snap_Z_field}, {location_field}, {exclude_restricted_elements}, {search_query}, {travel_mode})

名前	説明	データ タイプ
in_point_features	ネットワーク ロケーションを計算する対象となる入力フィーチャ。 ラインおよびポリゴン フィーチャは、ネットワーク ロケーション情報が BLOB フィールドに格納されているため、ジオデータベース フィーチャクラスのみでサポートされています。	Table View
in_network_dataset (オプション)	ロケーションを計算するために使用するネットワーク データセット。 ネットワーク解析レイヤーのサブレイヤーが入力フィーチャとして使用されない限り、このパラメーターは必須です。 ネットワーク解析レイヤーのサブレイヤーが入力フィーチャとして使用される場合、このパラメーターの値を指定せず、ネットワーク解析レイヤーによって参照されているネットワーク データセットにも設定しないでください。	Network Dataset Layer
search_tolerance (オプション)	入力フィーチャをネットワークに配置する際に使用される最大検索距離。 検索許容値の外側にあるフィーチャは配置されません。 パラメーターには値と単位が含まれます。 デフォルトは 5000 メートルです。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターのデフォルト値は、入力ネットワーク解析レイヤーに格納されているロケーション プロパティに基づいて決定されます。 ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。 そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。 デフォルト以外の値をこのパラメーターに設定すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。	Linear Unit
search_criteria [[Source, SnapType],...] (オプション)	入力をネットワークに配置するときに検索されるネットワーク データセット内のエッジおよびジャンクション ソース。 たとえば、ネットワーク データセットが道路と歩道を表す個別のフィーチャクラスを参照する場合、入力を道路上に配置できますが、歩道上に配置できません。 パラメーター値は、ネストされたリストとともにリストとして指定されます。 ネストしたリストは各ネットワーク ソースの名前とスナップ タイプを示す 2 つの値で構成されます。 各ネットワーク ソースに使用できるスナップ タイプ オプションは、次のとおりです。 NONE - 該当するネットワーク ソース内にあるエレメントにポイントが配置されません。 SHAPE - 該当するネットワーク ソース内にあるエレメントの最近接点にポイントが配置されます。 たとえば、[["Streets","SHAPE"],["Streets_ND_Junctions","NONE"]] のパラメーター値は、Streets_ND_Junctions ソースでなく Streets ソースの形状に基づいた検索が可能であることを示します。 このリストに入っていないネットワークのエッジまたはジャンクション ソースでは、デフォルト スナップ タイプが使用されます。 すべてのネットワーク ソースをリストに入れ、ネットワーク ソースごとにスナップ タイプを明示的に設定することをお勧めします。 レガシー: これまで、このツールは、スナップ タイプ オプション MIDDLE、END、および MIDDLE_END をサポートしていました。 これらのオプションは非推奨であり、下位互換性のみのために維持されています。 これらのオプションのいずれかを指定した場合、このツールは、そのネットワーク ソースの SHAPE オプションに戻します。 デフォルト値は、[ネットワークのディゾルブ (Dissolve Network)] ツールを実行して作成されたオーバーライド ジャンクションとシステム ジャンクションを除く、すべてのネットワーク ソースで検索することです。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターのデフォルト値は、入力ネットワーク解析レイヤーに格納されているロケーション プロパティに基づいて決定されます。 ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。 そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。 デフォルト以外の値をこのパラメーターに設定すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。	Value Table
match_type (オプション)	レガシー: このパラメーターは非推奨であり、下位互換性のみのために維持されています。 MATCH_TO_CLOSEST または True のパラメーター値に対応する、検索に使用されるすべてのソースのうちの最寄りのネットワーク ソースが、常に入力と照合されます。	Boolean
source_ID_field (オプション)	作成または更新されるフィールドの名前。このフィールドには、入力フィーチャの計算済みネットワーク ロケーションのネットワーク データセットのソース フィーチャクラスの ID が入力されます。 デフォルト値は SourceID です。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
source_OID_field (オプション)	作成または更新されるフィールドの名前。このフィールドには、入力フィーチャの計算済みネットワーク ロケーションのネットワーク データセットのソース フィーチャクラスの ObjectID フィールドの値が入力されます。 デフォルト値は SourceOID です。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
position_field (オプション)	作成または更新されるフィールドの名前。このフィールドは、ネットワーク ロケーションが検索されたネットワーク エレメントとともに、計算されたネットワーク ロケーションの割合を表します。 デフォルト値は PosAlong です。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
side_field (オプション)	作成または更新されるフィールドの名前。このフィールドは、計算されたネットワーク ロケーションがネットワーク エッジのどちら側に位置しているかを表します。 デフォルト値は SideOfEdge です。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
snap_X_field (オプション)	計算されたネットワーク ロケーションの X 座標を作成または更新されるフィールドの名前。 デフォルト値は SnapX です。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
snap_Y_field (オプション)	計算されたネットワーク ロケーションの Y 座標を作成または更新されるフィールドの名前。 デフォルト値は SnapY です。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
distance_field (オプション)	作成または更新されるフィールドの名前。このフィールドは、計算されたネットワーク ロケーションからの元のポイント フィーチャの距離をメートル単位で表します。 デフォルト値は DistanceToNetworkInMeters です。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
snap_Z_field (オプション)	計算されたネットワーク ロケーションの Z 座標を作成または更新されるフィールドの名前。 デフォルト値は SnapZ です。 このパラメーターは、入力ネットワーク データセットがネットワーク ソースの Z 座標値に基づいた接続性をサポートしている場合にのみ使用されます。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメーターは使用しません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
location_field (オプション)	ラインまたはポリゴン フィーチャの計算されたネットワーク ロケーションにおけるロケーション範囲を作成または更新されるフィールドの名前。 デフォルト値は Locations です。 このパラメーターは、ラインまたはポリゴン フィーチャのロケーションを計算する場合にのみ使用されます。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターを使用しないでください。 サブレイヤー内のネットワーク ロケーションは、デフォルト名を持つロケーション フィールドに格納される必要があります。そうしないと、レイヤーが解析されるときに、それらのネットワーク ロケーションは使用されません。	Field
exclude_restricted_elements (オプション)	レガシー: このパラメーターは非推奨であり、下位互換性のみのために維持されています。 解析の入力は、EXCLUDE または True のパラメーター値に対応する、制限されたネットワーク エレメントには配置されません。	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 リファレンス」をご参照ください。 デフォルトでは、ソースにクエリは使用されません。 入力フィーチャがネットワーク解析レイヤーのサブレイヤーである場合、このパラメーターのデフォルト値は、入力ネットワーク解析レイヤーに格納されているロケーション プロパティに基づいて決定されます。 ネットワーク解析レイヤーが、選択されたサブレイヤーのロケーション設定のオーバーライドを含んでいる場合、それらの設定が使用されます。 そうでない場合、ネットワーク解析レイヤーのデフォルトのロケーション設定が使用されます。 デフォルト以外の値をこのパラメーターに設定すると、選択されたサブレイヤーのネットワーク解析レイヤーのロケーション設定のオーバーライドが更新されます。	Value Table
travel_mode (オプション)	使用する「移動モード」の名前。 移動モードを選択した場合、ネットワーク ロケーションの計算時に、規制やインピーダンス属性などの移動モード設定が考慮されます。 たとえば、選択した移動モードが適用されるときに、入力ポイントの 1 つに最も近いネットワーク エッジが規制されている場合、このツールは、規制されていない次に近いネットワーク エッジ上のポイントを検索します。 利用可能な移動モードは、in_network_dataset パラメーター値によって異なります。 arcpy.na.TravelMode オブジェクトおよび移動モードの有効な JSON 表現を含む文字列もパラメーターの入力として使用できます。 ネットワーク解析レイヤーのサブレイヤーが入力フィーチャとして使用される場合、このパラメーターの値を設定しないでください。 ネットワーク ロケーションが計算されるときに、ネットワーク解析レイヤーの現在の移動モードが自動的に使用されます。	String

派生した出力

名前	説明	データ タイプ
out_point_feature_class	更新された入力フィーチャ。	Table View
output_layer	in_point_features パラメーター値がネットワーク解析レイヤーのサブレイヤーだった場合、この派生した出力パラメーターは、サブレイヤーの親ネットワーク解析レイヤーを返します。 それ以外の場合、値は返されません。	Network Analyst Layer

コードのサンプル

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

ポイント フィーチャのロケーション フィールドを計算します。

stores = "C:/Data/SanFrancisco.gdb/Analysis/Hospitals/Analysis/Stores"
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.CalculateLocations(stores, network, "5000 Meters",
                            [["Streets", "SHAPE"],
                            ["Streets_ND_Junctions", "NONE"]])

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

以下のサンプル コードは、CalculateLocations 関数を使用したネットワーク ロケーションの事前計算と、arcpy.nax ワークフローでのそれらの事前計算されたネットワーク ロケーションの使用を示します。

解析の入力が読み込まれるときに事前計算されたネットワーク ロケーション フィールドが必ず使用されるように、fieldMappings メソッドの use_location_fields パラメーターは、True に設定されます。 さらに、結果が有効かつ一貫していることを保証するために、到達圏解析で使用されたのと同じネットワーク データセット、移動モード、およびロケーション設定を使用してネットワーク ロケーション フィールドが計算されます。

"""Precalculate network locations with the Calculate Locations
geoprocessing tool, then run a Service Area workflow using
the arcpy.nax solver object. Map the precalculated network
locations using fieldMappings and load.
"""
import arcpy

arcpy.CheckOutExtension("network")

network = "C:/Data/Paris.gdb/Transportation/ParisMultimodal_ND"
input_facilities = "C:/Data/Paris.gdb/Analysis/Stores"
travel_mode = "Driving Time"

# Make a network dataset layer
nd_layer = arcpy.nax.MakeNetworkDatasetLayer(network).getOutput(0)

# Run Calculate Locations to calculate the network locations of
# the points in the input feature class. Use the same network,
# travel mode, and locate settings that will be used in the
# network analysis.
# Set a search_tolerance of 500 meters.
# Use search_criteria to locate only on streets and metro entrances.
# Use search_query to prevent locating on highways (FUNC_CLASS 1)
arcpy.nax.CalculateLocations(
    input_facilities,
    nd_layer,
    search_tolerance="500 Meters",
    search_criteria=[
        ["Streets", "SHAPE"],
        ["Metro_Lines", "NONE"],
        ["Transfer_Stations", "NONE"],
        ["Transfer_Street_Station", "NONE"],
        ["Metro_Entrances", "SHAPE"],
        ["Metro_Stations", "NONE"],
        ["ParisMultimodal_ND_Junctions", "NONE"]
    ],
    search_query=[["Streets", "FUNC_CLASS <> '1'"]],
    travel_mode=travel_mode
)

# Initialize the Service Area solver object
service_area = arcpy.nax.ServiceArea(nd_layer)

# Set the analysis properties. Use the same travel mode and
# locate settings that were used when precalculating the
# network locations
service_area.travelMode = travel_mode
service_area.searchTolerance = 500
service_area.searchToleranceUnits = arcpy.nax.DistanceUnits.Meters
service_area.searchSources = [
    ["Streets", "FUNC_CLASS <> '1'"],
    ["Metro_Entrances", "SHAPE"]
]
service_area.defaultImpedanceCutoffs = [5, 10]

# Construct a field mapping object with network location fields
field_mappings = service_area.fieldMappings(
    arcpy.nax.ServiceAreaInputDataType.Facilities,
    use_location_fields=True
)

# Load the input data using the field mappings
# Location fields are included automatically because
# of the field mappings.
service_area.load(
    arcpy.nax.ServiceAreaInputDataType.Facilities,
    input_facilities,
    field_mappings
)

# Solve the analysis
result = service_area.solve()
print(result.solveSucceeded)

# ...analysis of the results continues...

環境

現在のワークスペース

ライセンス情報

• Basic: Yes
• Standard: Yes
• Advanced: Yes