概要
指定された検索範囲内で、入力ポイント フィーチャから近接フィーチャのすべてのポイントまでの距離を特定します。
図
使用法
このツールは、2 つのポイント セット間の距離を示すテーブルを作成します。デフォルトの検索範囲を使用すると、すべての入力ポイントからすべての近接ポイントまでの距離が計算されます。 出力テーブルは、かなり大きくなる場合があります。 たとえば、入力フィーチャと近接フィーチャのそれぞれに 1,000 のポイントがある場合、出力テーブルには 100 万のレコードが含まれる可能性があります。
出力のサイズを制限してツールのパフォーマンスを向上させるには、意味のある検索範囲を使用してください。 出力テーブルには、検索範囲内に近接ポイントがあるレコードのみが含まれます。
結果は、以下の情報を含む出力テーブルに記録されます。
- INPUT_FID - 入力フィーチャのフィーチャ ID。
- NEAR_FID - 近接フィーチャのフィーチャ ID。
- DISTANCE - 入力フィーチャから近接フィーチャまでの距離。 このフィールドの値は、入力フィーチャの座標系の距離単位で表されます。
入力フィーチャと近接フィーチャは同じデータセットに属していてもかまいません。その場合、入力フィーチャと近接フィーチャが同じレコードであるときはその結果がスキップされ、そのため距離が 0 単位のフィーチャは報告されません。
構文
arcpy.analysis.PointDistance(in_features, near_features, out_table, {search_radius})| パラメーター | 説明 | データ タイプ |
in_features | 近接フィーチャまでの距離を計算する際の始点となるポイント フィーチャ。 | Feature Layer |
near_features | 近接フィーチャからの距離を計算する際の終点となるポイント。 同じフィーチャクラスまたはレイヤー内のポイント間の距離は、入力フィーチャと近接フィーチャに同じフィーチャクラスまたはレイヤーを指定することによって決定されます。 | Feature Layer |
out_table | 入力フィーチャのリストと、検索範囲内のすべての近接フィーチャに関する情報を含むテーブル。 検索範囲が指定されていない場合は、すべての入力フィーチャからすべての近接フィーチャまでの距離が計算されます。 | Table |
search_radius (オプション) | 近接フィーチャを検索するための半径を指定します。 この半径内に存在する近接フィーチャから最近接フィーチャが求められます。 値を何も指定しない場合は、デフォルト (空の) 半径が使用されます。つまり、すべての近接フィーチャが計算対象となります。 デフォルトの検索範囲の単位は入力フィーチャの単位です。 この単位は他の単位に変更できます。 ただし、これは入力フィーチャの座標系の単位に基づいて設定される出力距離フィールドの単位に影響を与えません。 | Linear Unit |
コードのサンプル
PointDistance (ポイント間距離) の例 1 (Python ウィンドウ)
次の対話型の Python ウィンドウ スクリプトは、イミディエイト モードで PointDistance 関数を使用する方法を示しています。
import arcpy
arcpy.env.workspace = "C:/data/pointdistance.gdb"
arcpy.PointDistance_analysis("police_stations", "crime_location", "crime_distances")
PointDistance (ポイント間距離) の例 2 (スタンドアロン スクリプト)
次の Python スクリプトは、スタンドアロン スクリプトで PointDistance 関数を使用する方法を示しています。
# Description: Finds distance of each near point from each input point and outputs to a table.
# import system modules
import arcpy
# set workspace environment
arcpy.env.workspace = "C:/data/pointdistance.gdb"
# set variables
in_features = "police_stations"
near_features = "crime_location"
out_table = "crime_distance4"
search_radius = "22000 Feet"
# find crime locations within the search radius
arcpy.PointDistance_analysis(in_features, near_features, out_table, search_radius)
環境
ライセンス情報
- Basic: いいえ
- Standard: いいえ
- Advanced: はい