空間結合 (Spatial Join) (解析)—ArcGIS Pro

サマリー

フィーチャクラスの属性を、空間リレーションシップに基づいて別のフィーチャクラスの属性に結合します。ターゲットフィーチャと、結合フィーチャの結合された属性は、出力フィーチャクラスに書き込まれます。

使用法

空間結合では、[結合フィーチャ] 値から [ターゲットフィーチャ] 値への行のマッチが、相対的な空間位置に基づいて行われます。
デフォルトでは、結合フィーチャのすべての属性がターゲットフィーチャの属性に追加され、出力フィーチャクラスにコピーされます。出力に書き込む属性は、[結合フィーチャのフィールドマップ] パラメーターで操作することで定義できます。
出力フィーチャクラスには、2 つの新しいフィールド (Join_Count および TARGET_FID) が追加されます。 Join_Count フィールドは、各ターゲットフィーチャ (TARGET_FID) にマッチする結合フィーチャの数を表します。
[結合方法] パラメーターで [1 対多の結合] が指定されている場合、もう 1 つの新しいフィールド JOIN_FID が出力に追加されます。
[結合方法] パラメーターが [1 対多の結合] である場合、各ターゲットフィーチャの出力フィーチャクラスには複数の行が存在する場合があります。 JOIN_FID フィールドを使用して、どのフィーチャがどのターゲットフィーチャ (TARGET_FID) に結合されるかを判断します。 JOIN_FID フィールドの値が -1 であれば、指定されたターゲットフィーチャとの空間リレーションシップを持つフィーチャがないことを意味します。
すべての入力ターゲットフィーチャは、次の両方の条件を満たす場合に出力フィーチャクラスに書き込まれます。
- [結合方法] が [1 対 1 の結合] に設定されている
- [すべてのターゲットフィーチャを保持する] がオンである
出力データセット内のフィールドとそれらのフィールドの内容を管理するには、[フィールドマップ] パラメーターを使用します。
- フィールドの順序を変更するには、フィールド名を選択して、新しい位置にドラッグします。
- 出力フィールドのデフォルトのデータタイプは、最初に検出した (その名前の) 入力フィールドのデータタイプと同じになります。データタイプをいつでも手動で他の任意の有効なデータタイプに変更できます。
- 使用できるマージルールは、最初、最後、結合、合計、平均、中央値、最頻値、最小、最大、標準偏差、個数です。
- [結合] マージルールを使用している場合、スペース、カンマ、ピリオド、ダッシュなど、区切り文字を指定できます。スペースを使用する場合は、入力ボックスの先頭にポインターを置き、Space キーを 1 回押してください。
- 書式設定オプションを使用して、テキストフィールドの開始位置と終了位置を指定できます。
- 1 個しかないデータの標準偏差を計算しないでください。ゼロによる除算が発生するからです。したがって、入力ソースがただ 1 つである場合には、標準偏差オプションを使用すべきではありません。
スクリプトでフィールドをマッピングする方法の詳細
[結合フィーチャのフィールドマップ] パラメーターに指定したマージルールは、複数のフィーチャがターゲットフィーチャにマッチしたときに (Join_Count > 1)、結合フィーチャの属性にだけ適用されます。たとえば、DEPTH 属性の値に 15.5、2.5、および 3.3 を持つ 3 つのフィーチャが結合され、マージルールとして [平均] が適用される場合、出力フィールドの値は 6.1 になります。結合フィーチャの NULL 値は統計計算では無視されます。たとえば、3 つのフィーチャの値が 15.5、<NULL>、および 2.5 である場合、[平均] は 9.0、[個数] は 2 になります。
[マッチオプション] パラメーターが [最も近い] または [最も近い (測地線)] に設定されているときに、2 つ以上の結合フィーチャがターゲットフィーチャから同じ距離に存在する場合があります。この場合は、結合フィーチャのいずれかが、マッチするフィーチャとしてランダムに選択されます (結合フィーチャのオブジェクト ID は、この選択に影響しません)。 2番目、3番目、または N番目に近いフィーチャを検索するには、[近接情報テーブルの生成 (Generate Near Table)] ツールを使用します。
近接性の計算方法の詳細
1 つの結合フィーチャに複数のターゲットフィーチャとの空間リレーションシップがある場合、それはマッチするターゲットフィーチャの数だけカウントされます。たとえば、あるポイントが 3 つのポリゴン内にある場合、そのポイントはポリゴンにつき 1 回、合計で 3 回カウントされます。
3 次元空間リレーションシップの [交差する (3D)] および [一定距離内にある (3D)] の詳細については、「空間検索の 3D リレーションシップ」をご参照ください。

