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

サマリー

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

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

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

使用法

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

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

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

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

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

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

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

• 入力フィーチャクラスに Long タイプの CurbApproach フィールドがある場合、このフィールドの値を使用して配置の動作を制御できます。 特に、一方通行の道路上にポイントが存在し、車両の左側または右側を指定したアプローチ制限がある場合、一方通行の道路に沿って正しい方向でそのポイントに到達できるように SideOfEdge 位置フィールドの値が更新されることがあります。 CurbApproach フィールドは必須の入力ではありませんが、これが存在し、Long タイプである場合、このフィールドが使用されます。

  行の CurbApproach フィールド値が、有効な CurbApproach ドメイン値のいずれとも一致しない場合、ポイントを配置する際にその行のフィールド値は無視され、デフォルト値 0 (車両の両側) が使用されます。

  アプローチ制限の詳細

• 入力フィーチャクラスに Long タイプの Status フィールドがある場合、このフィールドの値が更新されて各行の配置ステータスが反映されます。

  入力フィーチャクラスの Status フィールドが別の目的に使用され、このフィールドを上書きしたくない場合、このツールを実行する前にフィールドの名前を変更してください。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力フィーチャ	ネットワーク ロケーションを計算する対象となる入力フィーチャ。 ラインおよびポリゴン フィーチャは、ネットワーク ロケーション情報が 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 レイヤー	[入力フィーチャ] パラメーター値がネットワーク解析レイヤーのサブレイヤーだった場合、この派生した出力パラメーターは、サブレイヤーの親ネットワーク解析レイヤーを返します。 それ以外の場合、値は返されません。	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