最近接 (解析ツール)

サマリー

1 つ以上のフィーチャクラスまたはレイヤー内のフィーチャ間の、距離などの近接情報を計算します。

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

図

最近接ツールの図 — ジオメトリータイプ別の近接フィーチャの検索が示されています。

使用法

以下のフィールドが入力に追加されます。これらのフィールドがすでに存在する場合、フィールドの値が更新されます。これらのフィールド名は、フィールド名 パラメーターを使用して構成できます。
- NEAR_FID—最近接フィーチャのオブジェクト ID。近接フィーチャが見つからない場合、この値は -1 になります。
- NEAR_DIST—入力フィーチャから近接フィーチャまでの距離。この値の単位は、方法パラメーターが 測地線 に設定され、入力で地理座標系が使用されている場合、入力フィーチャの座標系の距離単位、つまりメートルです。近接フィーチャが見つからない場合、この値は -1 になります。
- NEAR_FC—見つかった最近接フィーチャを含むソースフィーチャクラスのパス。レイヤーが入力として使用される場合は、レイヤー名が使用され、パスが入力として使用される場合は、フィーチャクラスへのカタログパスが使用されます。このフィールドは、複数の近接フィーチャが指定された場合にのみ出力テーブルに追加されます。近接フィーチャが見つからない場合、この値は空の文字列または NULL になります。
位置パラメーターがオンの場合、以下のフィールドが入力に追加されます。フィールドがすでに存在する場合、フィールドの値が更新されます。フィールド値の単位は、方法パラメーターの値によって異なります。方法パラメーターが平面に設定されている場合、フィールド値は入力フィーチャの座標系の距離単位で表されます。 測地線 に設定されている場合、フィールド値は入力フィーチャの座標系に関連付けられた地理座標系で表されます。
- NEAR_X—入力フィーチャに最も近い近接フィーチャの位置の X 座標。近接フィーチャが見つからない場合、この値は -1 になります。
- NEAR_Y—入力フィーチャに最も近い近接フィーチャの位置の Y 座標。近接フィーチャが見つからない場合、この値は -1 になります。
角度パラメーターがオンの場合、以下のフィールドが入力フィーチャに追加されます。フィールドがすでに存在する場合は、フィールドの値が更新されます。
- NEAR_ANGLE—入力フィーチャを近接フィーチャに接続するラインの、FROM_X と FROM_Y の位置での角度。近接フィーチャが見つからない場合、または近接フィーチャが入力フィーチャと交差する場合、この値は 0 になります。
検索範囲内にフィーチャがない場合、NEAR_FID と NEAR_DIST の値は -1 になります。
入力フィーチャと近接フィーチャにはどちらも、ポイント、マルチポイント、ライン、またはポリゴンを指定できます。
近接フィーチャ パラメーター値には、さまざまな形状タイプ (ポイント、マルチポイント、ライン、またはポリゴン) の 1 つ以上のフィーチャクラスを含めることができます。
単一のフィーチャクラスやレイヤー内で距離や追加の近接情報を計算するには、同じフィーチャクラスまたはレイヤーを使用できます。その場合、すべてのフィーチャの最近接フィーチャがそのフィーチャ自体になることを防ぐために、評価対象の入力フィーチャは、近接フィーチャの候補から除外されます。
これらの入力フィーチャには、選択を実行したレイヤーを指定できます。ツールの操作中に、選択したフィーチャが使用および更新されます。残りのフィーチャでは、新しく作成されたフィールド (NEAR_FID や NEAR_DIST など) の値が -1 に設定されます。
入力フィーチャからの最短距離が等しい複数の近接フィーチャが存在する場合、そのうちの 1 つが最近接フィーチャとしてランダムに選択されます。
方法パラメーターで平面オプションを使用する場合は、距離の測定に適した投影法 (正距方位図法など) を入力フィーチャに使用します。

座標系と投影法の詳細
NEAR_X および NEAR_Y の位置を視覚化するには、出力テーブルを、XY イベントレイヤーの作成 ツールまたは XY 座標 → ライン ツールへの入力として使用します。
You can set a unit of measurement for the NEAR_DIST 距離単位 パラメーターを使用して、メートル、キロメートル、マイルなどのフィールドを使用できます。
このツールは、複数の 近接フィーチャ パラメーター値の入力ごとに最近接フィーチャの検出をサポートしています。

