Cerca (Herramientas de análisis)

Resumen

Calcula distancias y otra información de proximidad entre entidades en una o varias capas o clases de entidad.

Más información sobre cómo se calcula la proximidad con las herramientas de geoprocesamiento

Ilustración

Uso

El campo siguiente se agregará a la entrada. Si los campos ya existen, los valores de campo se actualizarán. Estos nombres de campo se pueden configurar con el parámetro Nombres de campo.
- NEAR_FID—Id. de objeto de la entidad más cercana. Si no se encuentra ninguna entidad próxima, el valor será -1.
- NEAR_DIST—La distancia de la entidad de entrada a la entidad cercana. El valor está en unidades lineales del sistema de coordenadas de entidades de entrada o en metros cuando el parámetro Método está establecido en Geodésico y la entrada está definida en un sistema de coordenadas geográficas. Si no se encuentra ninguna entidad próxima, el valor será -1.
- NEAR_FC—La ruta de la clase de entidad de origen que contiene la entidad más cercana encontrada. Se utilizará el nombre de la capa si las capas se utilizan como entrada; además, la ruta de catálogo a la clase de entidad se utilizará si se utilizan rutas como entrada. Este campo solo se agrega a la tabla de salida si se especifican varias entidades cercanas. Si no se encuentra ninguna entidad próxima, el valor será nulo o una cadena de caracteres vacía.
Los siguientes campos se agregarán a la entrada si el parámetro Ubicación está activado. Los valores de campo se actualizarán, si los campos ya existen. Las unidades del valor del campo dependen del valor del parámetro Método. Si el parámetro Método se establece como Planar, el valor de campo estará en la unidad lineal del sistema de coordenadas de la entidad de entrada. Si se establece como Geodésico, el valor de campo estará en el sistema de coordenadas geográficas asociado al sistema de coordenadas de la entidad de entrada.
- NEAR_X—Coordenada X de la ubicación en la entidad próxima que está más cerca de la entidad de entrada. Si no se encuentra ninguna entidad próxima, el valor será -1.
- NEAR_Y—La coordenada y de la ubicación en la entidad próxima más cercana a la entidad de entrada. Si no se encuentra ninguna entidad próxima, el valor será -1.
El siguiente campo se agregará a las entidades de entrada si el parámetro Ángulo está activado. El valor del campo se actualizará si el campo ya existe.
- NEAR_ANGLE—Ángulo de la línea en la ubicación FROM_X y FROM_Y que conecta las entidades de entrada a la entidad próxima. Si no se encuentra una entidad próxima o esta interseca la entidad de entrada, el valor será 0.
Los valores correspondientes a NEAR_FID y NEAR_DIST serán -1 si no se encuentra ninguna entidad dentro del radio de búsqueda.
Las entidades de entrada y próximas pueden ser puntos, multipuntos, líneas o polígonos.
El valor del parámetro Entidades próximas puede incluir una clase de entidad o más de diferentes tipos de forma (punto, multipunto, línea o polígono).
Para calcular la distancia y la información adicional de proximidad dentro de una única clase o capa de entidad, se puede usar la misma clase o capa de entidad. En este caso, la entidad de entrada que se está evaluando se excluirá de los candidatos de entidad cercana para evitar que todas las entidades estén próximas a ellas mismas.
Las entidades de entrada pueden ser una capa en la que realizó una selección. Las entidades seleccionadas se utilizarán y actualizarán durante la operación de la herramienta. El resto de entidades tendrán los valores de los campos recién creados (como NEAR_FID y NEAR_DIST) configurados en -1.
Cuando la distancia más corta de una entidad de entrada es la misma en más de una entidad próxima, una de ellas es elegida de forma aleatoria como la entidad más cercana.
Cuando utilice la opción De plano para el parámetro Método, utilice una proyección para las entidades de entrada que sea apropiada para la medición de la distancia, como en una proyección equidistante.