パラメーター

ラベル	説明	データタイプ
ターゲットフィーチャ	ターゲットフィーチャの属性と結合されたフィーチャの属性は、出力フィーチャクラスに転送されます。ただし、フィールドマップパラメーターに属性のサブセットを定義することができます。	Feature Layer
フィーチャの結合	結合フィーチャの属性は、ターゲットフィーチャの属性に結合されます。結合された属性の集約に結合操作がどのように影響するかについては、[結合方法] パラメーターの説明をご参照ください。	Feature Layer
出力フィーチャクラス	ターゲットフィーチャの属性と結合フィーチャの属性を含む、新しいフィーチャクラス。デフォルトでは、ターゲットフィーチャのすべての属性と結合されたフィーチャの属性が出力に書き込まれます。ただし、転送する属性のセットはフィールドマップパラメーターで設定できます。	Feature Class
結合方法 (オプション)	単一のターゲットフィーチャと同じ空間リレーションシップを持つ複数の結合フィーチャが検出された場合、ターゲットフィーチャと結合フィーチャの間の結合をどのように処理するかを指定します。 1 対 1 の結合—単一のターゲットフィーチャと同じ空間リレーションシップを持つ複数の結合フィーチャが検出された場合、フィールドマップのマージルールを使って複数の結合フィーチャの属性が集約されます。たとえば、1 つのポイント (ターゲットフィーチャ) が 2 つの異なるポリゴン (結合フィーチャ) 内にあると検出された場合、出力ポイントフィーチャクラスに渡される前に、2 つのポリゴンの属性が集約されます。 1 つのポリゴンの属性値が 3、もう 1 つのポリゴンの属性値が 7 であり、合計のマージルールが指定されている場合、出力フィーチャクラスの集約された値は 10 になります。これがデフォルトです。 1 対多の結合—単一のターゲットフィーチャと同じ空間リレーションシップを持つ複数の結合フィーチャが検出された場合、出力フィーチャクラスにはターゲットフィーチャの複数のコピー (レコード) が含まれます。たとえば、単一のポイントターゲットフィーチャが、2 つの異なるポリゴン結合フィーチャ内で検出された場合、出力フィーチャクラスには、ターゲットフィーチャの 2 つのコピーが含まれます。1 つ目のレコードには、1 つのポリゴンの属性が格納され、2 つ目のレコードには、もう 1 つのポリゴンの属性が格納されます。	String
すべてのターゲットフィーチャを保持する (オプション)	出力フィーチャクラスにすべてのターゲットフィーチャを保存するか (外部結合)、結合フィーチャとの空間リレーションシップが指定されたターゲットフィーチャのみを保存するか (内部結合) を指定します。オン - 出力にすべてのターゲットフィーチャが保存されます (外部結合)。これがデフォルトです。オフ - 出力フィーチャクラスに、結合フィーチャとの空間リレーションシップが指定されたターゲットフィーチャのみが保存されます (内部結合)。たとえば、ターゲットフィーチャとしてポイントフィーチャクラス、結合フィーチャとしてポリゴンフィーチャクラスを指定し、[マッチオプション] 値に [含まれる] を指定した場合、出力フィーチャクラスには、ポリゴン結合フィーチャ内にあるターゲットフィーチャのみが含まれます。結合フィーチャに含まれないターゲットフィーチャは出力から除外されます。	Boolean
フィールドマップ (オプション)	出力に含まれる属性フィールド、およびそれに対応するフィールドプロパティとソースフィールド。デフォルトでは、入力のすべてのフィールドが含まれます。フィールドの追加、削除、名前変更、並べ替えを行うことができ、フィールドのプロパティを変更することもできます。マージルールによって、複数の入力フィールドの値を単一の出力値にマージまたは結合する方法を指定できます。出力フィールドの値を指定する方法を決定するために使用できるマージルールは複数あります。最初 - 入力フィールドの最初の値を使用します。最後 - 入力フィールドの最後の値を使用します。結合 - 入力フィールドの値を結合します。合計 - 入力フィールドの値の合計を計算します。平均 - 入力フィールドの値の平均を計算します。中央値 - 入力フィールドの値の中央値を計算します。最頻値 - 最も頻度が高い値を使用します。最小 - すべての入力フィールドの値のうちの最小値を使用します。最大 - すべての入力フィールドの値のうちの最大値を使用します。標準偏差 - すべての入力フィールドの値に、標準偏差の分類法を使用します。個数 - 計算に含まれるレコード数を検出します。	Field Mappings
マッチオプション (オプション)	行の一致に使用される条件を指定します。インターセクト—結合フィーチャのフィーチャは、ターゲットフィーチャと交差するときにマッチします。これがデフォルトです。[検索範囲] パラメーターに距離を指定します。インターセクト 3D (Intersect 3D)— 結合フィーチャ内のフィーチャは、そのフィーチャが 3 次元空間 (X,Y,Z) でターゲットフィーチャと交差している場合にマッチします。[検索範囲] パラメーターに距離を指定します。一定距離内にある—結合フィーチャのフィーチャは、ターゲットフィーチャとの距離が指定範囲以内にある場合にマッチします。[検索範囲] パラメーターに距離を指定します。一定距離内にある (測地線)—平面距離ではなく測地距離が使用される以外は、[一定距離内にある] と同じです。データが広大な地理的範囲をカバーする場合や、入力座標系が距離の計算に適さない場合は、このオプションを選択します。一定距離内にある (3D)—結合フィーチャのフィーチャは、3 次元空間において、ターゲットフィーチャとの距離が指定範囲以内にある場合にマッチします。[検索範囲] パラメーターに距離を指定します。含む—結合フィーチャのフィーチャは、ターゲットフィーチャに含まれる場合にマッチします。ターゲットフィーチャは、ポリゴンまたはポリラインである必要があります。このオプションでは、ターゲットフィーチャとしてポイントを指定できません。また、ターゲットフィーチャがポリゴンの場合は、結合フィーチャとしてポリゴンだけを指定できます。完全に含む—結合フィーチャのフィーチャは、ターゲットフィーチャに完全に含まれる場合にマッチします。ポリゴンは、どのフィーチャも完全に含むことができます。ポイントは、どのフィーチャも完全に含むことはできず、ポイントを含むこともできません。ポリラインは、ポリラインとポイントのみを完全に含むことができます。含む (Clementini)—この空間リレーションシップは、結合フィーチャが完全にターゲットフィーチャの境界線上にある (選択フィーチャのどの部分も入力フィーチャの内部または外部にない) 場合、そのフィーチャはマッチしない点を除くと、[完全に含む] と同じ結果になります。Clementini は、境界線ポリゴンは内部と外部を分離するポリゴンであり、ラインの境界線はその端点で、ポイントの境界線は常に空であると定義しています。含まれる—結合フィーチャのフィーチャは、ターゲットフィーチャを含む場合にマッチします。これは [含む] の反対です。このオプションでは、結合フィーチャがポリゴンの場合は、ターゲットフィーチャとしてポリゴンだけを指定できます。ポイントがターゲットの場合にのみ結合フィーチャとしてポイントを指定できます。完全に含まれる—結合フィーチャのフィーチャは、ターゲットフィーチャがそれらに完全に含まれる場合にマッチします。これは [完全に含む] の反対です。含まれる (Clementini)—結合フィーチャのフィーチャ全体が、ターゲットフィーチャの境界線の上にある場合にはフィーチャがマッチしない点を除き、[検索範囲] と同じ結果になります。Clementini は、境界線ポリゴンは内部と外部を分離するポリゴンであり、ラインの境界線はその端点で、ポイントの境界線は常に空であると定義しています。正確に一致する—結合フィーチャのフィーチャは、ターゲットフィーチャと同一である場合にマッチします。結合フィーチャとターゲットフィーチャの両方が、同じシェープタイプ (ポイントとポイント、ラインとライン、ポリゴンとポリゴン) である必要があります。境界に接する—結合フィーチャのフィーチャは、境界線がターゲットフィーチャと接している場合にマッチします。ターゲットフィーチャおよび結合フィーチャがラインまたはポリゴンであるとき、結合フィーチャの境界線は、ターゲットフィーチャの境界線と接することができるだけで、結合フィーチャのいずれの部分もターゲットフィーチャの境界線と重なることはできません。線分を共有する—結合フィーチャのフィーチャは、ラインセグメントをターゲットフィーチャと共有する場合にマッチします。結合フィーチャおよびターゲットフィーチャは、ラインまたはポリゴンのいずれかである必要があります。アウトラインが横切る—結合フィーチャのフィーチャは、その境界線がターゲットフィーチャと交差する場合にマッチします。結合フィーチャおよびターゲットフィーチャは、ラインまたはポリゴンのいずれかである必要があります。結合フィーチャまたはターゲットフィーチャとしてポリゴンが使用される場合には、ポリゴンの境界線 (ライン) が使用されます。ポイントで交差するラインはマッチしますが、線分を共有するラインはマッチしません。区画の重心が入力フィーチャに含まれる—結合フィーチャのフィーチャは、ターゲットフィーチャの中心を含む場合にマッチします。フィーチャの中心を計算するために、ポリゴンとマルチポイントの場合はジオメトリの重心が使用され、ライン入力の場合にはジオメトリの中間点が使用されます。[検索範囲] パラメーターに距離を指定します。最も近い—結合フィーチャのフィーチャのうち、ターゲットフィーチャに最も近いフィーチャがマッチします。詳細については、使用上のヒントをご参照ください。[検索範囲] パラメーターに距離を指定します。最も近い測地線—平面距離ではなく測地距離が使用される以外は、[最近接] と同じです。データが広大な地理的範囲をカバーする場合や、入力座標系が距離の計算に適さない場合は、このオプションを選択します。最大オーバーラップ—結合フィーチャのフィーチャは、オーバーラップ部分が最大であるターゲットフィーチャとマッチします。	String
検索範囲 (オプション)	ターゲットフィーチャのこの範囲内にある結合フィーチャが、空間結合の対象と見なされます。検索範囲は、空間リレーションシップが指定された ([マッチオプション] パラメーターが [交差する]、[一定距離内にある]、[一定距離内にある (測地線)]、[重心が含まれる]、[最も近い] または [最も近い (測地線)] に設定された) 場合のみ有効になります。たとえば、検索範囲に 100 メートルを指定して、空間リレーションシップの [一定距離内にある] を使用すると、ターゲットフィーチャから 100 メートル以内のフィーチャを結合します。 3 つの [一定距離内にある] リレーションシップにおいて、[検索範囲] に値が指定されていない場合は、距離 0 が使用されます。	Linear Unit
距離フィールド名 (オプション)	出力フィーチャクラスに追加するフィールドの名前。ターゲットフィーチャと最も近い結合フィーチャとの間の距離が含まれます。このパラメーターは、空間リレーションシップが指定された ([マッチオプション] が [最も近い] または [最も近い (測地線)] に設定された) 場合のみ有効になります。検索範囲内にマッチするフィーチャがない場合、このフィールドの値は -1 になります。フィールド名を指定しないと、このフィールドは出力フィーチャクラスに追加されません。	String