ラベル	説明	データタイプ
入力フィーチャ	ポイント、ポリライン、ポリゴン、またはマルチポイントタイプを指定できる入力フィーチャ。	Feature Layer
近接フィーチャ	近接フィーチャの候補が含まれる 1 つ以上のフィーチャレイヤーまたはフィーチャクラス。近接フィーチャとして、ポイント、ポリライン、ポリゴン、またはマルチポイントを使用できます。複数のレイヤーまたはフィーチャクラスを指定した場合、`NEAR_FC` フィールドが入力テーブルに追加されます。このフィールドには、検出された最近接フィーチャを含むソースフィーチャクラスのパスが格納されます。同じフィーチャクラスまたはレイヤーを、入力フィーチャと近接フィーチャの両方に使用することができます。	Feature Layer
検索半径 (オプション)	近接フィーチャの検索に使用される半径。この値を指定しない場合、すべての近接フィーチャが考慮されます。距離を指定して、単位を指定しないか、単位に不明を指定した場合、入力フィーチャの座標系の単位が使用されます。方法パラメーターに測地線オプションを使用した場合、キロメートルやマイルなどの距離単位を使用します。	Linear Unit
位置 (オプション)	近接フィーチャの最も近い位置を示す XY 座標を `NEAR_X` フィールドと `NEAR_Y` フィールドに書き込むかどうかを指定します。オン—位置を書き込みます。オフ—位置を書き込みません。これがデフォルトです。	Boolean
角度 (オプション)	近接角度を計算して出力テーブルの `NEAR_ANGLE` フィールドに書き込むかどうかを指定します。近接角度は、入力フィーチャとその最近接フィーチャを最も近い位置で接続するラインの方向を示します。 `method` パラメーターで `PLANAR` 方法を使用した場合、角度の範囲は -180° 〜 180° になり、0° は東、90° は北、180° (または -180°) は西、-90° は南を示します。 `method` パラメーターで `GEODESIC` 方法を使用した場合、角度の範囲は -180 〜 180° になり、0° は北、90° は東、180° (または -180°) は南、-90° は西を示します。オン—近接角度は計算されて、`NEAR_ANGLE` フィールドに書き込まれます。オフ—近接角度は計算されず、`NEAR_ANGLE` フィールドに書き込まれません。これがデフォルトです。	Boolean
方法 (オプション)	楕円体 (測地線) または平面地球 (平面) のどちらの距離法の最短パスを使用するかを指定します。距離の計測に適さない座標系 (Web メルカトル、任意の地理座標系など) で格納されているデータや、広い地理範囲にまたがるデータセットには、測地線方法を使用することをおすすめします。平面—フィーチャ間で平面距離が使用されます。これがデフォルトです。測地線—フィーチャ間で測地距離が使用されます。この方法では、楕円体の曲率を考慮して、日付変更線と極の近くのデータを正確に処理します。	String
フィールド名 (オプション)	処理中に追加される属性フィールドの名前。このパラメーターが使用されない、または追加されるフィールドがこのパラメーターから除外されている場合、デフォルトのフィールド名が使用されます。 `NEAR_FID` および `NEAR_DIST` フィールドはデフォルトで追加されます。`NEAR_X` および `NEAR_Y` フィールドは位置パラメーターがオンの場合に追加され、`NEAR_ANGLE` フィールドは角度パラメーターがオンの場合に追加され、`NEAR_FC` フィールドは複数の入力が使用される場合に追加されます。必要に応じて、複数の近接フィーチャパラメーター値が存在する場合、フィールドが基づく入力を指定する `Near Features` 列を指定します。値テーブル列: Property—The property type. Feature ID—The object ID of the feature that is nearest will be added. Distance—The distance to the feature that is nearest will be added. Location x-coordinate—The x-coordinate of the feature that is nearest will be added. Location y-coordinate—The y-coordinate of the feature that is nearest will be added. Angle—The angle to the feature that is nearest will be added. Feature class—The name of the feature class with the nearest feature will be added. Field Name—The name of the attribute field to add to contain the specified Near property. Near Features—The near features that the field values will be based on.	Value Table
距離単位 (オプション)	`NEAR_DIST` フィールドの計測単位を指定します。計測単位が指定されない場合、`NEAR_DIST` フィールドの値は入力フィーチャの座標系の距離単位で表されます。入力で地理座標系が使用され、測地線方法が使用されている場合、`NEAR_DIST` フィールドの単位はメートルになります。キロメートル—単位はキロメートルです。メートル—単位はメートルです。国際海里—単位は国際海里です。法定マイル—単位は法定マイルです。国際ヤード—単位は国際ヤードです。国際フィート—単位は国際フィートです。米国測量海里—単位は米国測量海里です。米国測量マイル—単位は米国測量マイルです。米国測量ヤード—単位は米国測量ヤードです。米国測量フィート—単位は米国測量フィートです。	String
フィールドの照合 (オプション)	属性の照合に使用される、入力フィーチャと近接フィーチャのフィールドのペア。入力フィーチャとフィールド値が一致する近接フィーチャのみが、最近接の計算に使用されます。値テーブル列: Input Fields—Fields from the input features that will be used for attribute matching. Near Fields—Fields from the near features that will be used for attribute matching.	Value Table

