近接情報テーブルの生成(Generate Near Table) (解析)

ライセンス レベル:BasicStandardAdvanced

サマリ

1 つ以上のフィーチャクラスまたはレイヤ内のフィーチャ間の、距離などの近接情報を計算します。入力を変更する [最近接(Near)] ツールとは異なり、[近接情報テーブルの生成(Generate Near Table)] は、結果を新しいスタンドアロン テーブルに書き込み、複数の近接フィーチャの検索をサポートします。

ジオプロセシング ツールによる近接性の計算方法の詳細

近接情報テーブルの生成(Generate Near Table)

使用法

構文

GenerateNearTable_analysis (in_features, near_features, out_table, {search_radius}, {location}, {angle}, {closest}, {closest_count}, {method})
パラメータ説明データ タイプ
in_features

ポイント、ポリライン、ポリゴン、またはマルチポイント タイプの入力フィーチャ。

Feature Layer
near_features
[near_features,...]

近接フィーチャの候補が含まれるフィーチャクラスの 1 つ以上のレイヤ。近接フィーチャとして、ポイント、ポリライン、ポリゴン、またはマルチポイントを使用できます。複数のレイヤまたはフィーチャクラスを指定した場合、NEAR_FC という名前のフィールドが入力テーブルに追加されます。このフィールドには、検出された最近接フィーチャを含むソース フィーチャクラスのパスが格納されます。同じフィーチャクラスまたはレイヤを、入力フィーチャと近接フィーチャの両方に使用することができます。

Feature Layer
out_table

解析結果が格納される出力テーブル。

Table
search_radius
(オプション)

近接フィーチャの検索に使用される半径。この値を指定しない場合、すべての近接フィーチャが候補になります。距離を入力して、単位を空白のままにするか、[不明] に設定した場合、入力フィーチャの座標系の単位が使用されます。 [メソッド] パラメータで検索範囲オプションを使用した場合、キロメートルやマイルなどの距離単位を使用する必要があります。

Linear unit
location
(オプション)

入力フィーチャの位置および最も近い近接フィーチャの位置の XY 座標を、FROM_XFROM_YNEAR_X、および NEAR_Y の各フィールドに書き込むかどうかを指定します。

  • NO_LOCATION 出力テーブルに位置を書き込みません。これはデフォルト設定です。
  • LOCATION 出力テーブルに位置を書き込みます。
Boolean
angle
(オプション)

近接角度を計算して出力テーブルの NEAR_ANGLE フィールドに書き込むかどうかを指定します。近接角度は、入力フィーチャとその最近接フィーチャを最も近い位置で接続するラインの方向を示します。method パラメータで PLANAR を使用した場合、角度の範囲は -180 〜 180°になり、0°は東、90°は北、180°(または -180°)は西、-90°は南を示します。GEODESIC を使用した場合、角度の範囲は -180 〜 180°になり、0°は北、90°は東、180°(または -180°)は南、-90°は西を示します。

  • NO_ANGLE 出力テーブルに NEAR_ANGLE を追加しません。これはデフォルト設定です。
  • ANGLE 出力テーブルに NEAR_ANGLE を追加します。
Boolean
closest
(オプション)

最近接フィーチャのみを返すか、あるいは複数のフィーチャを返すかを指定します。

  • CLOSEST最近接フィーチャのみを出力テーブルに書き込みます。これはデフォルト設定です。
  • ALL複数の近接フィーチャを出力テーブルに書き込みます(この最大数は、closest_count パラメータで指定できます)。
Boolean
closest_count
(オプション)

入力フィーチャごとにレポートされる近接フィーチャの数を制限します。このパラメータは、closest パラメータを CLOSEST に設定した場合、無視されます。

Long
method
(オプション)

楕円体(GEODESIC)または平面地球(PLANAR)のどちらで最短経路を使用するかを指定します。データが、距離の測定に適さない座標系(たとえば、Web メルカトルや任意の地理座標系)で格納されている場合、またはデータセットが広い地理範囲に広がっている場合、GEODESIC を使用することを強くお勧めします。

  • PLANARフィーチャ間で平面距離を使用します。これはデフォルト設定です。
  • GEODESICフィーチャ間で測地距離を使用します。この方法では、楕円体の曲率を考慮して、日付変更線と極の近くのデータを正確に処理します。
String

コードのサンプル

GenerateNearTable(近接情報テーブルの作成)の例 1(Python ウィンドウ)

Python ウィンドウで GenerateNearTable(近接情報テーブルの作成)関数を使用する方法を以下に示します。

import arcpy

arcpy.env.workspace = "C:/data/input/gnt.gdb"

arcpy.GenerateNearTable_analysis("campsites", ["parks", "trails"], "better_sites")
GenerateNearTable(近接情報テーブルの作成)の例 2(スタンドアロン Python スクリプト)

次の Python スクリプトは、スタンドアロン スクリプトで GenerateNearTable(近接情報テーブルの作成)関数を使用する方法を示しています。

# Name: GenerateNearTable.py
# Description: Finds 3 nearest in the near feature class from the input feature class.


# import system modules
import arcpy

# set workspace environment
arcpy.env.workspace = "C:/data/input/gnt.gdb"

# set required parameters 
in_features = "campsites"
near_features = ["parks", "trails"]
out_table = "near_parks_trails"

# optional parameters
search_radius = '1500 Meters'
location = 'NO_LOCATION'
angle = 'NO_ANGLE'
closest = 'ALL'
closest_count = 3

# find crime locations within the search radius
arcpy.GenerateNearTable_analysis(in_features, near_features, out_table, search_radius, 
                                 location, angle, closest, closest_count)

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: ×
ArcGIS for Desktop Standard: ×
ArcGIS for Desktop Advanced: ○
5/10/2014