フィーチャの結合 (Join Features) (GeoAnalytics)

サマリー

空間、時系列、および属性リレーションシップ、またはこれらのリレーションシップの組み合わせに基づいて、1 つのレイヤーの属性をもう 1 つのレイヤーに結合します。

レガシー:

ArcGIS GeoAnalytics Server エクステンションは ArcGIS Enterprise で廃止されます。 GeoAnalytics Server の最終リリースは ArcGIS Enterprise 11.3 に含まれています。 このジオプロセシング ツールは ArcGIS Enterprise 11.3 以前のバージョンで使用できます。

図

両方の例では、フィーチャの結合ツールを使用して時空間結合を示します。

使用法

• 空間結合では、空間位置に基づいて、入力フィーチャ ([ターゲット レイヤー] および [結合レイヤー] パラメーター値) からのフィーチャ (行) と照合します。 時間結合では、時系列リレーションシップに基づいて、入力フィーチャからのフィーチャ (行) と照合します。 属性結合は、フィールド値に基づいてフィーチャを照合します。

• 空間リレーションシップ、時系列リレーションシップ、属性リレーションシップ、またはこれら 3 つの組み合わせに基づいてフィーチャを結合できます。

  オプション	説明
  空間リレーションシップ	フィーチャが互いに結合しているかどうかを判断する空間リレーションシップ。 使用可能なリレーションシップは、結合されるレイヤーのジオメトリのタイプ (ポイント、ライン、エリア) によって決まります。 使用可能な空間リレーションシップを次に示します。 交差する 等しい [平面近接] - 平面距離を使用します。 [測地線近接] - 測地距離を使用します。 ArcGIS Enterprise 10.7.1 以降でのみ利用可能です。 含む 含まれる 接する 横切る オーバーラップする GeoAnalytics Server ツールの空間リレーションシップの詳細
  時系列リレーションシップ	フィーチャが互いに結合しているかどうかを判断する時系列リレーションシップ。 使用可能なリレーションシップは、結合されるレイヤーの時系列のタイプ (インスタントまたは間隔) によって決まります。 使用可能な時系列リレーションシップを次に示します。 接続する 接続される オーバーラップする オーバーラップされる 期間内にある 含む 等しい 終了する 終了される 開始する 開始される 交差する 最近接 近接 (前) 近接 (後) GeoAnalytics Server ツールの時系列リレーションシップの詳細
  属性リレーションシップ	フィーチャが互いに結合しているかどうかを判断する属性リレーションシップ。 フィーチャは、結合レイヤーのフィールド値がターゲット レイヤーのフィールド値に等しい場合に一致します。

• ターゲット フィーチャと結合フィーチャの座標系が異なる場合、ターゲット フィーチャの座標系が使用されます。 出力座標系を指定した場合、両方のフィーチャが出力座標系に投影変換されてから、結合されます。

• [空間リレーションシップ] パラメーター値が [平面近接] の場合、[ターゲット レイヤー] パラメーター値が投影されているか、出力座標系が投影座標系に設定されている必要があります。

• 同じターゲット フィーチャに複数のフィーチャが一致する場合、すべての一致するフィーチャを個別に結合する ([結合方法] の値を [1 対多の結合] にする) か、または一致するすべてのフィーチャをまとめて結合する ([結合方法] の値を [1 対 1 の結合] にする) かどうかを決定できます。

  • [1 対多の結合] - 一致するフィーチャがすべてターゲット レイヤーに結合されます。 結果レイヤーには、ターゲット フィーチャの複数レコードが含まれます。
  • [1 対 1 の結合] - ターゲット レイヤーの各フィーチャと一致するすべての結合フィーチャが集約されます。 一致するフィーチャがあるフィーチャのみが、集約と出力に含まれます。 結合されたフィーチャの個数は、合計、最小、最大、範囲、平均、分散、標準偏差などの他の統計とともに追加されます。 デフォルトでは、出力フィーチャクラスに、リレーションシップが指定されたターゲット フィーチャのみが保持されます (これを内部結合と呼びます)。 [すべてのターゲット フィーチャを保持する] がオンになっている場合、すべての入力ターゲット フィーチャが出力フィーチャクラスに書き込まれます (これを左外部結合と呼びます)。

  

  1 対多の結合と 1 対 1 の結合の例を示します。 この例では、1 対 1 の結合に個数だけが含まれています。計算可能な追加の統計を次に示します。

