Distancia de punto (Análisis)

Resumen

Determina las distancias de las entidades de punto de entrada a todos los puntos de las entidades cercanas dentro de un radio de búsqueda especificado.

Ilustración

Uso

• La herramienta crea una matriz de distancias entre dos conjuntos de puntos si se utiliza el radio de búsqueda predeterminado, en cuyo caso se calculan las distancias de todas las entidades de entrada a todas las entidades cercanas. La tabla de resultados puede ser bastante grande. Por ejemplo, si tanto las entidades de entrada como las cercanas tienen 1000 puntos, la tabla de salida puede contener un millón de registros. Utilice un radio de búsqueda significativo para limitar el tamaño de la salida.

• Los resultados se registran en la tabla de salida, que contiene la siguiente información:

  • INPUT_FID: el ID de entidad de las entidades de entrada.
  • NEAR_FID: el ID de entidad de las entidades cercanas.
  • DISTANCE: la distancia de la entidad de entrada a la cercana.

• Tanto las Entidades de entrada como las Entidades próximas pueden estar en el mismo dataset. En ese caso, cuando las entidades de entrada y las entidades próximas están en el mismo registro, el resultado se omitirá para no tener que informar que cada entidad está a 0 unidades de sí misma.

Sintaxis

PointDistance_analysis (in_features, near_features, out_table, {search_radius})

Parámetro	Explicación	Tipo de datos
in_features	Las entidades de punto desde las que se calcularán las distancias a las entidades cercanas.	Feature Layer
near_features	Los puntos a los que se calcularán las distancias desde las entidades de entrada. Las distancias entre los puntos dentro de la misma clase de entidad o capa se pueden determinar especificando la misma clase de entidad o capa para la entrada y las entidades cercanas.	Feature Layer
out_table	La tabla que contiene la lista de entidades de entrada e información de casi todas las entidades cercanas dentro del radio de búsqueda. Si no se especifica un radio de búsqueda, se calculan las distancias de todas las entidades de entrada a todas las entidades cercanas.	Table
search_radius (Opcional)	Solo se calculan las distancias para las entidades cercanas que están dentro del radio de búsqueda de las entidades de entrada.	Linear unit

Ejemplo de código

Ejemplo 1 de DistanciaPunto (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python interactiva demuestra cómo utilizar la función DistanciaPunto en modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data/pointdistance.gdb"
  
arcpy.PointDistance_analysis("police_stations", "crime_location", "crime_distances")

Ejemplo 2 de DistanciaPunto (secuencia de comandos Python independiente)

La siguiente secuencia de comandos Python demuestra cómo utilizar la función DistanciaPunto en una secuencia de comandos independiente.

# Name: PointDistance.py
# Description: Finds distance of each near point from each input point and outputs to a table.
# Author: ESRI
  
# import system modules
import arcpy
from arcpy import env
  
# set workspace environment
env.workspace = "C:/data/pointdistance.gdb"
  
# set variables
inFeatures = "police_stations"
nearFeatures = "crime_location"
outTable = "crime_distance4"
searchRadius = "22000 Feet"
  
# find crime locations within the search radius
arcpy.PointDistance_analysis(inFeatures, nearFeatures, outTable, searchRadius)

Entornos

Extensión, Espacio de trabajo actual, Espacio de trabajo temporal

Información de licencia

ArcView: No

ArcEditor: No

ArcInfo: Sí