arcpy.analysis.SpatialJoin(target_features, join_features, out_feature_class, {join_operation}, {join_type}, {field_mapping}, {match_option}, {search_radius}, {distance_field_name})

名前	説明	データタイプ
target_features	ターゲットフィーチャの属性と結合されたフィーチャの属性は、出力フィーチャクラスに転送されます。ただし、フィールドマップパラメーターに属性のサブセットを定義することができます。	Feature Layer
join_features	結合フィーチャの属性は、ターゲットフィーチャの属性に結合されます。結合された属性の集約に結合操作がどのように影響するかについては、join_operation パラメーターの説明をご参照ください。	Feature Layer
out_feature_class	ターゲットフィーチャの属性と結合フィーチャの属性を含む、新しいフィーチャクラス。デフォルトでは、ターゲットフィーチャのすべての属性と結合されたフィーチャの属性が出力に書き込まれます。ただし、転送する属性のセットはフィールドマップパラメーターで設定できます。	Feature Class
join_operation (オプション)	単一のターゲットフィーチャと同じ空間リレーションシップを持つ複数の結合フィーチャが検出された場合、ターゲットフィーチャと結合フィーチャの間の結合をどのように処理するかを指定します。 JOIN_ONE_TO_ONE—単一のターゲットフィーチャと同じ空間リレーションシップを持つ複数の結合フィーチャが検出された場合、フィールドマップのマージルールを使って複数の結合フィーチャの属性が集約されます。たとえば、1 つのポイント (ターゲットフィーチャ) が 2 つの異なるポリゴン (結合フィーチャ) 内にあると検出された場合、出力ポイントフィーチャクラスに渡される前に、2 つのポリゴンの属性が集約されます。 1 つのポリゴンの属性値が 3、もう 1 つのポリゴンの属性値が 7 であり、合計のマージルールが指定されている場合、出力フィーチャクラスの集約された値は 10 になります。これがデフォルトです。 JOIN_ONE_TO_MANY—単一のターゲットフィーチャと同じ空間リレーションシップを持つ複数の結合フィーチャが検出された場合、出力フィーチャクラスにはターゲットフィーチャの複数のコピー (レコード) が含まれます。たとえば、単一のポイントターゲットフィーチャが、2 つの異なるポリゴン結合フィーチャ内で検出された場合、出力フィーチャクラスには、ターゲットフィーチャの 2 つのコピーが含まれます。1 つ目のレコードには、1 つのポリゴンの属性が格納され、2 つ目のレコードには、もう 1 つのポリゴンの属性が格納されます。	String
join_type (オプション)	出力フィーチャクラスにすべてのターゲットフィーチャを保存するか (外部結合)、結合フィーチャとの空間リレーションシップが指定されたターゲットフィーチャのみを保存するか (内部結合) を指定します。 KEEP_ALL—出力にすべてのターゲットフィーチャが保存されます (外部結合)。これがデフォルトです。 KEEP_COMMON—出力フィーチャクラスに、結合フィーチャとの空間リレーションシップが指定されたターゲットフィーチャのみが保存されます (内部結合)。たとえば、ターゲットフィーチャとしてポイントフィーチャクラス、結合フィーチャとしてポリゴンフィーチャクラスを指定し、match_option = "WITHIN" を指定した場合、出力フィーチャクラスには、ポリゴン結合フィーチャ内にあるターゲットフィーチャのみが含まれます。結合フィーチャに含まれないターゲットフィーチャは出力から除外されます。	Boolean
field_mapping (オプション)	出力に含まれる属性フィールド、およびそれに対応するフィールドプロパティとソースフィールド。デフォルトでは、入力のすべてのフィールドが含まれます。フィールドの追加、削除、名前変更、並べ替えを行うことができ、フィールドのプロパティを変更することもできます。マージルールによって、複数の入力フィールドの値を単一の出力値にマージまたは結合する方法を指定できます。出力フィールドの値を指定する方法を決定するために使用できるマージルールは複数あります。最初 - 入力フィールドの最初の値を使用します。最後 - 入力フィールドの最後の値を使用します。結合 - 入力フィールドの値を結合します。合計 - 入力フィールドの値の合計を計算します。平均 - 入力フィールドの値の平均を計算します。中央値 - 入力フィールドの値の中央値を計算します。最頻値 - 最も頻度が高い値を使用します。最小 - すべての入力フィールドの値のうちの最小値を使用します。最大 - すべての入力フィールドの値のうちの最大値を使用します。標準偏差 - すべての入力フィールドの値に、標準偏差の分類法を使用します。個数 - 計算に含まれるレコード数を検出します。このパラメーターを定義するには、Python で FieldMappings クラスを使用します。	Field Mappings
match_option (オプション)	行の一致に使用される条件を指定します。 INTERSECT—結合フィーチャのフィーチャは、ターゲットフィーチャと交差するときにマッチします。これがデフォルトです。search_radius パラメーターに距離を指定します。 INTERSECT_3D— 結合フィーチャ内のフィーチャは、そのフィーチャが 3 次元空間 (X,Y,Z) でターゲットフィーチャと交差している場合にマッチします。search_radius パラメーターに距離を指定します。 WITHIN_A_DISTANCE—結合フィーチャのフィーチャは、ターゲットフィーチャとの距離が指定範囲以内にある場合にマッチします。search_radius パラメーターに距離を指定します。 WITHIN_A_DISTANCE_GEODESIC—平面距離ではなく測地距離が使用される以外は、WITHIN_A_DISTANCE と同じです。データが広大な地理的範囲をカバーする場合や、入力座標系が距離の計算に適さない場合は、このオプションを選択します。 WITHIN_A_DISTANCE_3D—結合フィーチャのフィーチャは、3 次元空間において、ターゲットフィーチャとの距離が指定範囲以内にある場合にマッチします。search_radius パラメーターに距離を指定します。 CONTAINS—結合フィーチャのフィーチャは、ターゲットフィーチャに含まれる場合にマッチします。ターゲットフィーチャは、ポリゴンまたはポリラインである必要があります。このオプションでは、ターゲットフィーチャとしてポイントを指定できません。また、ターゲットフィーチャがポリゴンの場合は、結合フィーチャとしてポリゴンだけを指定できます。 COMPLETELY_CONTAINS—結合フィーチャのフィーチャは、ターゲットフィーチャに完全に含まれる場合にマッチします。ポリゴンは、どのフィーチャも完全に含むことができます。ポイントは、どのフィーチャも完全に含むことはできず、ポイントを含むこともできません。ポリラインは、ポリラインとポイントのみを完全に含むことができます。 CONTAINS_CLEMENTINI—この空間リレーションシップは、結合フィーチャが完全にターゲットフィーチャの境界線上にある (選択フィーチャのどの部分も入力フィーチャの内部または外部にない) 場合、そのフィーチャはマッチしない点を除くと、COMPLETELY_CONTAINS と同じ結果になります。Clementini は、境界線ポリゴンは内部と外部を分離するポリゴンであり、ラインの境界線はその端点で、ポイントの境界線は常に空であると定義しています。 WITHIN—結合フィーチャのフィーチャは、ターゲットフィーチャを含む場合にマッチします。これは CONTAINS の反対です。このオプションでは、結合フィーチャがポリゴンの場合は、ターゲットフィーチャとしてポリゴンだけを指定できます。ポイントがターゲットの場合にのみ結合フィーチャとしてポイントを指定できます。 COMPLETELY_WITHIN—結合フィーチャのフィーチャは、ターゲットフィーチャがそれらに完全に含まれる場合にマッチします。これは COMPLETELY_CONTAINS の反対です。 WITHIN_CLEMENTINI—結合フィーチャのフィーチャ全体が、ターゲットフィーチャの境界線の上にある場合にはフィーチャがマッチしない点を除き、WITHIN と同じ結果になります。Clementini は、境界線ポリゴンは内部と外部を分離するポリゴンであり、ラインの境界線はその端点で、ポイントの境界線は常に空であると定義しています。 ARE_IDENTICAL_TO—結合フィーチャのフィーチャは、ターゲットフィーチャと同一である場合にマッチします。結合フィーチャとターゲットフィーチャの両方が、同じシェープタイプ (ポイントとポイント、ラインとライン、ポリゴンとポリゴン) である必要があります。 BOUNDARY_TOUCHES—結合フィーチャのフィーチャは、境界線がターゲットフィーチャと接している場合にマッチします。ターゲットフィーチャおよび結合フィーチャがラインまたはポリゴンであるとき、結合フィーチャの境界線は、ターゲットフィーチャの境界線と接することができるだけで、結合フィーチャのいずれの部分もターゲットフィーチャの境界線と重なることはできません。 SHARE_A_LINE_SEGMENT_WITH—結合フィーチャのフィーチャは、ラインセグメントをターゲットフィーチャと共有する場合にマッチします。結合フィーチャおよびターゲットフィーチャは、ラインまたはポリゴンのいずれかである必要があります。 CROSSED_BY_THE_OUTLINE_OF—結合フィーチャのフィーチャは、その境界線がターゲットフィーチャと交差する場合にマッチします。結合フィーチャおよびターゲットフィーチャは、ラインまたはポリゴンのいずれかである必要があります。結合フィーチャまたはターゲットフィーチャとしてポリゴンが使用される場合には、ポリゴンの境界線 (ライン) が使用されます。ポイントで交差するラインはマッチしますが、線分を共有するラインはマッチしません。 HAVE_THEIR_CENTER_IN—結合フィーチャのフィーチャは、ターゲットフィーチャの中心を含む場合にマッチします。フィーチャの中心を計算するために、ポリゴンとマルチポイントの場合はジオメトリの重心が使用され、ライン入力の場合にはジオメトリの中間点が使用されます。search_radius パラメーターに距離を指定します。 CLOSEST—結合フィーチャのフィーチャのうち、ターゲットフィーチャに最も近いフィーチャがマッチします。詳細については、使用上のヒントをご参照ください。search_radius パラメーターに距離を指定します。 CLOSEST_GEODESIC—平面距離ではなく測地距離が使用される以外は、CLOSEST と同じです。データが広大な地理的範囲をカバーする場合や、入力座標系が距離の計算に適さない場合は、このオプションを選択します。 LARGEST_OVERLAP—結合フィーチャのフィーチャは、オーバーラップ部分が最大であるターゲットフィーチャとマッチします。	String
search_radius (オプション)	ターゲットフィーチャのこの範囲内にある結合フィーチャが、空間結合の対象と見なされます。検索範囲は、空間リレーションシップが指定された (match_option パラメーターが INTERSECT、WITHIN_A_DISTANCE、WITHIN_A_DISTANCE_GEODESIC、HAVE_THEIR_CENTER_IN、CLOSEST または CLOSEST_GEODESIC に設定された) 場合のみ有効になります。たとえば、検索範囲に 100 メートルを指定して、空間リレーションシップの WITHIN_A_DISTANCE を使用すると、ターゲットフィーチャから 100 メートル以内のフィーチャを結合します。 3 つの WITHIN_A_DISTANCE リレーションシップにおいて、search_radius に値が指定されていない場合は、距離 0 が使用されます。	Linear Unit
distance_field_name (オプション)	出力フィーチャクラスに追加するフィールドの名前。ターゲットフィーチャと最も近い結合フィーチャとの間の距離が含まれます。このパラメーターは、空間リレーションシップが指定された (match_option が CLOSEST または CLOSEST_GEODESIC に設定された) 場合にのみ有効になります。検索範囲内にマッチするフィーチャがない場合、このフィールドの値は -1 になります。フィールド名を指定しないと、このフィールドは出力フィーチャクラスに追加されません。	String