• [結合条件] パラメーターを使用して、フィーチャを結合する式を作成することもできます。 式を指定すると、条件を満たすフィーチャのみが使用されます。 たとえば、$target["Magnitude"] > $join["Explosion"] 式を使用して、Explosion というフィールドを含む結合フィーチャより大きい場合のみ、Magnitude フィールドからターゲット フィーチャを結合できます。 詳細については、「フィーチャの結合式」をご参照ください。

• 1 対多の結合を実行する際は、次のフィールドが出力フィーチャに含められます。

  • ターゲット レイヤーのすべてのフィールド
  • 結合したレイヤーのすべてのフィールド

  ターゲット データセットと結合データセットの両方に同じフィールド名が含まれる場合は、結合したフィールドの先頭は「join」になります (join_fieldname など)。

  フィールド名	説明
  start_datetime	このフィールドは開始時間を表し、入力の時間がインスタントや間隔として設定されている場合に作成されます。
  end_datetime	このフィールドは終了時間を表し、入力の時間が間隔として設定されている場合に作成されます。

  1 対多の結合を実行する際は、ターゲット レイヤーのすべてのフィールド以外に次のフィールドが出力フィーチャに含まれます。

  フィールド名	説明
  count	結合したフィーチャの数。
  statistic_fieldname	指定した統計ごとに、statistic_fieldname という形式の名前の属性フィールドが作成されます。 たとえば、フィールド id の最大と標準偏差は、MAX_id および SD_id です。
  start_datetime	このフィールドは開始時間を表し、入力の時間がインスタントや間隔として設定されている場合に作成されます。
  end_datetime	このフィールドは終了時間を表し、入力の時間が間隔として設定されている場合に作成されます。

• [距離を含める] パラメーターがオンで、[結合方法] パラメーターが [1 対多の結合] に設定されている場合、次のフィールドが出力フィーチャに含められます。

  フィールド名	説明
  distance	ターゲット フィーチャと結合フィーチャの間の距離。 [空間リレーションシップ] パラメーターが [平面近接] または [測地線近接] の場合、このフィールドが含められます。 距離が 0 の場合、ターゲット ジオメトリと結合ジオメトリが交差していることを示します。 NULL 値は、ジオメトリが [空間的近接距離] パラメーター値よりも離れていることを示します。 [空間リレーションシップ] パラメーター値が [平面近接] の場合、距離の値は平面になります。このパラメーター値が [測地線近接] の場合、距離の値は測地線になります。 これらの値には、[距離単位] パラメーターで指定された単位が使用されます。 デフォルトの距離単位は「メートル」です。
  timegap	ターゲット フィーチャと結合フィーチャ間の時間差 (ミリ秒単位)。 [時系列リレーションシップ] パラメーターが [近接]、[近接 (前)]、または [近接 (後)] の場合、このフィールドが含まれます。 距離が 0 の場合、ターゲット フィーチャと結合フィーチャが時間的に交差していることを示します。 正の値は結合フィーチャの前にターゲット フィーチャが発生していることを意味し、負の値はターゲット フィーチャの前に結合フィーチャが発生していることを意味します。 NULL 値は、フィーチャが結合条件と一致しなかったことを示します。 たとえば、フィーチャが [時間的近接距離] パラメーター値よりも離れています。

• 以下を 1 つ以上行うことで、[フィーチャの結合 (Join Features)] ツールのパフォーマンスを向上させることができます。

  • 対象データのみが解析されるように、範囲環境を設定します。
  • 結合条件はできるだけ限定してください。 たとえば、1 キロメートル圏内の近接結合は、同じデータに対する 5 キロメートル圏内の近接結合よりも効率的です。
  • 2 つ以上の結合条件を追加します。 結合条件を増やすことで、結合が限定的になります。 たとえば、1 キロメートル、1 時間圏内の近接結合は、同じデータに対する 1 キロメートル圏内の近接結合よりも効率的です。
  • 結合式を適用します。
  • 解析が実行されているロケーションに対してローカルなデータを使用します。

• 解析ツールボックスの [空間結合 (Spatial Join)] ツールを使用して、同様の解析を実行することもできます。

• ジオプロセシング ツールは、ArcGIS GeoAnalytics Server を活用しています。 解析は GeoAnalytics Server で実行され、結果は ArcGIS Enterprise のコンテンツに保存されます。

