バッファーの作成 (Create Buffers) (GeoAnalytics)

サマリー

指定した距離に基づき、入力フィーチャの周囲にバッファーを作成します。

レガシー:

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

使用法

  • [方法] パラメーターでは、バッファーの作成方法を指定します。 バッファーの基本的な作成方法には、ユークリッドおよび測地線という 2 つの方法があります。

    • ユークリッド バッファーは、二次元のデカルト平面内で距離を計測します。そこでは、直線距離、すなわちユークリッド距離が、平面 (デカルト平面) 上の 2 点間で計算されます。 ユークリッド バッファーの方が一般的なバッファーであり、投影座標系で比較的狭い領域 (UTM ゾーンなど) に集中するフィーチャの周辺の距離を解析する場合に適しています。 ユークリッド バッファーは、平面バッファーと呼ばれます。
    • 測地線バッファーは、地球の実際の形状 (楕円体、より正確にはジオイド) を形成します。 平面 (デカルト平面) 上の 2 点間ではなく、曲面 (ジオイド) 上の 2 点間の距離が計算されます。 以下の状況の場合、測地線バッファーを作成することを検討してください。
      • 入力フィーチャが分散している場合 (複数の UTM ゾーン、広い領域、または地球全体をカバーしている場合)。
      • 入力フィーチャの空間参照 (地図投影法) によって、面積などの他の特性を保護するために距離が歪んでしまう場合。

  • 測地線バッファーは平面マップ上では異常な外観を示すことがありますが、これらのバッファーをグローブに表示した場合、正常な外観になります。

  • [方法] パラメーターでは、バッファーの作成方法を指定します。

    • 入力フィーチャの座標系に基づいて、平面が、使用する方法を自動的に決定します。
      • 入力フィーチャで投影座標系が使用されている場合、ユークリッド バッファーが作成されます。
      • 入力フィーチャで地理座標系が使用されている場合、測地線バッファーが作成されます。
    • デフォルトは測地線です。 測地線方法を指定すると、入力座標系にかかわらず、形状が正確に維持された測地線バッファーが作成されます。 形状を維持した測地線バッファーは、出力の測地線バッファーを作成する前に、入力フィーチャを高密度化します。 これにより、入力フィーチャの形状をより厳密に表現したバッファーを作成します。 バッファーの形状と、その形状が元の入力フィーチャにどの程度近似しているのかが気になる場合 (とりわけ入力データが地理座標系を使用している場合) は、このオプションを使用することをおすすめします。 このオプションを使用すると、平面オプションを使用して測地線バッファーを作成する場合よりも時間がかかることがありますが、入力フィーチャの形状に正確に一致したバッファーが作成されます。

  • 平面方法を使用する際は、正距円錐図法や正距方位図法などの、距離の歪みを最小にし、地理的に入力に適した投影法を使用することで、投影された入力から作成されるバッファーの精度を上げることができます。

  • ポリゴン フィーチャをバッファー処理する際には、負数のバッファー距離を使用してポリゴン フィーチャ内部にバッファーを作成することができます。 負数のバッファー距離を使用すると、ポリゴンの境界を指定距離分減らすことができます。

    注意:

    負数のバッファー距離が大きすぎてポリゴンが消失する場合は、NULL ジオメトリが生成されます。 警告メッセージが表示され、NULL ジオメトリのフィーチャは出力データセットに書き出されません。

  • バッファーのサイズは、以下の 3 つのうちいずれかのオプションで入力できます。

    • [距離] - 定数値を使用 (すべてのバッファーは同じサイズ)
    • [フィールド] - フィールドの値を使用 (フィーチャによってバッファーのサイズが異なることがあります)。
    • [式] - 各フィーチャに条件式を適用 (条件式に基づき、フィーチャごとに値が異なることがあります)

      バッファー条件式の適用の詳細

  • デフォルトでは、[バッファーの作成] ツールは、バッファー エリア同士が交わる場合、重なり合うバッファーを作成します。 入力フィーチャがエリアの場合、入力エリアがバッファー内に含まれます。 ディゾルブおよびマルチマート パラメーターを使用すると、重なり合うバッファーをコントロールできます。 ディゾルブ オプションには、次の 3 つがあります。

    • [なし] - バッファーは、バッファー領域が交わる部分でオーバーラップします。 これがデフォルトです。
    • [すべて] - すべてのフィーチャがディゾルブします。 すべてのフィーチャが 1 つのフィーチャにディゾルブするか (マルチパートが true)、重複フィーチャのみがディゾルブするか (マルチパートが false) は、マルチパート パラメーターが決定します。
    • [フィールド] - フィーチャは、フィールド値に基づいてディゾルブします。 1 つまたは複数のフィールドを選択すると、類似の値はディゾルブします。 一致するすべてのフィールド フィーチャが 1 つのフィーチャにディゾルブするか (マルチパートが true)、一致する重複フィールド フィーチャのみがディゾルブするか (マルチパートが false) は、マルチパート パラメーターが決定します。

  • [入力レイヤー] パラメーターのフィールドをバッファー距離の取得に使用する場合、フィールド値として、数値 (5 など) または有効な距離単位の付いた数値 (5 キロメートルなど) のいずれかを使用できます。 フィールド値が数値の場合、距離には、[入力レイヤー] パラメーターの空間参照の距離単位を使用すると見なされます。ただし、[入力レイヤー] が地理座標系の場合を除きます。地理座標系の場合、値はメートル単位と見なされます。 フィールド値に指定された距離単位が無効であるか、認識できない場合、デフォルトで入力フィーチャの空間参照の距離単位が使用されます。

  • [すべて] または [フィールド] でディゾルブすると、統計を計算できます。 統計は、すべてのフィーチャまたはフィールド値のディゾルブにのみ適用され、地理的には適用されません (マルチパート パラメーターを使用)。 以下の図に示す 6 つのフィーチャで、これらのオプションがどのように機能するかを次のテーブルに示します。 フィールドのディゾルブに使用されるフィーチャ値は色分けされています (青かオレンジ)。

    バッファーのディゾルブの例に使用する入力ポイント

    ディゾルブ オプションマルチパートが false (デフォルト)マルチパートが true
    なし
    ディゾルブが適用されていないバッファー オプション

    6 つのフィーチャは、バッファーされたフィーチャにディゾルブが適用されていないときに作成されます。 これがデフォルトです。 これは、標準解析ツールの [オーバーラップ] オプションと同じです。

    マルチパートは、ディゾルブ オプションが [なし] の場合には true にはなりません。

    すべて
    マルチパートが false ですべてのフィーチャがディゾルブしている状態

    すべての値がディゾルブされ、マルチパートが false の場場合には、3 つのフィーチャが作成されます。 ディゾルブされるのは、重なり合うフィーチャのみです。 これは、標準解析ツールの [ディゾルブ] オプションと同じです。

    マルチパートが true ですべてのフィーチャがディゾルブしている状態

    すべての値がディゾルブされ、マルチパートが true の場合には、1 つのフィーチャが作成されます。 このオプションを選択すると、結果は常に 1 つのフィーチャになります。

    フィールド
    類似した値を持つフィーチャが、マルチパート false でディゾルブされる

    フィールドに基づいて (ここでは、フィールドは入力ポイントの色) ディゾルブが適用される場合には、4 つのフィーチャが作成されます。 指定フィールドと同じ値を持つ、重なり合うフィーチャのみがディゾルブします。

    類似した値を持つフィーチャが、マルチパート true でディゾルブされる

    フィールドに基づいて (ここでは、フィールドは入力ポイントの色) ディゾルブが適用され、マルチパートが許可されている場合には、2 つのフィーチャが作成されます。 同じフィールド値を持つ値は、常に 1 つのフィーチャになります。

  • 条件式のバッファー タイプを使用して、数値フィールドおよび数学演算子から式を作成できます。 詳細については、「ArcGIS Enterprise 10.5 および 10.5.1 のバッファー条件式」または「ArcGIS Enterprise 10.6 以降のバッファー条件式」をご参照ください。 特に指定しない限り、バッファー式内の数値はメートル単位であると仮定されます。

  • 出力データセットには、各フィーチャのバッファー処理に使用するバッファー距離が、入力フィーチャの座標系の距離単位で格納される BUFF_DIST があります。 出力座標系を設定する場合、BUFF_DIST の単位はこの座標系になります。 同じフィールドが出力内にすでに存在している場合は、フィールド名の重複を回避するために、その名前の末尾に番号が付加されます (たとえば、BUFF_DIST1)。

  • 次の 1 つまたは複数の操作を実行して、[バッファーの作成 (Create Buffers)] ツールのパフォーマンスを向上させることができます。

    • 対象データのみが解析されるように、範囲環境を設定します。
    • 平面バッファーを使用します。
    • バッファーの結果をディゾルブしないでください。
    • 解析が実行されている場所に対してローカルなデータを使用します。

  • ジオプロセシング ツールは、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 を使用してビッグ データ ファイル共有を作成する方法の詳細

  • 次のツールを使用して、類似の解析を実行することもできます。

