[ArcMap] 두 점 간 거리를 구해주는 도구 : Point Distance

[ArcMap] Tool to find the distance between two points: Point Distance

 

 

요약

지정된 검색 반경 내에서 입력 포인트 피처에서 근거리 피처의 모든 포인트까지의 거리를 결정합니다.

삽화

용법

• 이 도구는 두 점 세트 사이의 거리가 포함된 테이블을 생성합니다. 기본 검색 반경을 사용하는 경우 모든 입력 지점에서 모든 가까운 지점까지의 거리가 계산됩니다. 출력 테이블은 상당히 클 수 있습니다. 예를 들어 입력 및 근거리 기능에 각각 1,000개의 포인트가 있는 경우 출력 테이블에는 백만 개의 레코드가 포함될 수 있습니다.
• 의미 있는 검색 반경을 사용하여 출력 크기를 제한하고 도구 성능을 향상시킵니다. 출력 테이블에는 검색 반경 내에 가까운 지점이 있는 레코드만 포함됩니다.
• 결과는 다음 정보가 포함된 출력 테이블에 기록됩니다.
  • INPUT_FID - 입력 기능의 기능 ID
  • NEAR_FID - 가까운 피처의 피처 ID
  • DISTANCE - 입력에서 근거리 기능까지의 거리입니다. 이 필드의 값은 입력 피처 좌표계의 선형 단위입니다.
• 입력 기능 과 근거리 기능은 모두 동일한 데이터 세트일 수 있습니다. 이 경우 입력 및 근거리 기능이 동일한 레코드인 경우 각 기능이 자체적으로 0 단위라고 보고하지 않도록 해당 결과를 건너뜁니다.

통사론

arcpy.analysis.PointDistance(in_features, near_features, out_table, {search_radius})

모수	설명	데이터 형식
in_features	가까운 피처까지의 거리를 계산할 포인트 피처.	피처 레이어
near_features	입력 피처로부터의 거리를 계산할 포인트입니다. 동일한 피처 클래스 또는 레이어 내의 포인트 간 거리는 입력 피처 및 주변 피처에 대해 동일한 피처 클래스 또는 레이어를 지정하여 결정할 수 있습니다.	피처 레이어
out_table	입력 피처 목록과 검색 반경 내의 모든 근거리 피처에 대한 정보가 포함된 테이블입니다. 검색 반경을 지정하지 않으면 모든 입력 피처에서 가까운 모든 피처까지의 거리가 계산됩니다.	테이블
search_radius (선택 과목)	가까운 후보를 검색하는 데 사용되는 반경을 지정합니다. 이 반경 내의 가까운 피처는 가장 가까운 피처를 계산하는 데 고려됩니다. 값이 지정되지 않은 경우(즉, 기본(빈) 반지름이 사용됨) 가까운 모든 피처가 계산에 고려됩니다. 검색 반경 단위는 기본적으로 입력 기능의 단위입니다. 단위는 다른 단위로 변경할 수 있습니다. 그러나 이는 입력 피처의 좌표계 단위를 기반으로 하는 출력 DISTANCE 필드의 단위에는 영향을 미치지 않습니다.	리니어 유닛

코드 샘플

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)

환경

• 정도
• 현재 작업공간
• 스크래치 작업 공간

라이선스 정보

• 기본: 아니요
• 표준: 아니다
• 고급: 예

관련 주제

• Proximity 도구 세트 개요

 

https://desktop.arcgis.com/en/arcmap/latest/tools/analysis-toolbox/point-distance.htm

Point Distance (Analysis)—ArcMap | Documentation