• GeoAnalytics Server ツールを実行する場合、解析は GeoAnalytics Server で実行されます。 最適なパフォーマンスを得るためには、ArcGIS Enterprise ポータルでホストされているフィーチャ レイヤーかビッグ データ ファイル共有を通じて、GeoAnalytics Server にデータを提供する必要があります。 GeoAnalytics Server のローカルにないデータは、解析が開始する前に GeoAnalytics Server に移動されます。 つまり、ツールを実行する時間が長くなり、場合によっては ArcGIS Pro から GeoAnalytics Server にデータを移動できないこともあります。 エラーの閾値はネットワークの速度や、データのサイズや複雑さに左右されます。 データを必ず共有するか、ビッグ データ ファイル共有を作成することをおすすめします。

  データをポータルで共有する方法の詳細

  ArcGIS Server Manager を使用してビッグ データ ファイル共有を作成する方法の詳細

パラメーター

ダイアログ

ラベル	説明	データ タイプ
ターゲット レイヤー	ターゲット フィーチャを含みます。 ターゲット フィーチャの属性と結合されたフィーチャの属性は、出力に転送されます。	Record Set
結合レイヤー	結合フィーチャを含みます。 結合フィーチャの属性は、ターゲット フィーチャの属性に結合されます。 結合された属性の集約に結合操作がどのように影響するかについては、[結合方法] パラメーターの説明をご参照ください。	Record Set
出力名	出力フィーチャ サービスの名前。	String
結合方法	複数の結合フィーチャが単一のターゲット フィーチャと同じ空間リレーションシップを持つ場合、[ターゲット レイヤー] 値と [結合レイヤー] 値の間の結合を出力でどのように処理するかを指定します。 1 対 1 の結合—複数の結合フィーチャの属性が集約されます。 たとえば、1 つのポイント (ターゲット フィーチャ) が 2 つの異なるポリゴン (結合フィーチャ) 内にある場合、出力ポイント フィーチャクラスに渡される前に、2 つのポリゴンの属性が集約されます。 1 つのポリゴンの属性値が 3、もう 1 つのポリゴンの属性値が 7 であり、このフィールドで統計の種類に合計が指定されている場合、出力フィーチャクラスの集約された値は 10 になります。 これがデフォルトです。数の統計のみが返されます。 1 対多の結合—出力フィーチャクラスには、ターゲット フィーチャの複数のコピー (レコード) が含まれます。 たとえば、単一のポイント ターゲット フィーチャが、2 つの異なるポリゴン結合フィーチャ内にある場合、出力フィーチャクラスには、ターゲットフィーチャの 2 つのコピーが含まれます。1 つ目のレコードには、1 つのポリゴンの属性が格納され、2 つ目のレコードには、もう 1 つのポリゴンの属性が格納されます。 このオプションで使用できる統計サマリーはありません。	String
空間リレーションシップ (オプション)	フィーチャを空間的に結合するために使用する条件を指定します。 交差する—結合フィーチャのフィーチャは、ターゲット フィーチャと交差するときにマッチします。 これがデフォルトです。 等しい—結合フィーチャのフィーチャは、ターゲット フィーチャと同じジオメトリである場合にマッチします。 平面近接—結合フィーチャのフィーチャは、ターゲット フィーチャとの距離が指定範囲以内の場合にマッチします。 距離は、平面距離を使用して測定されます。 [空間的近接距離] パラメーターに距離を指定します。 測地線近接—結合フィーチャのフィーチャは、ターゲット フィーチャとの距離が指定範囲以内にある場合にマッチします。 距離は測地線で測定されます。 [空間的近接距離] パラメーターに距離を指定します。 このオプションは、ArcGIS Enterprise 10.7 以降に追加されています。 含む—結合フィーチャのフィーチャは、ターゲット フィーチャに含まれる場合にマッチします。 ターゲット フィーチャは、ポリゴンまたはポリラインである必要があります。 ターゲット フィーチャもポリゴンである場合にのみ、結合フィーチャをポリゴンにすることができます。 ポリゴンは、任意のフィーチャ タイプを含むことができます。 ポリラインは、ポリラインとポイントのみを含むことができます。 ポイントは、どのフィーチャも含むことはできず、ポイントを含むこともできません。 結合フィーチャが完全にターゲット フィーチャの境界上にある場合 (どの部分も境界の内部または外部にない場合)、そのフィーチャはマッチしません。 含まれる—結合フィーチャのフィーチャは、ターゲット フィーチャを含む場合にマッチします。 これは、「含む」リレーションシップの反対です。 結合フィーチャがポリゴンの場合は、ターゲット フィーチャとしてポリゴンだけを指定できます。 ポイントがターゲット フィーチャでもある場合にのみ結合フィーチャとしてポイントを指定できます。 結合フィーチャのフィーチャ全体が、ターゲット フィーチャの境界線の上にある場合、フィーチャはマッチしません。 接する—結合フィーチャのフィーチャは、境界線がターゲット フィーチャと接している場合にマッチします。 ターゲット フィーチャおよび結合フィーチャがラインまたはポリゴンであるとき、結合フィーチャの境界線は、ターゲット フィーチャの境界線と接することができるだけで、結合フィーチャのいずれの部分もターゲット フィーチャの境界線と重なることはできません。 横切る—結合フィーチャのフィーチャは、その境界線がターゲット フィーチャと交差する場合にマッチします。 結合フィーチャおよびターゲット フィーチャは、ラインまたはポリゴンのいずれかである必要があります。 結合フィーチャまたはターゲット フィーチャとしてポリゴンが使用される場合には、ポリゴンの境界線 (ライン) が使用されます。 ポイントで交差するラインはマッチしますが、線分を共有するラインはマッチしません。 オーバーラップする—結合フィーチャのフィーチャは、ターゲット フィーチャと重複するときにマッチします。	String
空間的近接距離 (オプション)	空間結合の対象として検討される結合フィーチャ内のターゲット フィーチャからの距離。 検索範囲は、[空間リレーションシップ] パラメーター値が [平面近接] または [測地線近接] の場合のみ有効になります。	Linear Unit
時系列リレーションシップ (オプション)	フィーチャの一致に使用する時間条件を指定します。 接続する—ターゲット フィーチャの終了時間が結合フィーチャの開始時間に等しい場合、ターゲット フィーチャは結合フィーチャに接続します。 接続される—ターゲット フィーチャの開始時間が結合フィーチャの終了時間に等しい場合、結合フィーチャはターゲット フィーチャに接続します。 オーバーラップする—ターゲット時間間隔の開始と終了がそれぞれ、結合時間間隔の開始と終了より前である場合、ターゲット時間は結合時間にオーバーラップします。 オーバーラップされる—ターゲット時間間隔の開始と終了がそれぞれ、結合時間間隔の開始と終了より後である場合、ターゲット時間は結合時間にオーバーラップされます。 期間内にある—ターゲット フィーチャが結合フィーチャの開始と終了の間に発生する場合、ターゲット フィーチャの期間は結合フィーチャの期間内にあります。 含む—結合フィーチャがターゲット フィーチャの開始と終了の間に発生する場合、ターゲット フィーチャの期間は結合フィーチャの期間内にあります。 等しい—2 つの時間は、それらの特定の時点または間隔が同一である場合に、等しいと見なされます。 終了する—ターゲット フィーチャと結合フィーチャの終了が同じ時間であり、ターゲット フィーチャが結合フィーチャの後に開始する場合です。 終了される—結合フィーチャ時間がターゲット時間と同時に終了し、結合時間がターゲット時間の後に開始する場合、ターゲット時間は結合時間により終了され (Finished by) ます。 開始する—ターゲット時間が、結合時間間隔と同じ時間に開始し、結合時間間隔が終了する前に終了する場合、ターゲット時間が結合時間を開始します。 開始される—ターゲット フィーチャと結合フィーチャの開始が同じ時間であり、ターゲット フィーチャが結合フィーチャの後に終了する場合です。 交差する—ターゲット フィーチャの時間のいずれかの部分が結合フィーチャの時間と交わります。 最近接—ターゲット フィーチャの時間が結合フィーチャの時間から指定された時間の範囲内にある場合です。 近接 (前)—ターゲット フィーチャの時間が結合フィーチャの時間の前だが、結合フィーチャの時間から指定された時間の範囲内にある場合です。 このオプションは、ArcGIS Enterprise 10.6 以降に追加されています。 近接 (後)—ターゲット フィーチャの時間が結合フィーチャの時間の後だが、結合フィーチャの時間から指定された時間の範囲内にある場合です。 このオプションは、ArcGIS Enterprise 10.6 以降に追加されています。	String
時間的近接距離 (オプション)	空間結合の対象として検討される結合フィーチャ内のターゲット フィーチャからの時間距離。 時間は、[時系列リレーションシップ] パラメーター値が [近接]、[近接 (前)]、または [近接 (後)] であり、両方のフィーチャが時間対応である場合にのみ有効です。	Time Unit
属性リレーションシップ (オプション)	属性フィールドの値に基づいてフィーチャを結合します。 結合レイヤーの属性フィールドにマッチするターゲット レイヤーの属性フィールドを指定します。 ターゲット フィールド - マッチする値を含んでいるターゲット レイヤーの属性フィールド。 結合フィールド - マッチする値を含んでいる結合レイヤーの属性フィールド。	Value Table
サマリー フィールド (オプション)	指定されたフィールドに関して計算される統計情報。	Value Table
結合条件 (オプション)	条件を指定のフィールドに適用します。 これらの条件を満たしているフィールドを含むフィーチャだけが結合されます。 たとえば、結合レイヤー内の属性 HealthSpending がターゲット レイヤー内の属性 Income の 20% よりも大きい場合に、結合条件をフィーチャに適用できます。 ArcGIS Enterprise 10.5 および 10.5.1 では、この式の適用に使用される結合条件は join["HealthSpending"] > target["Income"] * .2 です。 ArcGIS Enterprise 10.6 以降では、$join["HealthSpending"] > $target["Income"] * .2 のような Arcade 式を使用します。 レイヤーをマップに追加する場合、[フィールド] および [ヘルパー] フィルターを使って式を組み立てることができます。 10.6 でのフィーチャの結合の式の詳細	String
データ ストア (オプション)	出力が格納される ArcGIS Data Store を指定します。 ビッグ データ ストアに格納されたすべての結果は、WGS84 で保存されます。 リレーショナル データ ストアに格納された結果は、それらの座標系を維持します。 ビッグ データ ストア—出力がビッグ データ ストアに格納されます。 これがデフォルトです。 リレーショナル データ ストア—出力がリレーショナル データ ストアに格納されます。	String
すべてのターゲット フィーチャを保持する (オプション)	出力フィーチャクラスにすべてのターゲット フィーチャを保持するか (左外部結合)、結合フィーチャとのリレーションシップが指定されたターゲット フィーチャのみを保持するか (内部結合) を指定します。 オン - 出力にすべてのターゲット フィーチャが保存されます。 オフ - 出力フィーチャクラスに、リレーションシップが指定されたターゲット フィーチャのみが保存されます。 ポリゴン フィーチャに含まれないポイント フィーチャは出力から除外されます。 これがデフォルトです。	Boolean
距離を含める (オプション)	空間距離または時間差を結果に含めるかどうかを指定します。 このパラメーターは、[結合方法] パラメーター値が [1 対多の結合] で、[空間リレーションシップ] パラメーター値が [平面近接] か [測地線近接]、または [時系列リレーションシップ] パラメーター値が [近接]、[近接 (前)]、または [近接 (後)] である場合にアクティブになります。 オン - 空間距離または時間差を結果に含めます。 オフ - 空間距離も時間差も結果に含めません。 これがデフォルトです。	Boolean
距離単位 (オプション)	出力フィーチャクラスの距離値に使用する計測単位を指定します。 メートル—計測単位はメートルです。 これがデフォルトです。 キロメートル—計測単位はキロメートルです。 米国測量マイル—計測単位は米国測量マイルです。 米国測量海里—計測単位は米国測量海里です。 米国測量ヤード—計測単位は米国測量ヤードです。 米国測量フィート—計測単位は米国測量フィートです。 法定マイル—計測単位は法定マイルです。 国際海里—計測単位は国際海里です。 国際ヤード—計測単位は国際ヤードです。 国際フィート—計測単位は国際フィートです。	String