コードのサンプル

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

次のスクリプトは、Python ウィンドウで SpatialJoin 関数を使用する方法を示しています。

import arcpy

target_features = "C:/data/usa.gdb/states"
join_features = "C:/data/usa.gdb/cities"
out_feature_class = "C:/data/usa.gdb/states_cities"

arcpy.SpatialJoin_analysis(target_features, join_features, out_feature_class)

SpatialJoin の例 2 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトは、都市の属性を州に結合するために SpatialJoin 関数を使用する方法を示しています。

# Name: SpatialJoin_Example2.py
# Description: Join attributes of cities to states based on spatial relationships.
# Requirements: os module

# Import system modules
import arcpy
import os

# Set local variables
workspace = r"C:\gpqa\mytools\spatialjoin\usa.gdb"
outWorkspace = r"C:\gpqa\mytools\spatialjoin\output.gdb"
 
# Want to join USA cities to states and calculate the mean city population
# for each state
targetFeatures = os.path.join(workspace, "states")
joinFeatures = os.path.join(workspace, "cities")
 
# Output will be the target features, states, with a mean city population field (mcp)
outfc = os.path.join(outWorkspace, "states_mcp2")
 
# Create a new fieldmappings and add the two input feature classes.
fieldmappings = arcpy.FieldMappings()
fieldmappings.addTable(targetFeatures)
fieldmappings.addTable(joinFeatures)
 