パラメーター

ラベル説明データ タイプ
入力レイヤー

バッファーされるポイント フィーチャ、ポリライン フィーチャ、またはポリゴン フィーチャ。

Feature Set
出力名

出力フィーチャ サービスの名前。

String
方法

バッファーの作成に使用する方法を指定します。

  • 測地線バッファーは、入力データの座標系にかかわらず、形状を維持した測地線バッファー方法を使用して作成されます。 これがデフォルトです。
  • 平面入力フィーチャで投影座標系が使用されている場合、ユークリッド バッファーが作成されます。 入力フィーチャで地理座標系が使用されている場合、測地線バッファーが作成されます。 出力座標系環境設定を使用して座標系を指定できます。
String
バッファー タイプ
(オプション)

バッファー距離の定義方法を指定します。

  • 距離すべてのフィーチャに同じ直線距離が適用されます。
  • フィールドバッファー距離を表す数値フィールドまたは文字列フィールドを選択します。
  • バッファー距離を表すフィールド、定数、数学演算子を使用して式を構築します。
String
バッファー フィールド
(オプション)

フィーチャごとのバッファー距離を含んでいるフィールド。 フィールド値が数値の場合、距離には、[入力レイヤー] の値の空間参照の距離単位を使用すると見なされます。ただし、[入力レイヤー] の値が地理座標系の場合を除きます。地理座標系の場合、値はメートル単位と見なされます。 フィールド値に指定された距離単位が無効であるか、認識できない場合、デフォルトで入力フィーチャの空間参照の距離単位が使用されます。