派生した出力

ラベル	説明	データ タイプ
出力フィーチャクラス	結合後の出力。	Record Set

Python

arcpy.geoanalytics.JoinFeatures(target_layer, join_layer, output_name, join_operation, {spatial_relationship}, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {attribute_relationship}, {summary_fields}, {join_condition}, {data_store}, {keep_all_target_features}, {include_distance}, {distance_unit})

名前	説明	データ タイプ
target_layer	ターゲット フィーチャを含みます。 ターゲット フィーチャの属性と結合されたフィーチャの属性は、出力に転送されます。	Record Set
join_layer	結合フィーチャを含みます。 結合フィーチャの属性は、ターゲット フィーチャの属性に結合されます。 結合された属性の集約に結合操作がどのように影響するかについては、[結合方法] パラメーターの説明をご参照ください。	Record Set
output_name	出力フィーチャ サービスの名前。	String
join_operation	複数の結合フィーチャが単一のターゲット フィーチャと同じ空間リレーションシップを持つ場合、target_layer 値と join_layer 値の間の結合を出力フィーチャでどのように処理するかを指定します。 JOIN_ONE_TO_ONE—複数の結合フィーチャの属性が集約されます。 たとえば、1 つのポイント (ターゲット フィーチャ) が 2 つの異なるポリゴン (結合フィーチャ) 内にある場合、出力ポイント フィーチャクラスに渡される前に、2 つのポリゴンの属性が集約されます。 1 つのポリゴンの属性値が 3、もう 1 つのポリゴンの属性値が 7 であり、このフィールドで統計の種類に合計が指定されている場合、出力フィーチャクラスの集約された値は 10 になります。 これがデフォルトです。数の統計のみが返されます。 JOIN_ONE_TO_MANY—出力フィーチャクラスには、ターゲット フィーチャの複数のコピー (レコード) が含まれます。 たとえば、単一のポイント ターゲット フィーチャが、2 つの異なるポリゴン結合フィーチャ内にある場合、出力フィーチャクラスには、ターゲットフィーチャの 2 つのコピーが含まれます。1 つ目のレコードには、1 つのポリゴンの属性が格納され、2 つ目のレコードには、もう 1 つのポリゴンの属性が格納されます。 このオプションで使用できる統計サマリーはありません。	String
spatial_relationship (オプション)	フィーチャを空間的に結合するために使用する条件を指定します。 INTERSECTS—結合フィーチャのフィーチャは、ターゲット フィーチャと交差するときにマッチします。 これがデフォルトです。 EQUALS—結合フィーチャのフィーチャは、ターゲット フィーチャと同じジオメトリである場合にマッチします。 NEAR—結合フィーチャのフィーチャは、ターゲット フィーチャとの距離が指定範囲以内の場合にマッチします。 距離は、平面距離を使用して測定されます。 spatial_near_distance パラメーターに距離を指定します。 NEAR_GEODESIC—結合フィーチャのフィーチャは、ターゲット フィーチャとの距離が指定範囲以内にある場合にマッチします。 距離は測地線で測定されます。 spatial_near_distance パラメーターに距離を指定します。 このオプションは、ArcGIS Enterprise 10.7 以降に追加されています。 CONTAINS—結合フィーチャのフィーチャは、ターゲット フィーチャに含まれる場合にマッチします。 ターゲット フィーチャは、ポリゴンまたはポリラインである必要があります。 ターゲット フィーチャもポリゴンである場合にのみ、結合フィーチャをポリゴンにすることができます。 ポリゴンは、任意のフィーチャ タイプを含むことができます。 ポリラインは、ポリラインとポイントのみを含むことができます。 ポイントは、どのフィーチャも含むことはできず、ポイントを含むこともできません。 結合フィーチャが完全にターゲット フィーチャの境界上にある場合 (どの部分も境界の内部または外部にない場合)、そのフィーチャはマッチしません。 WITHIN—結合フィーチャのフィーチャは、ターゲット フィーチャを含む場合にマッチします。 これは、「含む」リレーションシップの反対です。 結合フィーチャがポリゴンの場合は、ターゲット フィーチャとしてポリゴンだけを指定できます。 ポイントがターゲット フィーチャでもある場合にのみ結合フィーチャとしてポイントを指定できます。 結合フィーチャのフィーチャ全体が、ターゲット フィーチャの境界線の上にある場合、フィーチャはマッチしません。 TOUCHES—結合フィーチャのフィーチャは、境界線がターゲット フィーチャと接している場合にマッチします。 ターゲット フィーチャおよび結合フィーチャがラインまたはポリゴンであるとき、結合フィーチャの境界線は、ターゲット フィーチャの境界線と接することができるだけで、結合フィーチャのいずれの部分もターゲット フィーチャの境界線と重なることはできません。 CROSSES—結合フィーチャのフィーチャは、その境界線がターゲット フィーチャと交差する場合にマッチします。 結合フィーチャおよびターゲット フィーチャは、ラインまたはポリゴンのいずれかである必要があります。 結合フィーチャまたはターゲット フィーチャとしてポリゴンが使用される場合には、ポリゴンの境界線 (ライン) が使用されます。 ポイントで交差するラインはマッチしますが、線分を共有するラインはマッチしません。 OVERLAPS—結合フィーチャのフィーチャは、ターゲット フィーチャと重複するときにマッチします。	String
spatial_near_distance (オプション)	空間結合の対象として検討される結合フィーチャ内のターゲット フィーチャからの距離。 検索範囲は、spatial_relationship パラメーター値が NEAR または NEAR_GEODESIC の場合のみ有効になります。	Linear Unit
temporal_relationship (オプション)	フィーチャの一致に使用する時間条件を指定します。 MEETS—ターゲット フィーチャの終了時間が結合フィーチャの開始時間に等しい場合、ターゲット フィーチャは結合フィーチャに接続します。 MET_BY—ターゲット フィーチャの開始時間が結合フィーチャの終了時間に等しい場合、結合フィーチャはターゲット フィーチャに接続します。 OVERLAPS—ターゲット時間間隔の開始と終了がそれぞれ、結合時間間隔の開始と終了より前である場合、ターゲット時間は結合時間にオーバーラップします。 OVERLAPPED_BY—ターゲット時間間隔の開始と終了がそれぞれ、結合時間間隔の開始と終了より後である場合、ターゲット時間は結合時間にオーバーラップされます。 DURING—ターゲット フィーチャが結合フィーチャの開始と終了の間に発生する場合、ターゲット フィーチャの期間は結合フィーチャの期間内にあります。 CONTAINS—結合フィーチャがターゲット フィーチャの開始と終了の間に発生する場合、ターゲット フィーチャの期間は結合フィーチャの期間内にあります。 EQUALS—2 つの時間は、それらの特定の時点または間隔が同一である場合に、等しいと見なされます。 FINISHES—ターゲット フィーチャと結合フィーチャの終了が同じ時間であり、ターゲット フィーチャが結合フィーチャの後に開始する場合です。 FINISHED_BY—結合フィーチャ時間がターゲット時間と同時に終了し、結合時間がターゲット時間の後に開始する場合、ターゲット時間は結合時間により終了され (Finished by) ます。 STARTS—ターゲット時間が、結合時間間隔と同じ時間に開始し、結合時間間隔が終了する前に終了する場合、ターゲット時間が結合時間を開始します。 STARTED_BY—ターゲット フィーチャと結合フィーチャの開始が同じ時間であり、ターゲット フィーチャが結合フィーチャの後に終了する場合です。 INTERSECTS—ターゲット フィーチャの時間のいずれかの部分が結合フィーチャの時間と交わります。 NEAR—ターゲット フィーチャの時間が結合フィーチャの時間から指定された時間の範囲内にある場合です。 NEAR_BEFORE—ターゲット フィーチャの時間が結合フィーチャの時間の前だが、結合フィーチャの時間から指定された時間の範囲内にある場合です。 このオプションは、ArcGIS Enterprise 10.6 以降に追加されています。 NEAR_AFTER—ターゲット フィーチャの時間が結合フィーチャの時間の後だが、結合フィーチャの時間から指定された時間の範囲内にある場合です。 このオプションは、ArcGIS Enterprise 10.6 以降に追加されています。	String
temporal_near_distance (オプション)	空間結合の対象として検討される結合フィーチャ内のターゲット フィーチャからの時間距離。 時間は、temporal_relationship パラメーター値が NEAR、NEAR_BEFORE、または NEAR_AFTER であり、両方のフィーチャが時間対応である場合にのみ有効です。	Time Unit
attribute_relationship [attribute_relationship,...] (オプション)	属性フィールドの値に基づいてフィーチャを結合します。 結合レイヤーの属性フィールドにマッチするターゲット レイヤーの属性フィールドを指定します。 ターゲット フィールド - マッチする値を含んでいるターゲット レイヤーの属性フィールド。 結合フィールド - マッチする値を含んでいる結合レイヤーの属性フィールド。	Value Table
summary_fields [summary_fields,...] (オプション)	指定されたフィールドに関して計算される統計情報。 COUNT - NULL 値でない値の数。 数値フィールドまたは文字列に使用できます。 [null, 0, 2] の個数は 2 です。 SUM - フィールド内の数値の合計。 [null, null, 3] の合計は 3 です。 MEAN - 数値の平均。 [0,2, null] の平均は 1 です。 MIN - 数値フィールドの最小値。 [0, 2, null] の最小は 0 です。 MAX - 数値フィールドの最大値。 [0, 2, null] の最大値は 2 です。 STDDEV - 数値フィールドの標準偏差。 [1] の標準偏差は null です。 [null, 1,1,1] の標準偏差は null です。 VAR - トラッキング内の数値フィールドの分散。 [1] の分散は null です。 [null, 1,1,1] の分散は null です。 RANGE - 数値フィールドの範囲。 これは、最大値から最小値を減算して計算されます。 [0, null, 1] の範囲は 1 です。 [null, 4] の範囲は 0 です。 ANY - 文字列型のフィールドのサンプル文字列。	Value Table
join_condition (オプション)	条件を指定のフィールドに適用します。 これらの条件を満たしているフィールドを含むフィーチャだけが結合されます。 たとえば、結合レイヤー内の属性 HealthSpending がターゲット レイヤー内の属性 Income の 20% よりも大きい場合に、結合条件をフィーチャに適用できます。 ArcGIS Enterprise 10.5 および 10.5.1 では、この式の適用に使用される結合条件は join["HealthSpending"] > target["Income"] * .2 です。 ArcGIS Enterprise 10.6 以降では、$join["HealthSpending"] > $target["Income"] * .2 のような Arcade 式を使用します。	String
data_store (オプション)	出力が格納される ArcGIS Data Store を指定します。 ビッグ データ ストアに格納されたすべての結果は、WGS84 で保存されます。 リレーショナル データ ストアに格納された結果は、それらの座標系を維持します。 SPATIOTEMPORAL_DATA_STORE—出力がビッグ データ ストアに格納されます。 これがデフォルトです。 RELATIONAL_DATA_STORE—出力がリレーショナル データ ストアに格納されます。	String
keep_all_target_features (オプション)	出力フィーチャクラスにすべてのターゲット フィーチャを保持するか (左外部結合)、結合フィーチャとのリレーションシップが指定されたターゲット フィーチャのみを保持するか (内部結合) を指定します。 KEEP_ALL—出力にすべてのターゲット フィーチャが保存されます。 KEEP_COMMON—出力フィーチャクラスに、リレーションシップが指定されたターゲット フィーチャのみが保存されます。 これがデフォルトです。	Boolean
include_distance (オプション)	空間距離または時間差を結果に含めるかどうかを指定します。 このパラメーターは、join_operation パラメーター値が JOIN_ONE_TO_MANY で、spatial_relationship パラメーター値が NEAR または NEAR_GEODESIC、temporal_relationship パラメーター値が NEAR、NEAR_BEFORE、または NEAR_AFTER である場合にアクティブになります。 INCLUDE_DISTANCE—空間距離または時間差を結果に含めます。 NO_INCLUDE_DISTANCE—空間距離も時間差も結果に含めません。 これがデフォルトです。	Boolean
distance_unit (オプション)	出力フィーチャクラスの距離値に使用する計測単位を指定します。 METERS—計測単位はメートルです。 これがデフォルトです。 KILOMETERS—計測単位はキロメートルです。 MILES—計測単位は米国測量マイルです。 NAUTICAL_MILES—計測単位は米国測量海里です。 YARDS—計測単位は米国測量ヤードです。 FEET—計測単位は米国測量フィートです。 MILES_INT—計測単位は法定マイルです。 NAUTICAL_MILES_INT—計測単位は国際海里です。 YARDS_INT—計測単位は国際ヤードです。 FEET_INT—計測単位は国際フィートです。	String

