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.

Heredado:

Esta es una herramienta obsoleta. Esta función se ha reemplazado por las herramientas Cerca y Generar tabla de cercanía que ahora calculan las distancias entre entidades de puntos, polilíneas y polígonos.

Ilustración

Ilustración de Distancia de punto

Uso

  • La herramienta crea una tabla con distancias entre dos conjuntos de puntos. Si se utiliza el radio de búsqueda predeterminado, las distancias desde todos los puntos de entrada a todos los puntos cercanos se calculan. La tabla de resultados puede ser bastante grande. Por ejemplo, si tanto las entidades de entrada como las cercanas tienen 1.000 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 y mejorar el rendimiento de la herramienta. La tabla de salida contiene solo esos registros que tienen casi un punto cercano dentro del radio de búsqueda.

  • 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. El valor de este campo está en la unidad lineal del sistema de coordenadas de las entidades de entrada.
  • 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.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades de punto desde las que se calcularán las distancias a las entidades cercanas.

Feature Layer
Entidades próximas

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
Tabla de Salida

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
Radio de búsqueda
(Opcional)

Especifica el radio que se utiliza para buscar entidades cercanas candidatas. Las entidades próximas dentro de este radio se consideran para calcular la entidad más cercana. Si no se especifica un valor (es decir, que se utiliza el radio predeterminado (vacío)), se consideran todas las entidades próximas para el cálculo. La unidad de radio de búsqueda se predetermina a las unidades de las entidades de entrada. Las unidades se pueden cambiar a cualquier otra unidad. Sin embargo, esto no tiene ningún impacto en las unidades del campo de DISTANCIA de salida que se basan en las unidades del sistema de coordenadas de las entidades de entrada.

Linear Unit

arcpy.analysis.PointDistance(in_features, near_features, out_table, {search_radius})
NombreExplicaciónTipo 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)

Especifica el radio que se utiliza para buscar entidades cercanas candidatas. Las entidades próximas dentro de este radio se consideran para calcular la entidad más cercana. Si no se especifica un valor (es decir, que se utiliza el radio predeterminado (vacío)), se consideran todas las entidades próximas para el cálculo. La unidad de radio de búsqueda se predetermina a las unidades de las entidades de entrada. Las unidades se pueden cambiar a cualquier otra unidad. Sin embargo, esto no tiene ningún impacto en las unidades del campo de DISTANCIA de salida que se basan en las unidades del sistema de coordenadas de las entidades de entrada.

Linear Unit

Muestra de código

Ejemplo 1 de PointDistance (ventana de Python)

El siguiente script de la ventana interactiva de Python muestra cómo utilizar la función PointDistance en el modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data/pointdistance.gdb"
  
arcpy.PointDistance_analysis("police_stations", "crime_location", "crime_distances")
Ejemplo 2 de PointDistance (script independiente)

El siguiente script de Python muestra cómo utilizar la función PointDistance en un script independiente.

# 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)

Información de licenciamiento

  • Basic: No
  • Standard: No
  • Advanced: Sí