Más información sobre los sistemas de coordenadas y las proyecciones
Para visualizar las ubicaciones NEAR_X y NEAR_Y, la tabla de salida se puede usar como entrada de las herramientas Crear capa de eventos XY o De XY a línea.
You can set a unit of measurement for the NEAR_DIST campo— como metros, kilómetros o millas, usando el parámetro Unidad de distancia.
Esta herramienta permite encontrar la entidad más cercana para cada entrada de los múltiples valores del parámetro Entidades cercanas.

Etiqueta	Explicación	Tipo de datos
Entidades de entrada	Las entidades de entrada, que pueden ser de tipo punto, polilínea, polígono o multipunto.	Feature Layer
Entidades próximas	Una o más capas de entidad o clases de entidad que contienen candidatos de entidades próximas. Las entidades próximas pueden ser punto, polilínea, polígono o multipunto. Si se especifican varias capas o clases de entidad, se agregará un campo `NEAR_FC` a la tabla de entrada que almacenará las rutas de la clase de entidad de origen que contiene la entidad más cercana encontrada. La misma capa o clase de entidad se puede usar tanto para entidades de entrada como entidades cercanas.	Feature Layer
Radio de Búsqueda (Opcional)	Radio que se utilizará para buscar entidades próximas. Si no se especifica ningún valor, se tendrán en cuenta todas las entidades próximas. Si se especifica una distancia, pero no se especifica ninguna unidad o se especifica una unidad desconocida, se utilizarán las unidades del sistema de coordenadas de las entidades de entrada. Si se utiliza la opción Geodésico para el parámetro Método, use una unidad lineal, como kilómetros o millas.	Linear Unit
Ubicación (Opcional)	Especifica si las coordenadas x e y de la ubicación más cercana de la entidad próxima se escribirán en los campos `NEAR_X` y `NEAR_Y`. Activado—Las ubicaciones se escribirán. Desactivado—Las ubicaciones no se escribirán. Esta es la opción predeterminada.	Boolean
Ángulo (Opcional)	Especifica si el ángulo cercano se calculará y se escribirá en el campo `NEAR_ANGLE` en la tabla de salida. Un ángulo próximo mide la dirección de la línea que conecta una entidad de entrada a la entidad más próxima en la ubicación más cercana. Cuando el método `PLANAR` se utilice en el parámetro `method`, el ángulo estará dentro del rango de -180° a 180°, con 0° al este, 90° al norte, 180° (o -180°) al oeste y -90° al sur. Si se utiliza el método `GEODESIC` para el parámetro `method`, el ángulo se encontrará dentro del rango de -180° a 180°, con 0° al norte, 90° al este, 180° (o -180°) al sur y -90° al oeste. Activado—El ángulo cercano se calculará y se escribirá en el campo `NEAR_ANGLE`. Desactivado—El ángulo cercano no se calculará o no se escribirá en el campo `NEAR_ANGLE`. Esta es la opción predeterminada.	Boolean
Método (Opcional)	Especifica si se utilizará un método de distancia de camino más corto en un esferoide (geodésico) o en una tierra plana (planar). Se recomienda utilizar el método Geodésico para datos almacenados en un sistema de coordenadas que no sea adecuado para las mediciones de distancias (por ejemplo, Web Mercator o cualquier sistema de coordenadas geográficas), así como para un dataset que abarque una extensa área geográfica. Planar—Se utilizará la distancia planar entre las entidades. Esta es la opción predeterminada. Geodésica—Se utilizarán distancias geodésicas entre las entidades. Este método tiene en cuenta la curvatura del esferoide y trata correctamente los datos cercanos a la línea de cambio de fecha internacional y los polos.	String
Nombres de campo (Opcional)	Nombres de los campos de atributos que se agregarán durante el procesamiento. Si no se utiliza este parámetro o se excluye de él cualquier campo que se agregue, se utilizarán los nombres de campos predeterminados. De forma predeterminada, los campos `NEAR_FID` y `NEAR_DIST` se agregarán, los campos `NEAR_X` y `NEAR_Y` se agregarán cuando se active el parámetro Ubicación, el campo `NEAR_ANGLE` se agregará cuando se active el parámetro Ángulo y el campo `NEAR_FC` se agregará cuando se utilicen varias entradas. Si lo desea, cuando haya varios valores para el parámetro Entidades cercanas, especifique una columna `Near Features` para designar la entrada en la que se basará el campo. Columnas de la tabla de valores: Property—The property type. Feature ID—The object ID of the feature that is nearest will be added. Distance—The distance to the feature that is nearest will be added. Location x-coordinate—The x-coordinate of the feature that is nearest will be added. Location y-coordinate—The y-coordinate of the feature that is nearest will be added. Angle—The angle to the feature that is nearest will be added. Feature class—The name of the feature class with the nearest feature will be added. Field Name—The name of the attribute field to add to contain the specified Near property. Near Features—The near features that the field values will be based on.	Value Table
Unidad de distancia (Opcional)	Especifica la unidad de medida del campo `NEAR_DIST`. Si no se especifica ninguna unidad de medida, los valores del campo `NEAR_DIST` estarán en la unidad lineal del sistema de coordenadas de la entidad de entrada. Si la entrada está en un sistema de coordenadas geográficas y se utiliza el método geodésico, las unidades del campo `NEAR_DIST` serán metros. Kilómetros—La unidad será kilómetros. Metros—La unidad será metros. Millas náuticas internacionales—La unidad será millas náuticas internacionales. Millas terrestres—La unidad será millas terrestres. Yardas internacionales—La unidad será yardas internacionales. Pies internacionales—La unidad será pies internacionales. Millas náuticas topográficas de EE. UU.—La unidad será millas náuticas topográficas de EE. UU. Millas de agrimensura de EE. UU.—La unidad será millas topográficas de EE. UU. Yardas de agrimensura de EE. UU.—La unidad será yardas topográficas de EE. UU. Pies de agrimensura de EE. UU.—La unidad será pies de agrimensura de EE. UU.	String
Campos coincidentes (Opcional)	Los pares de campos de las entidades de entrada y las entidades próximas que se utilizarán en la coincidencia de atributos. En el cálculo del valor cercano solo se utilizarán las entidades próximas que compartan valores de coincidencia de campo con las entidades de entrada. Columnas de la tabla de valores: Input Fields—Fields from the input features that will be used for attribute matching. Near Fields—Fields from the near features that will be used for attribute matching.	Value Table