派生した出力

ラベル	説明	データタイプ
更新された入力フィーチャ	更新された入力フィーチャ。	Feature Layer

arcpy.analysis.Near(in_features, near_features, {search_radius}, {location}, {angle}, {method}, {field_names}, {distance_unit}, {match_fields})

名前	説明	データタイプ
in_features	ポイント、ポリライン、ポリゴン、またはマルチポイントタイプを指定できる入力フィーチャ。	Feature Layer
near_features [near_features,...]	近接フィーチャの候補が含まれる 1 つ以上のフィーチャレイヤーまたはフィーチャクラス。近接フィーチャとして、ポイント、ポリライン、ポリゴン、またはマルチポイントを使用できます。複数のレイヤーまたはフィーチャクラスを指定した場合、`NEAR_FC` フィールドが入力テーブルに追加されます。このフィールドには、検出された最近接フィーチャを含むソースフィーチャクラスのパスが格納されます。同じフィーチャクラスまたはレイヤーを、入力フィーチャと近接フィーチャの両方に使用することができます。	Feature Layer
search_radius (オプション)	近接フィーチャの検索に使用される半径。この値を指定しない場合、すべての近接フィーチャが考慮されます。距離を指定して、単位を指定しないか、単位に不明を指定した場合、入力フィーチャの座標系の単位が使用されます。 `method` パラメーターに `GEODESIC` オプションを使用した場合、キロメートルやマイルなどの距離単位を使用します。	Linear Unit
location (オプション)	近接フィーチャの最も近い位置を示す XY 座標を `NEAR_X` フィールドと `NEAR_Y` フィールドに書き込むかどうかを指定します。 `LOCATION`—位置を書き込みます。 `NO_LOCATION`—位置を書き込みません。これがデフォルトです。	Boolean
angle (オプション)	近接角度を計算して出力テーブルの `NEAR_ANGLE` フィールドに書き込むかどうかを指定します。近接角度は、入力フィーチャとその最近接フィーチャを最も近い位置で接続するラインの方向を示します。 `method` パラメーターで `PLANAR` 方法を使用した場合、角度の範囲は -180° 〜 180° になり、0° は東、90° は北、180° (または -180°) は西、-90° は南を示します。 `method` パラメーターで `GEODESIC` 方法を使用した場合、角度の範囲は -180 〜 180° になり、0° は北、90° は東、180° (または -180°) は南、-90° は西を示します。 `ANGLE`—近接角度は計算されて、`NEAR_ANGLE` フィールドに書き込まれます。 `NO_ANGLE`—近接角度は計算されず、`NEAR_ANGLE` フィールドに書き込まれません。これがデフォルトです。	Boolean
method (オプション)	楕円体 (測地線) または平面地球 (平面) のどちらの距離法の最短パスを使用するかを指定します。距離の計測に適さない座標系 (Web メルカトル、任意の地理座標系など) で格納されているデータや、広い地理範囲にまたがるデータセットには、`GEODESIC` 方法を使用することをおすすめします。 `PLANAR`—フィーチャ間で平面距離が使用されます。これがデフォルトです。 `GEODESIC`—フィーチャ間で測地距離が使用されます。この方法では、楕円体の曲率を考慮して、日付変更線と極の近くのデータを正確に処理します。	String
field_names [[property, fieldname],...] (オプション)	処理中に追加される属性フィールドの名前。このパラメーターが使用されない、または追加されるフィールドがこのパラメーターから除外されている場合、デフォルトのフィールド名が使用されます。 `NEAR_FID` および `NEAR_DIST` フィールドはデフォルトで追加されます。`NEAR_X` および `NEAR_Y` フィールドは `location` パラメーターが `LOCATION` に設定されている場合に追加され、`NEAR_ANGLE` フィールドは `angle` パラメーターが `ANGLE` に設定されている場合に追加され、`NEAR_FC` フィールドは複数の入力が使用される場合に追加されます。必要に応じて、複数の `near_features` パラメーター値が存在する場合、フィールドが基づく入力を指定するフィーチャクラスまたはフィーチャレイヤーを含めます。値テーブル列: `Property`—The property type. `NEAR_FID`—The object ID of the feature that is nearest will be added. `NEAR_DIST`—The distance to the feature that is nearest will be added. `NEAR_X`—The x-coordinate of the feature that is nearest will be added. `NEAR_Y`—The y-coordinate of the feature that is nearest will be added. `NEAR_ANGLE`—The angle to the feature that is nearest will be added. `NEAR_FC`—The name of the feature class with the nearest feature will be added. `Field Name`—The name of the attribute field to add to contain the specified Near property. `Near Features`—The near features that the field values will be based on.	Value Table
distance_unit (オプション)	`NEAR_DIST` フィールドの計測単位を指定します。計測単位が指定されない場合、`NEAR_DIST` フィールドの値は入力フィーチャの座標系の距離単位で表されます。入力で地理座標系が使用され、測地線方法が使用されている場合、`NEAR_DIST` フィールドの単位はメートルになります。 `Kilometers`—単位はキロメートルです。 `Meters`—単位はメートルです。 `NauticalMilesInt`—単位は国際海里です。 `MilesInt`—単位は法定マイルです。 `YardsInt`—単位は国際ヤードです。 `FeetInt`—単位は国際フィートです。 `NauticalMiles`—単位は米国測量海里です。 `Miles`—単位は米国測量マイルです。 `Yards`—単位は米国測量ヤードです。 `Feet`—単位は米国測量フィートです。	String
match_fields [[input_field, near_field],...] (オプション)	属性の照合に使用される、入力フィーチャと近接フィーチャのフィールドのペア。入力フィーチャとフィールド値が一致する近接フィーチャのみが、最近接の計算に使用されます。値テーブル列: `Input Fields`—Fields from the input features that will be used for attribute matching. `Near Fields`—Fields from the near features that will be used for attribute matching.	Value Table