Field
バッファー距離
(オプション)

バッファーされる入力フィーチャの周囲の距離。

Linear Unit
バッファー式
(オプション)

各フィーチャへのバッファーとして適用される、フィールドおよび数学演算子を使用する式。 フィールドは数値である必要があり、式には [+ - * / ] 演算子と複数のフィールドを含めることができます。 特に指定しない限り、計算される値はメートル単位で適用されます。 たとえば、distance という名前の数値フィールド (単位: km) に 2 を乗算して 15 m を加えるバッファーを適用するとします。

ArcGIS Enterprise 10.5 および 10.5.1 の式は as_kilometers(distance) * 2 + as_meters(15) と表されます。 ArcGIS Enterprise 10.6 以降では、as_kilometers($feature["distance"]) * 2 + as_meters(15) のような Arcade 式を使用します。

レイヤーをマップに追加する場合、[フィールド] および [ヘルパー] フィルターを使って式を組み立てることができます。

Calculator Expression
ディゾルブ オプション
(オプション)

ディゾルブ オプションを指定すると、バッファーの重複が削除されます。

  • なし重複の有無にかかわらず、各フィーチャの個々のバッファーが維持されます。 これがデフォルトです。
  • すべてすべてのバッファーが 1 つのフィーチャにディゾルブされ、すべての重複が削除されます。
  • リスト(入力フィーチャから引き継がれる) リスト フィールドの属性値を共有するバッファーがディゾルブされます。