Salida derivada

Etiqueta	Explicación	Tipo de datos
Entidades de entrada actualizadas	Las entidades de entrada actualizadas.	Feature Layer

arcpy.analysis.Near(in_features, near_features, {search_radius}, {location}, {angle}, {method}, {field_names}, {distance_unit}, {match_fields})

Nombre	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,...]	Una o más capas de entidad o clases de entidad que contienen candidatos de entidades próximas. Las entidades próximas pueden ser punto, polilínea, polígono o multipunto. Si se especifican varias capas o clases de entidad, se agregará un campo `NEAR_FC` a la tabla de entrada que almacenará las rutas de la clase de entidad de origen que contiene la entidad más cercana encontrada. La misma capa o clase de entidad se puede usar tanto para entidades de entrada como entidades cercanas.	Feature Layer
search_radius (Opcional)	Radio que se utilizará para buscar entidades próximas. Si no se especifica ningún valor, se tendrán en cuenta todas las entidades próximas. Si se especifica una distancia, pero no se especifica ninguna unidad o se especifica una unidad desconocida, se utilizarán las unidades del sistema de coordenadas de las entidades de entrada. Si se utiliza la opción `GEODESIC` en el parámetro `method`, use una unidad lineal, como kilómetros o millas.	Linear Unit
location (Opcional)	Especifica si las coordenadas x e y de la ubicación más cercana de la entidad próxima se escribirán en los campos `NEAR_X` y `NEAR_Y`. `LOCATION`—Las ubicaciones se escribirán. `NO_LOCATION`—Las ubicaciones no se escribirán. Esta es la opción predeterminada.	Boolean
angle (Opcional)	Especifica si el ángulo cercano se calculará y se escribirá en el campo `NEAR_ANGLE` en la tabla de salida. Un ángulo próximo mide la dirección de la línea que conecta una entidad de entrada a la entidad más próxima en la ubicación más cercana. Cuando el método `PLANAR` se utilice en el parámetro `method`, el ángulo estará dentro del rango de -180° a 180°, con 0° al este, 90° al norte, 180° (o -180°) al oeste y -90° al sur. Si se utiliza el método `GEODESIC` para el parámetro `method`, el ángulo se encontrará dentro del rango de -180° a 180°, con 0° al norte, 90° al este, 180° (o -180°) al sur y -90° al oeste. `ANGLE`—El ángulo cercano se calculará y se escribirá en el campo `NEAR_ANGLE`. `NO_ANGLE`—El ángulo cercano no se calculará o no se escribirá en el campo `NEAR_ANGLE`. Esta es la opción predeterminada.	Boolean
method (Opcional)	Especifica si se utilizará un método de distancia de camino más corto en un esferoide (geodésico) o en una tierra plana (planar). Se recomienda utilizar el método `GEODESIC` para datos almacenados en un sistema de coordenadas que no sea adecuado para las mediciones de distancias (por ejemplo, Web Mercator o cualquier sistema de coordenadas geográficas), así como para un dataset que abarque una extensa área geográfica. `PLANAR`—Se utilizará la distancia planar entre las entidades. Esta es la opción predeterminada. `GEODESIC`—Se utilizarán distancias geodésicas entre las entidades. Este método tiene en cuenta la curvatura del esferoide y trata correctamente los datos cercanos a la línea de cambio de fecha internacional y los polos.	String
field_names [[property, fieldname],...] (Opcional)	Nombres de los campos de atributos que se agregarán durante el procesamiento. Si no se utiliza este parámetro o se excluye de él cualquier campo que se agregue, se utilizarán los nombres de campos predeterminados. De forma predeterminada, los campos `NEAR_FID` y `NEAR_DIST` se agregarán, los campos `NEAR_X` y `NEAR_Y` se agregarán cuando el parámetro `location` se defina como `LOCATION`, el campo `NEAR_ANGLE` se agregará cuando el parámetro `angle` se defina como `ANGLE` y el campo `NEAR_FC` se agregará cuando se utilicen varias entradas. Si lo desea, cuando haya varios valores para el parámetro `near_features`, incluya la clase de entidad o la capa de entidades para designar la entrada en la que se basará el campo. Columnas de la tabla de valores: `Property`—The property type. `NEAR_FID`—The object ID of the feature that is nearest will be added. `NEAR_DIST`—The distance to the feature that is nearest will be added. `NEAR_X`—The x-coordinate of the feature that is nearest will be added. `NEAR_Y`—The y-coordinate of the feature that is nearest will be added. `NEAR_ANGLE`—The angle to the feature that is nearest will be added. `NEAR_FC`—The name of the feature class with the nearest feature will be added. `Field Name`—The name of the attribute field to add to contain the specified Near property. `Near Features`—The near features that the field values will be based on.	Value Table
distance_unit (Opcional)	Especifica la unidad de medida del campo `NEAR_DIST`. Si no se especifica ninguna unidad de medida, los valores del campo `NEAR_DIST` estarán en la unidad lineal del sistema de coordenadas de la entidad de entrada. Si la entrada está en un sistema de coordenadas geográficas y se utiliza el método geodésico, las unidades del campo `NEAR_DIST` serán metros. `Kilometers`—La unidad será kilómetros. `Meters`—La unidad será metros. `NauticalMilesInt`—La unidad será millas náuticas internacionales. `MilesInt`—La unidad será millas terrestres. `YardsInt`—La unidad será yardas internacionales. `FeetInt`—La unidad será pies internacionales. `NauticalMiles`—La unidad será millas náuticas topográficas de EE. UU. `Miles`—La unidad será millas topográficas de EE. UU. `Yards`—La unidad será yardas topográficas de EE. UU. `Feet`—La unidad será pies de agrimensura de EE. UU.	String
match_fields [[input_field, near_field],...] (Opcional)	Los pares de campos de las entidades de entrada y las entidades próximas que se utilizarán en la coincidencia de atributos. En el cálculo del valor cercano solo se utilizarán las entidades próximas que compartan valores de coincidencia de campo con las entidades de entrada. Columnas de la tabla de valores: `Input Fields`—Fields from the input features that will be used for attribute matching. `Near Fields`—Fields from the near features that will be used for attribute matching.	Value Table