派生した出力

名前	説明	データタイプ
out_feature_class	更新された入力フィーチャ。	Feature Layer

コードのサンプル

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

次の対話型の Python ウィンドウスクリプトは、イミディエイトモードで Near 関数を使用する方法を示しています。

import arcpy
arcpy.env.workspace = "C:/data/city.gdb"

# Find the nearest road from each house
arcpy.analysis.Near('houses', 'roads')

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

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

# Name: Near.py
# Description: Finds nearest features from input feature class to near feature class.

import arcpy

# Set workspace environment
arcpy.env.workspace = "C:/data/city.gdb"

try:
    # set local variables
    in_features = "houses"
    near_features = "parks"

    # find features only within search radius
    search_radius = "5000 Meters"

    # find location nearest features
    location = "LOCATION"

    # avoid getting angle of neares features
    angle = "NO_ANGLE"

    # run the function
    arcpy.analysis.Near(in_features, near_features, search_radius, location, angle)

    # get geoprocessing messages
    print(arcpy.GetMessages())

except arcpy.ExecuteError:
    print(arcpy.GetMessages(2))

except Exception as err:
    print(err.args[0])

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

次の Python スクリプトは、近接角度を方位角に変換する方法を示しています。

# Name: near_angle_to_azimuth.py

import arcpy

# Near tool does not calculate angle in azimuths
# This script, using the output of the tool, converts the angles
# to azimuth angles.

in_table = r"C:/data/city.gdb/near_table"

angles = arcpy.da.SearchCursor(in_table, ["NEAR_ANGLE"])

azimuth_angles = []

with angles as rows:
    for row in rows:
        angle = row[0]
        if angle <= 180 and angle > 90:
            azimuth_angles.append(360.0 - (angle - 90))
        else:
            azimuth_angles.append(abs(angle - 90))

# Use these azimuth angles as necessary.

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

次の Python スクリプトは、Near 関数の派生出力を使用した後処理を示しています。このスクリプトは、最近接フィーチャごとに、最も近い入力フィーチャを検出します。

# Name: features_closest_to_input.py

"""
    This script finds, for each input feature, a list of near feature it is closest to.
    If near features 6, 7, 10 are closest to input feature 3 then the
    resulting dictionary will have a list [6, 7, 10] as value for key 3
"""

import os
import arcpy

in_fc = r"C:\data\cities.gdb\cities_many"

# create a dictionary to hold the list of near ids for each input id
nearest_dict = dict()

with arcpy.da.SearchCursor(in_fc, ["OID@", "NEAR_FID"]) as rows:
    for row in rows:
        nearest_id = row[0]  # get OID value for that row
        input_id = row[1]    # get NEAR_FID value

        if input_id in nearest_dict:
            # if a dict key already exists, append near id to value list for that key
            nearest_dict[input_id].append(nearest_id)
        else:
            # if the key does not exist then create a new list with near id
            # and add it to the dictionary
            nearest_dict[input_id] = [nearest_id]

print(nearest_dict)

# output will look like:
# {1: [13, 28], 2: [2, 9, 14, 20, 22], 3: [11, 12, 24, 25]}

環境

範囲, 現在のワークスペース

ライセンス情報

Basic: はい
Standard: はい
Advanced: はい

最近接 (解析ツール)

サマリー

図

使用法

パラメーター

派生した出力

環境

ライセンス情報

関連トピック