String
ディゾルブ フィールド
(オプション)

出力バッファーをディゾルブするために使用される入力フィーチャからの 1 以上のフィールドのリスト。 リスト表示されたフィールド内の属性値を共有しているバッファーが、ディゾルブされます。 このパラメーターは、[ディゾルブ オプション][リスト] の場合にのみ必須です。

Field
サマリー フィールド
(オプション)

数値フィールドと文字列フィールドに適用される統計を指定します。 空のままにした場合、数のみが計算されます。 これらの統計は、[ディゾルブ オプション][リスト] または [すべて] の場合にのみ適用されます。

  • [個数] - NULL 値でない値の数。 数値フィールドまたは文字列に使用できます。 [null, 0, 2] の個数は 2 です。
  • [合計] - フィールド内の数値の合計。 [null, null, 3] の合計は 3 です。
  • [平均] - 数値の平均。 [0, 2, null] の平均は 1 です。
  • [最小] - 数値フィールドの最小値。 [0, 2, null] の最小は 0 です。
  • [最大] - 数値フィールドの最大値。 [0, 2, null] の最大値は 2 です。
  • [標準偏差] - 数値フィールドの標準偏差。 [1] の標準偏差は null です。 [null, 1,1,1] の標準偏差は null です。
  • [分散] - トラッキング内の数値フィールドの分散。 [1] の分散は null です。 [null, 1, 1, 1] の分散は null です。
  • [範囲] - 数値フィールドの範囲。 これは、最大値から最小値を減算して計算されます。 [0, null, 1] の範囲は 1 です。 [null, 4] の範囲は 0 です。
  • [任意] - 文字列型のフィールドのサンプル文字列。

Value Table
マルチパート
(オプション)

マルチパート フィーチャを作成するかどうかを指定します。

  • オン - 必要に応じて出力マルチパート フィーチャが作成されます。
  • オフ - マルチパート フィーチャが作成されない代わりに、各パーツにフィーチャが個別に作成されます。 これがデフォルトです。
Boolean
データ ストア
(オプション)

出力が格納される ArcGIS Data Store を指定します。 ビッグ データ ストアに格納されたすべての結果は、WGS84 で保存されます。 リレーショナル データ ストアに格納された結果は、それらの座標系を維持します。

  • ビッグ データ ストア出力がビッグ データ ストアに格納されます。 これがデフォルトです。
  • リレーショナル データ ストア出力がリレーショナル データ ストアに格納されます。
String

派生した出力

ラベル説明データ タイプ
出力フィーチャクラス

出力バッファー フィーチャ。

Feature Set

arcpy.geoanalytics.CreateBuffers(input_layer, output_name, method, {buffer_type}, {buffer_field}, {buffer_distance}, {buffer_expression}, {dissolve_option}, {dissolve_fields}, {summary_fields}, {multipart}, {data_store})
名前説明データ タイプ
input_layer

バッファーされるポイント フィーチャ、ポリライン フィーチャ、またはポリゴン フィーチャ。

Feature Set
output_name

出力フィーチャ サービスの名前。

String
method

バッファーの作成に使用する方法を指定します。

  • GEODESICバッファーは、入力データの座標系にかかわらず、形状を維持した測地線バッファー方法を使用して作成されます。 これがデフォルトです。
  • PLANAR入力フィーチャで投影座標系が使用されている場合、ユークリッド バッファーが作成されます。 入力フィーチャで地理座標系が使用されている場合、測地線バッファーが作成されます。 出力座標系環境設定を使用して座標系を指定できます。
String
buffer_type
(オプション)

バッファー距離の定義方法を指定します。

  • DISTANCEすべてのフィーチャに同じ直線距離が適用されます。
  • FIELDバッファー距離を表す数値フィールドまたは文字列フィールドを選択します。
  • EXPRESSIONバッファー距離を表すフィールド、定数、数学演算子を使用して式を構築します。