派生した出力

名前	説明	データ タイプ
output	結合後の出力。	Record Set

コードのサンプル

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

次のスタンドアロン スクリプトで、JoinFeatures 関数を使用する方法を示します。

# Name: JoinFeatures.py
# Description: Join crime events that are close together in time and space, and 
#              return the count of nearby crimes. This example is a self join 
#              (joining the same layer to itself).
# Requirements: ArcGIS GeoAnalytics Server 

# Import system modules 
import arcpy 

# Set local variables 
inFeatures = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Crimes/BigDataCatalogServer/Chicago"
spatialOperation = "NEAR" 
nearDistance = "1 Kilometers" 
temporalOperation = "NEAR" 
nearTime = "3 Hours" 
outFS = "CloseCrimes" 
dataStore = "SPATIOTEMPORAL_DATA_STORE" 

# Run Join Features
arcpy.geoanalytics.JoinFeatures(inFeatures, inFeatures, outFS, "JOIN_ONE_TO_ONE", 
                                spatialOperation, nearDistance, temporalOperation, 
                                nearTime, None, None, None, dataStore)

環境

出力座標系, 範囲, 現在のワークスペース

特殊なケース

出力座標系

解析で使用される座標系。 このパラメーターで指定されない限り、入力の座標系で解析が行われます。 GeoAnalytics Tools の場合、最終結果は WGS84 のビッグ データ ストアに保存されます。

ライセンス情報

• Basic: 次のものが必要 ArcGIS GeoAnalytics Server
• Standard: 次のものが必要 ArcGIS GeoAnalytics Server
• Advanced: 次のものが必要 ArcGIS GeoAnalytics Server