Cercano (Análisis)

Resumen

Determina la distancia de cada entidad de las entidades de entrada a la entidad más cercana de las entidades cercanas, dentro del radio de búsqueda.

Ilustración

Uso

• Los dos siguientes campos se agregarán a la tabla de atributos de Entidades de Entrada. Si los campos ya existen, los valores de los campos se actualizan.

  • NEAR_FID: almacena el ID de entidad de la entidad más cercana.
  • NEAR_DIST: almacena la distancia de una entidad de entrada a la entidad más cercana.

• Los valores para NEAR_FID y NEAR_DIST serán de -1 si no se encuentra una entidad dentro del radio de búsqueda.

• Opcionalmente, se puede agregar TAMBIÉN los campos NEAR_X, NEAR_Y, NEAR_FC y NEAR_ANGLE a la tabla de atributos de entidades de entrada como se explica en las entidades cercanas y en las entradas de los parámetros opcionales. Si alguno de los campos existe ya, su valor se actualiza. Si no se encuentra ninguna entidad dentro del radio de búsqueda, los valores de estos campos serán -1 para NEAR_X y NEAR_Y, 0 para NEAR_ANGLE y nulo para NEAR_FC.

• Tanto las entidades de entrada como las entidades próximas pueden ser entidades de puntos, multipuntos, líneas o polígonos.

• Las Entidades Próximas pueden incluir una o más clases de entidad de tipos de forma diferentes.

• El mismo dataset se puede utilizar como Entidades de Entrada y como Entidades Próximas. Cuando la entidad más cercana de una entidad de entrada es ella misma (NEAR_DIST es 0), esta entidad se omite del cálculo y se busca la próxima entidad más cercana.

Sintaxis

Near_analysis (in_features, near_features, {search_radius}, {location}, {angle})

Parámetro	Explicación	Tipo de datos
in_features	Las entidades de entrada que pueden ser de tipo punto, polilínea, polígono o multipunto.	Feature Layer
near_features [near_features,...]	Las entidades próximas que se utilizan para buscar las entidades más cercanas a las entidades de entrada. Puede haber una o más entradas de entidades próximas; cada entrada puede ser de tipo punto, polilínea, polígono o multipunto. Cuando se especifican varias entradas de entidades próximas, se agrega un nuevo campo NEAR_FC a la tabla de entrada para almacenar las rutas de la clase de entidad de origen que contiene las entidades más cercanas.	Feature Layer
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. Puede especificar cualquier unidad de distancia si reemplaza la unidad predeterminada de las entidades de entrada.	Linear unit
location (Opcional)	Especifica si se escribirán las coordenadas x e y de la ubicación más cercana de la entidad próxima en los nuevos campos NEAR_X and NEAR_Y, respectivamente. NO_LOCATION —especifica que no se escribirán las coordenadas x e y de la ubicación más cercana. Ésta es la opción predeterminada. LOCATION —especifica que se escribirán las coordenadas x e y de la ubicación más cercana en los campos NEAR_X y NEAR_Y.	Boolean
angle (Opcional)	Especifica si se calcularán los valores del ángulo cercano en grados decimales y si se escribirán en un campo nuevo, NEAR_ANGLE. Un ángulo cercano se mide desde el eje x (eje horizontal) hacia la dirección de la línea que conecta una entidad de entrada a la entidad más cercana en las ubicaciones más cercanas, y varía entre 0 y 180 o entre 0 y -180 grados decimales. NO_ANGLE —especifica que no se escribirán los valores del ángulo cercano. Ésta es la opción predeterminada. ANGLE —especifica que se escribirán los valores del ángulo cercano en el campo NEAR_ANGLE.	Boolean

Ejemplo de código

Ejemplo 1 de Cercano (ventana de Python)

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

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

## find the nearest road from each house
arcpy.Near_analysis('houses', 'roads')

Ejemplo 2 de Cercano (secuencia de comandos Python independiente)

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

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

import arcpy
from arcpy import env

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

# set local variables
inFeatures = "houses"
nearFeatures = "parks"

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

# find location & angle of nearest features
location = "true"
angle = "true"

# execute the function
arcpy.Near_analysis(inFeatures, nearFeatures, searchRadius, location, angle)

Entornos

Extensión, Espacio de trabajo actual

Información de licencia

ArcView: No

ArcEditor: No

ArcInfo: Sí