String
buffer_field
(オプション)

フィーチャごとのバッファー距離を含んでいるフィールド。 フィールド値が数値の場合、距離には、input_layer の値の空間参照の距離単位を使用すると見なされます。ただし、input_layer の値が地理座標系の場合を除きます。地理座標系の場合、値はメートル単位と見なされます。 フィールド値に指定された距離単位が無効であるか、認識できない場合、デフォルトで入力フィーチャの空間参照の距離単位が使用されます。

Field
buffer_distance
(オプション)

バッファーされる入力フィーチャの周囲の距離。

Linear Unit
buffer_expression
(オプション)

各フィーチャへのバッファーとして適用する、フィールドおよび数学演算子を使用した式。 フィールドは数値である必要があり、式には [ + - * / ] 演算子と複数のフィールドを含めることができます。 特に指定しない限り、計算される値はメートル単位で適用されます。 たとえば、distance という名前のキロメートル単位の数値フィールドに 2 を掛けて 15 メートルを足すバッファーを適用します。

ArcGIS Enterprise 10.5 および 10.5.1 の式は as_kilometers(distance) * 2 + as_meters(15) と表されます。 ArcGIS Enterprise 10.6 以降では、as_kilometers($feature["distance"]) * 2 + as_meters(15) などの Arcade 式を使用します。

Calculator Expression
dissolve_option
(オプション)

ディゾルブ オプションを指定すると、バッファーの重複が削除されます。

  • NONE重複の有無にかかわらず、各フィーチャの個々のバッファーが維持されます。 これがデフォルトです。
  • ALLすべてのバッファーが 1 つのフィーチャにディゾルブされ、すべての重複が削除されます。
  • LIST(入力フィーチャから引き継がれる) リスト フィールドの属性値を共有するバッファーがディゾルブされます。
String
dissolve_fields
[dissolve_fields,...]
(オプション)

出力バッファーをディゾルブするために使用される入力フィーチャからの 1 以上のフィールドのリスト。 リスト表示されたフィールド内の属性値を共有しているバッファーが、ディゾルブされます。 このパラメーターは、dissolve_optionLIST の場合にのみ必須です。

Field
summary_fields
[summary_fields,...]
(オプション)

数値フィールドと文字列フィールドに適用される統計を指定します。 空のままにした場合、数のみが計算されます。 これらの統計は、dissolve_optionLIST または ALL の場合にのみ適用されます。

  • 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
multipart
(オプション)

マルチパート フィーチャを作成するかどうかを指定します。

  • MULTI_PART必要に応じて出力マルチパート フィーチャが作成されます。
  • SINGLE_PARTマルチパート フィーチャが作成されない代わりに、各パーツにフィーチャが個別に作成されます。 これがデフォルトです。
Boolean
data_store
(オプション)

出力が格納される ArcGIS Data Store を指定します。 ビッグ データ ストアに格納されたすべての結果は、WGS84 で保存されます。 リレーショナル データ ストアに格納された結果は、それらの座標系を維持します。

  • SPATIOTEMPORAL_DATA_STORE出力がビッグ データ ストアに格納されます。 これがデフォルトです。
  • RELATIONAL_DATA_STORE出力がリレーショナル データ ストアに格納されます。
String

派生した出力

名前説明データ タイプ
output

出力バッファー フィーチャ。

Feature Set

コードのサンプル

CreateBuffers (Python ウィンドウ)

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


# Name: CreateBuffers.py
# Description: Buffer damaged building by 300 meters

# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inFeatures = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/DamageAssessment/FeatureServer/0"
outFS = "DangerousAreas"
dataStore = "SPATIOTEMPORAL_DATA_STORE"

# Run Create Buffers
arcpy.geoanalytics.CreateBuffers(inFeatures, outFS, "GEODESIC", "DISTANCE", 
                                 None, "300 Meters", None, "ALL", None, None, 
                                 "SINGLE_PART", dataStore)

環境

特殊なケース

出力座標系

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

ライセンス情報

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

関連トピック