Salida derivada

Nombre	Explicación	Tipo de datos
out_feature_class	Las entidades de entrada actualizadas.	Feature Layer

Muestra de código

Ejemplo 1 de Near (ventana de Python)

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

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

# Find the nearest road from each house
arcpy.analysis.Near('houses', 'roads')

Ejemplo 2 de Near (script independiente)

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

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

import arcpy

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

try:
    # set local variables
    in_features = "houses"
    near_features = "parks"

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

    # find location nearest features
    location = "LOCATION"

    # avoid getting angle of neares features
    angle = "NO_ANGLE"

    # run the function
    arcpy.analysis.Near(in_features, near_features, search_radius, location, angle)

    # get geoprocessing messages
    print(arcpy.GetMessages())

except arcpy.ExecuteError:
    print(arcpy.GetMessages(2))

except Exception as err:
    print(err.args[0])

Ejemplo 3 de Near (script independiente)

El siguiente script de Python demuestra cómo convertir el ángulo cercano en acimut.

# Name: near_angle_to_azimuth.py

import arcpy

# Near tool does not calculate angle in azimuths
# This script, using the output of the tool, converts the angles
# to azimuth angles.

in_table = r"C:/data/city.gdb/near_table"

angles = arcpy.da.SearchCursor(in_table, ["NEAR_ANGLE"])