# First get the POP1990 fieldmap. POP1990 is a field in the cities feature class.
# The output will have the states with the attributes of the cities. Setting the
# field's merge rule to mean will aggregate the values for all of the cities for
# each state into an average value. The field is also renamed to be more appropriate
# for the output.
pop1990FieldIndex = fieldmappings.findFieldMapIndex("POP1990")
fieldmap = fieldmappings.getFieldMap(pop1990FieldIndex)
 
# Get the output field's properties as a field object
field = fieldmap.outputField
 
# Rename the field and pass the updated field object back into the field map
field.name = "mean_city_pop"
field.aliasName = "mean_city_pop"
fieldmap.outputField = field
 
# Set the merge rule to mean and then replace the old fieldmap in the mappings object
# with the updated one
fieldmap.mergeRule = "mean"
fieldmappings.replaceFieldMap(pop1990FieldIndex, fieldmap)
 
# Delete fields that are no longer applicable, such as city CITY_NAME and CITY_FIPS
# as only the first value will be used by default
x = fieldmappings.findFieldMapIndex("CITY_NAME")
fieldmappings.removeFieldMap(x)
y = fieldmappings.findFieldMapIndex("CITY_FIPS")
fieldmappings.removeFieldMap(y)
 
#Run the Spatial Join tool, using the defaults for the join operation and join type
arcpy.SpatialJoin_analysis(targetFeatures, joinFeatures, outfc, "#", "#", fieldmappings)

環境

出力データのデフォルト Z 値, M 座標精度, M 許容値, 出力データのコンフィグレーションキーワード, 出力データの M ドメイン, 出力データの XY ドメイン, 出力データの Z ドメイン, 出力座標系, 範囲, 出力に M 値がある, 出力に Z 値がある, XY 座標精度, XY 許容値, Z 座標精度, Z 許容値

特殊なケース

ライセンス情報

Basic: Yes
Standard: Yes
Advanced: Yes

サマリー

使用法

パラメーター

コードのサンプル

環境

特殊なケース

ライセンス情報

関連トピック

このトピックの内容