azimuth_angles = []

with angles as rows:
    for row in rows:
        angle = row[0]
        if angle <= 180 and angle > 90:
            azimuth_angles.append(360.0 - (angle - 90))
        else:
            azimuth_angles.append(abs(angle - 90))

# Use these azimuth angles as necessary.

Ejemplo 4 de Near (script independiente)

El siguiente script de Python muestra el procesamiento posterior con la salida derivada de la función Near. Para cada entidad cercana, el script busca las entidades de entrada de las que está más cerca.

# Name: features_closest_to_input.py

"""
    This script finds, for each input feature, a list of near feature it is closest to.
    If near features 6, 7, 10 are closest to input feature 3 then the
    resulting dictionary will have a list [6, 7, 10] as value for key 3
"""

import os
import arcpy

in_fc = r"C:\data\cities.gdb\cities_many"

# create a dictionary to hold the list of near ids for each input id
nearest_dict = dict()

with arcpy.da.SearchCursor(in_fc, ["OID@", "NEAR_FID"]) as rows:
    for row in rows:
        nearest_id = row[0]  # get OID value for that row
        input_id = row[1]    # get NEAR_FID value

        if input_id in nearest_dict:
            # if a dict key already exists, append near id to value list for that key
            nearest_dict[input_id].append(nearest_id)
        else:
            # if the key does not exist then create a new list with near id
            # and add it to the dictionary
            nearest_dict[input_id] = [nearest_id]

print(nearest_dict)

# output will look like:
# {1: [13, 28], 2: [2, 9, 14, 20, 22], 3: [11, 12, 24, 25]}

Entornos

Extensión, Espacio de trabajo actual

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí

Cerca (Herramientas de análisis)

Resumen

Ilustración

Uso

Parámetros

Salida derivada

Entornos

Información de licenciamiento

Temas relacionados