Unión espacial (Análisis)

Resumen

Une los atributos de una entidad con otra basada en la relación espacial. Las entidades de destino y los atributos unidos de las entidades de unión se escriben en la clase de entidad de salida.

Más información sobre las relaciones Unión espacial por tipo de entidad

Uso

  • La unión espacial hace coincidir las filas de los valores de Entidades de unión con los valores de Entidades de destino según sus ubicaciones espaciales relativas.

  • De forma predeterminada, todos los atributos de las entidades de unión se incorporan a los atributos de las entidades de destino y se copian en la clase de entidad de salida. Puede definir qué atributos se especificarán en la salida mediante el parámetro Mapa del campo.

  • Se agregarán dos campos nuevos, Join_Count y TARGET_FID, a la clase de entidad de salida. El campo Join_Count indica el número de entidades de unión que coinciden con cada entidad de destino (TARGET_FID).

    Otro campo nuevo, JOIN_FID, se agregará a la salida cuando se especifica Unir uno a muchos para el parámetro Operación de unión.

  • Cuando el parámetro Operación Unión está definida como Unir de uno a muchos, puede haber más de una fila en la clase de entidad de salida para cada entidad de destino. Utilice el campo JOIN_FID para determinar qué entidad se une a qué entidad de destino (TARGET_FID). Un valor de -1 para el campo JOIN_FID significa que ninguna entidad cumple la relación espacial especificada con la entidad de destino.

  • Todas las entidades de destino de entrada se escribirán en la clase de entidad de salida si se aplican las dos condiciones siguientes:

    • Operación de unión está establecida en Unir uno a uno.
    • Mantener todas las entidades de destino está activada.

  • Para transferir campos de forma permanente a la clase de entidad de destino, use la herramienta Agregar unión espacial con su parámetro de Unir campos permanentemente activado.

  • Use el parámetro Mapa de campo para gestionar los campos y su contenido en el dataset de salida.

    • Añada y elimine campos de la lista de campos, reordene la lista de campos y cambie el nombre de los campos.
    • El tipo de datos predeterminado de un campo de salida coincide con el tipo de datos del primer campo de entrada (de ese nombre) que encuentre. Puede cambiar el tipo de datos a otro tipo de datos válido.
    • Use una acción para determinar cómo los valores de uno o varios campos de entrada se mezclarán en un solo campo de salida. Las acciones disponibles son Primera, Última, Concatenación, Suma, Valor medio, Mediana, Modo, Mínimo, Máximo, Desviación estándar y Recuento.
    • Al usar la acción Concatenar, pude especificar un delimitador tal como una coma u otro carácter. Haga clic en el inicio del cuadro de texto Delimitador para añadir los caracteres delimitadores.
    • Desviación estándar no es una opción válida para los valores de entrada únicos.
    • Use el botón Trocear texto en los campos de origen de texto para seleccionar qué caracteres de un valor de entrada se extraerán al campo de salida. Para acceder al botón Trocear texto, pase el cursor del ratón por encima de un campo de texto de la lista de campos de entrada; a continuación, especifique las posiciones de los caracteres de inicio y fin.
    • Los campos también se pueden asignar mediante scripts de Python.

  • Las acciones especificadas en el parámetro Mapa de campo solo se aplican a los atributos de las entidades de unión y cuando se coteja más de una entidad con una entidad de destino (cuando Join_Count > 1). Por ejemplo, si tres entidades con valores de atributo DEPTH de 15,5, 2,5 y 3,3 se unen, y se aplica la acción Valor medio, el campo de salida tendrá un valor de 6,1. Los valores nulos en los campos de unión se ignoran para el cálculo de estadísticas. Por ejemplo, 15,5, un valor nulo, y 2,5 resultará en 9,0 para Valor medio y 2 para Recuento.

  • Cuando el parámetro Opción de coincidencia se configura en Más cercano o Geodésico más cercano, es posible que dos o más entidades de unión estén a la misma distancia de la entidad de destino. Cuando esto ocurre, una de las entidades de unión se seleccionará de forma aleatoria como la entidad coincidente (el Id. de objeto de la entidad de unión no afecta a esta selección aleatoria). Para encontrar la segunda, tercera o enésima entidad más cercana, utilice la herramienta Genera tabla de cercanía.

    Más información acerca del cálculo de la proximidad

  • Si una entidad de unión tiene una relación espacial con varias entidades de destino, se contará tantas veces como coincidencias haya con la entidad de destino. Por ejemplo, si un punto está dentro de tres polígonos, el punto se contará tres veces, una vez por cada polígono.

  • El parámetro Atributos coincidentes filtra las entidades coincidentes en virtud de la relación espacial establecida por el parámetro Opción de correspondencia Especifique los campos de las entidades de unión y destino que deben tener atributos coincidentes además de su relación espacial.

  • Para obtener más información sobre el uso de las relaciones espaciales Intersecar 3D y Dentro de una distancia 3D, consulte Seleccionar por ubicación: relaciones 3D.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de destino

Los atributos de las entidades de destino y los atributos de las entidades unidas se transferirán a la clase de entidad de salida. Sin embargo, se puede definir un subconjunto de atributos mediante el parámetro del mapa de campo.

Feature Layer
Unir entidades

Los atributos de las entidades de unión se unirán a los atributos de las entidades de destino. Consulte la explicación del parámetro Operación de unión para obtener detalles sobre cómo la agregación de atributos unidos se ve afectada por el tipo de operación de unión.

Feature Layer
Clase de entidad de salida

Una nueva clase de entidad que contiene los atributos de las entidades de unión y de destino. De forma predeterminada, todos los atributos de las entidades de destino y los atributos de las entidades unidas se escribirán en la salida. Sin embargo, el conjunto de atributos que se transferirá se puede definir mediante el parámetro del mapa de campo.

Feature Class
Operación Unión
(Opcional)

La operación que unirá las entidades de destino y las entidades de unión de la clase de entidad de salida si se encuentra que varias entidades de unión tienen la misma relación espacial con una única entidad de destino.

  • Unir uno a unoSi se encuentran varias entidades de unión que tengan la misma relación espacial con una sola entidad de destino, se agregarán los atributos de las múltiples entidades de unión mediante una regla de fusión de asignación de campos. Por ejemplo, si se encuentra una entidad de destino de punto dentro de dos entidades de unión de polígono separadas, se agregarán los atributos de los dos polígonos antes de que se transfieran a la clase de entidad de puntos de salida. Si un polígono tiene un valor de atributo de 3 y el otro tiene un valor de 7 y se especifica una regla de fusión de Suma, el valor agregado en la clase de entidad de salida será 10. Esta es la opción predeterminada.
  • Unir uno a muchosSi se encuentran varias entidades de unión que tengan la misma relación espacial con una sola entidad de destino, la clase de entidad de salida contendrá varias copias (registros) de la entidad de destino. Por ejemplo, si se encuentra una única entidad de destino de un punto dentro de dos entidades de unión de polígonos independientes, la clase de entidad de salida contendrá dos copias de la entidad de destino: un registro con los atributos de un polígono y otro registro con los atributos del otro polígono.
String
Mantener todas las entidades destino
(Opcional)

Especifica si todas las entidades de destino se mantendrán en la clase de entidad de salida (unión externa) o solo aquellas que tienen la relación espacial especificada con las entidades de unión (unión interna).

  • Activada: todas las entidades de destino se mantendrán en la salida (unión externa). Esta es la opción predeterminada.
  • Desactivada: sólo se mantendrán en la clase de entidad de salida aquellas entidades de destino que tengan la relación espacial especificada con las entidades de unión (unión interna). Por ejemplo, si se especifica una clase de entidad de puntos para las entidades de destino y una clase de entidad poligonal para las entidades de unión, con un valor para Opción de correspondencia de Dentro de, la clase de entidad de salida solo contendrá aquellas entidades de destino que se encuentren dentro de una entidad de unión de polígono. Cualquier entidad de destino que no esté dentro de una entidad de unión se excluirá de la salida.
Boolean
Mapa de campo
(Opcional)

Loa campos que se incluirán en la clase de entidad de salida con sus respectivas propiedades y campos de origen. De manera predeterminada, la salida incluirá todos los campos de las entidades de unión y destino.

Use el campo de mapa para añadir, borrar, cambiar el nombre y reordenar los campos, así como para cambiar otras propiedades de los campos.

El mapa de campo puede usarse para combinar valores de dos o más campos de entrada en un solo campo de salida.

Field Mappings
Opción de correspondencia
(Opcional)

Especifica los criterios que se utilizarán para la correspondencia de filas.

  • IntersecarLas entidades de las entidades de unión se harán coincidir si se intersecan con una entidad objetivo. Esta es la opción predeterminada. Especifique la distancia en el parámetro Radio de búsqueda.
  • Intersecar 3DLas entidades de las entidades de unión se ajustarán si se intersecan con una entidad objetivo en el espacio tridimensional (x, y, z). Especifique la distancia en el parámetro Radio de búsqueda.
  • Dentro de una distanciaLas entidades en las entidades de unión se harán coincidir si están dentro de una distancia especificada de una entidad objetivo. Especifique la distancia en el parámetro Radio de búsqueda.
  • Dentro de una distancia geodésicaEs lo mismo que Dentro de una distancia, excepto que se utiliza una distancia geodésica en vez de una distancia planar. La distancia entre las entidades se calculará utilizando una fórmula geodésica que tiene en cuenta la curvatura del esferoide y trata correctamente los datos de los polos y la línea de cambio de fecha y los cercanos a estos. Utilice esta opción si los datos cubren una gran extensión geográfica o si el sistema de coordenadas de las entradas no es adecuado para los cálculos de distancia.
  • Dentro de una distancia 3DLas entidades en las entidades de unión se harán coincidir si están dentro a una distancia especificada de una entidad de destino en espacio tridimensional. Especifique la distancia en el parámetro Radio de búsqueda.
  • ContieneLas entidades en las entidades de unión se harán coincidir si una entidad de destino las contiene. Las entidades objetivo deben ser polilíneas o polígonos. Para esta opción, las entidades de destino no pueden ser puntos y las entidades de unión sólo pueden ser polígonos cuando las entidades de destino también son polígonos.
  • Contiene completamenteLas entidades en las entidades de unión se harán coincidir si una entidad de destino las contiene completamente. Un polígono puede contener completamente cualquier entidad. Un punto no puede contener completamente cualquier entidad, ni siquiera un punto. Una polilínea puede contener completamente solo entidades de polilínea y punto.
  • Contiene ClementiniEsta relación espacial produce los mismos resultados que Contiene completamente, excepto si la entidad de unión está completamente sobre el límite de la entidad objetivo (ninguna parte se encuentra totalmente dentro o fuera), la entidad no se hará coincidir. Clementini define el polígono de límite como la línea que separa el interior del exterior; el límite de una línea se define como sus extremos y el límite de un punto siempre está vacío.
  • Dentro deLas entidades en las entidades de unión se harán coincidir si una entidad de destino está dentro de ellas. Es contrario a Contiene. Para esta opción, las entidades de destino solo pueden ser polígonos cuando las entidades de unión también son polígonos. Un punto solo puede ser entidad de unión si el punto es el objetivo.
  • Completamente dentroLas entidades en las entidades de unión se harán coincidir si una entidad objetivo las contiene completamente. Esto es contrario a Contiene completamente.
  • Dentro de ClementiniEl resultado será idéntico a Dentro de excepto si la totalidad de la entidad de las entidades de unión está sobre el límite de la entidad de destino, la entidad no se cotejará. Clementini define el polígono de límite como la línea que separa el interior del exterior; el límite de una línea se define como sus extremos y el límite de un punto siempre está vacío.
  • Son idénticos aLas entidades en las entidades de unión se harán coincidir si son idénticas a una entidad objetivo. Tanto la entidad de unión como la de destino deben ser del mismo tipo de forma, punto a punto, línea a línea o polígono a polígono.
  • Toca el límiteLas entidades de las entidades de unión se harán coincidir si tienen un límite que toca a una entidad objetivo. Cuando las entidades de unión y de destino son líneas o polígonos, el límite de la entidad de unión solo puede tocar el límite de la entidad de destino y ninguna parte de la entidad de unión puede cruzar el límite de la entidad de destino.
  • Comparten un segmento de línea conLas entidades de las entidades de unión se harán coincidir si comparten un segmento de línea con una entidad objetivo. Las entidades de unión y de destino deben ser líneas o polígonos.
  • Cruzado por el contorno deLas entidades en las entidades de unión se harán coincidir si una entidad de destino está cruzada por su contorno. Las entidades de unión y de destino deben ser líneas o polígonos. Si se utilizan polígonos para las entidades objetivo o de unión, se utilizarán los límites (las líneas) del polígono. Se harán coincidir las líneas que se cruzan en un punto, no las que comparten un segmento de línea.
  • Tienen su centro enLas entidades en las entidades de unión se harán coincidir si el centro de una entidad objetivo está dentro de las mismas. El centro de la entidad se calcula del modo siguiente: para los polígonos y los multipuntos se utiliza el centroide de la geometría, y para la entrada de línea se utiliza el punto medio de la geometría. Especifique la distancia en el parámetro Radio de búsqueda.
  • Más cercanoSe hará coincidir la entidad en las entidades de unión que está más cerca de una entidad de destino. Consulte la sugerencia de uso para obtener más información. Especifique la distancia en el parámetro Radio de búsqueda.
  • Geodésico más cercanoEs lo mismo que Más cercano, excepto que se utiliza una distancia geodésica en vez de una distancia planar. Utilice esta opción si los datos cubren una gran extensión geográfica o si el sistema de coordenadas de las entradas no es adecuado para los cálculos de distancia.
  • Mayor superposiciónLa entidad de las entidades de unión se hará coincidir con la entidad de destino con mayor superposición.
String
Radio de búsqueda
(Opcional)

Las entidades de unión que se encuentren dentro de esta distancia de una entidad de destino se considerarán para la unión espacial. El radio de búsqueda solo es válido cuando se especifica la relación espacial (el parámetro Opción de coincidencia se configura en Intersecar, Dentro de una distancia, Dentro de una distancia geodésica, Tienen su centro en, Más cercano o Geodésico más cercano). Por ejemplo, si se utiliza un radio de búsqueda de 100 metros con la relación espacial Dentro de una distancia, se unirá la entidad que se encuentre dentro de un radio de 100 metros de una entidad de destino. En las tres relaciones Dentro de una distancia, si no se especifica ningún valor en Radio de Búsqueda, se utiliza una distancia de 0.

Linear Unit
Nombre de campo de distancia
(Opcional)

El nombre del campo que contiene la distancia entre la entidad de destino y la entidad de unión más cercana. Este campo se agregará a la clase de entidad de salida. Este parámetro solo es válido cuando se especifica la relación espacial (Opción de correspondencia establecido como Más cercano o Geodésico más cercano). El valor de este campo es -1 si no coincide ninguna entidad dentro de un radio de búsqueda. Si no se proporciona ningún nombre de campo, el campo no se agregará a la clase de entidad de salida.

String
Campos coincidentes
(Opcional)

Pares de campos de las entidades de unión y las entidades de destino que se van a usar para la coincidencia de atributos. Solo los registros de las entidades de unión que comparten valores de campos coincidentes con las entidades de destino participarán en la unión espacial.

Value Table

arcpy.analysis.SpatialJoin(target_features, join_features, out_feature_class, {join_operation}, {join_type}, {field_mapping}, {match_option}, {search_radius}, {distance_field_name}, {match_fields})
NombreExplicaciónTipo de datos
target_features

Los atributos de las entidades de destino y los atributos de las entidades unidas se transferirán a la clase de entidad de salida. Sin embargo, se puede definir un subconjunto de atributos mediante el parámetro del mapa de campo.

Feature Layer
join_features

Los atributos de las entidades de unión se unirán a los atributos de las entidades de destino. Consulte la explicación del parámetro join_operation para obtener detalles sobre cómo la agregación de atributos unidos se ve afectada por el tipo de operación de unión.

Feature Layer
out_feature_class

Una nueva clase de entidad que contiene los atributos de las entidades de unión y de destino. De forma predeterminada, todos los atributos de las entidades de destino y los atributos de las entidades unidas se escribirán en la salida. Sin embargo, el conjunto de atributos que se transferirá se puede definir mediante el parámetro del mapa de campo.

Feature Class
join_operation
(Opcional)

La operación que unirá las entidades de destino y las entidades de unión de la clase de entidad de salida si se encuentra que varias entidades de unión tienen la misma relación espacial con una única entidad de destino.

  • JOIN_ONE_TO_ONESi se encuentran varias entidades de unión que tengan la misma relación espacial con una sola entidad de destino, se agregarán los atributos de las múltiples entidades de unión mediante una regla de fusión de asignación de campos. Por ejemplo, si se encuentra una entidad de destino de punto dentro de dos entidades de unión de polígono separadas, se agregarán los atributos de los dos polígonos antes de que se transfieran a la clase de entidad de puntos de salida. Si un polígono tiene un valor de atributo de 3 y el otro tiene un valor de 7 y se especifica una regla de fusión de Suma, el valor agregado en la clase de entidad de salida será 10. Esta es la opción predeterminada.
  • JOIN_ONE_TO_MANYSi se encuentran varias entidades de unión que tengan la misma relación espacial con una sola entidad de destino, la clase de entidad de salida contendrá varias copias (registros) de la entidad de destino. Por ejemplo, si se encuentra una única entidad de destino de un punto dentro de dos entidades de unión de polígonos independientes, la clase de entidad de salida contendrá dos copias de la entidad de destino: un registro con los atributos de un polígono y otro registro con los atributos del otro polígono.
String
join_type
(Opcional)

Especifica si todas las entidades de destino se mantendrán en la clase de entidad de salida (unión externa) o solo aquellas que tienen la relación espacial especificada con las entidades de unión (unión interna).

  • KEEP_ALLTodas las entidades de destino se mantendrán en la salida (unión externa). Esta es la opción predeterminada.
  • KEEP_COMMONSólo se mantendrán en la clase de entidad de salida aquellas entidades de destino que tengan la relación espacial especificada con las entidades de unión (unión interna). Por ejemplo, si se especifica una clase de entidad de puntos para las entidades de destino y una clase de entidad poligonal para las entidades de unión, con un valor de match_option de WITHIN, la clase de entidad de salida solo contendrá aquellas entidades de destino que se encuentren dentro de una entidad de unión de polígono. Cualquier entidad de destino que no esté dentro de una entidad de unión se excluirá de la salida.
Boolean
field_mapping
(Opcional)

Loa campos que se incluirán en la clase de entidad de salida con sus respectivas propiedades y campos de origen. De manera predeterminada, la salida incluirá todos los campos de las entidades de unión y destino.

Use el campo de mapa para añadir, borrar, cambiar el nombre y reordenar los campos, así como para cambiar otras propiedades de los campos.

El mapa de campo puede usarse para combinar valores de dos o más campos de entrada en un solo campo de salida.

En Python, utilice la clase de FieldMappings para definir este parámetro.

Field Mappings
match_option
(Opcional)

Especifica los criterios que se utilizarán para la correspondencia de filas.

  • INTERSECTLas entidades de las entidades de unión se harán coincidir si se intersecan con una entidad objetivo. Esta es la opción predeterminada. Especifique la distancia en el parámetro search_radius.
  • INTERSECT_3DLas entidades de las entidades de unión se ajustarán si se intersecan con una entidad objetivo en el espacio tridimensional (x, y, z). Especifique la distancia en el parámetro search_radius.
  • WITHIN_A_DISTANCELas entidades en las entidades de unión se harán coincidir si están dentro de una distancia especificada de una entidad objetivo. Especifique la distancia en el parámetro search_radius.
  • WITHIN_A_DISTANCE_GEODESICEs lo mismo que WITHIN_A_DISTANCE, excepto que se utiliza una distancia geodésica en vez de una distancia planar. La distancia entre las entidades se calculará utilizando una fórmula geodésica que tiene en cuenta la curvatura del esferoide y trata correctamente los datos de los polos y la línea de cambio de fecha y los cercanos a estos. Utilice esta opción si los datos cubren una gran extensión geográfica o si el sistema de coordenadas de las entradas no es adecuado para los cálculos de distancia.
  • WITHIN_A_DISTANCE_3DLas entidades en las entidades de unión se harán coincidir si están dentro a una distancia especificada de una entidad de destino en espacio tridimensional. Especifique la distancia en el parámetro search_radius.
  • CONTAINSLas entidades en las entidades de unión se harán coincidir si una entidad de destino las contiene. Las entidades objetivo deben ser polilíneas o polígonos. Para esta opción, las entidades de destino no pueden ser puntos y las entidades de unión sólo pueden ser polígonos cuando las entidades de destino también son polígonos.
  • COMPLETELY_CONTAINSLas entidades en las entidades de unión se harán coincidir si una entidad de destino las contiene completamente. Un polígono puede contener completamente cualquier entidad. Un punto no puede contener completamente cualquier entidad, ni siquiera un punto. Una polilínea puede contener completamente solo entidades de polilínea y punto.
  • CONTAINS_CLEMENTINIEsta relación espacial produce los mismos resultados que COMPLETELY_CONTAINS, excepto si la entidad de unión está completamente sobre el límite de la entidad objetivo (ninguna parte se encuentra totalmente dentro o fuera), la entidad no se hará coincidir. Clementini define el polígono de límite como la línea que separa el interior del exterior; el límite de una línea se define como sus extremos y el límite de un punto siempre está vacío.
  • WITHINLas entidades en las entidades de unión se harán coincidir si una entidad de destino está dentro de ellas. Es opuesto a CONTAINS. Para esta opción, las entidades de destino solo pueden ser polígonos cuando las entidades de unión también son polígonos. Un punto solo puede ser entidad de unión si el punto es el objetivo.
  • COMPLETELY_WITHINLas entidades en las entidades de unión se harán coincidir si una entidad objetivo las contiene completamente. Es opuesto a COMPLETELY_CONTAINS.
  • WITHIN_CLEMENTINIEl resultado será idéntico a WITHIN si la totalidad de la entidad de las entidades de unión está sobre el límite de la entidad de destino, la entidad no se hará coincidir. Clementini define el polígono de límite como la línea que separa el interior del exterior; el límite de una línea se define como sus extremos y el límite de un punto siempre está vacío.
  • ARE_IDENTICAL_TOLas entidades en las entidades de unión se harán coincidir si son idénticas a una entidad objetivo. Tanto la entidad de unión como la de destino deben ser del mismo tipo de forma, punto a punto, línea a línea o polígono a polígono.
  • BOUNDARY_TOUCHESLas entidades de las entidades de unión se harán coincidir si tienen un límite que toca a una entidad objetivo. Cuando las entidades de unión y de destino son líneas o polígonos, el límite de la entidad de unión solo puede tocar el límite de la entidad de destino y ninguna parte de la entidad de unión puede cruzar el límite de la entidad de destino.
  • SHARE_A_LINE_SEGMENT_WITHLas entidades de las entidades de unión se harán coincidir si comparten un segmento de línea con una entidad objetivo. Las entidades de unión y de destino deben ser líneas o polígonos.
  • CROSSED_BY_THE_OUTLINE_OFLas entidades en las entidades de unión se harán coincidir si una entidad de destino está cruzada por su contorno. Las entidades de unión y de destino deben ser líneas o polígonos. Si se utilizan polígonos para las entidades objetivo o de unión, se utilizarán los límites (las líneas) del polígono. Se harán coincidir las líneas que se cruzan en un punto, no las que comparten un segmento de línea.
  • HAVE_THEIR_CENTER_INLas entidades en las entidades de unión se harán coincidir si el centro de una entidad objetivo está dentro de las mismas. El centro de la entidad se calcula del modo siguiente: para los polígonos y los multipuntos se utiliza el centroide de la geometría, y para la entrada de línea se utiliza el punto medio de la geometría. Especifique la distancia en el parámetro search_radius.
  • CLOSESTSe hará coincidir la entidad en las entidades de unión que está más cerca de una entidad de destino. Consulte la sugerencia de uso para obtener más información. Especifique la distancia en el parámetro search_radius.
  • CLOSEST_GEODESICEs lo mismo que CLOSEST, excepto que se utiliza una distancia geodésica en vez de una distancia planar. Utilice esta opción si los datos cubren una gran extensión geográfica o si el sistema de coordenadas de las entradas no es adecuado para los cálculos de distancia.
  • LARGEST_OVERLAPLa entidad de las entidades de unión se hará coincidir con la entidad de destino con mayor superposición.
String
search_radius
(Opcional)

Las entidades de unión que se encuentren dentro de esta distancia de una entidad de destino se considerarán para la unión espacial. El radio de búsqueda solo es válido cuando se especifica la relación espacial (el parámetro match_option está establecido en INTERSECT, WITHIN_A_DISTANCE, WITHIN_A_DISTANCE_GEODESIC, HAVE_THEIR_CENTER_IN, CLOSEST o CLOSEST_GEODESIC). Por ejemplo, si se utiliza un radio de búsqueda de 100 metros con la relación espacial WITHIN_A_DISTANCE, se unirá la entidad que se encuentre dentro de un radio de 100 metros de una entidad de destino. En las tres relaciones Dentro de una distancia, si no se especifica ningún valor para search_radius, se utiliza una distancia de 0.

Linear Unit
distance_field_name
(Opcional)

El nombre del campo que contiene la distancia entre la entidad de destino y la entidad de unión más cercana. Este campo se agregará a la clase de entidad de salida. Este parámetro solo es válido cuando se especifica la relación espacial (match_option establecido como CLOSEST o CLOSEST_GEODESIC). El valor de este campo es -1 si no coincide ninguna entidad dentro de un radio de búsqueda. Si no se proporciona ningún nombre de campo, el campo no se agregará a la clase de entidad de salida.

String
match_fields
[[join_field, target_field],...]
(Opcional)

Pares de campos de las entidades de unión y las entidades de destino que se van a usar para la coincidencia de atributos. Solo los registros de las entidades de unión que comparten valores de campos coincidentes con las entidades de destino participarán en la unión espacial.

Value Table

Muestra de código

Ejemplo 1 de SpatialJoin (ventana de Python)

El siguiente script muestra cómo utilizar la función SpatialJoin en una ventana de Python.

import arcpy

target_features = "C:/data/usa.gdb/states"
join_features = "C:/data/usa.gdb/cities"
out_feature_class = "C:/data/usa.gdb/states_cities"

arcpy.analysis.SpatialJoin(target_features, join_features, out_feature_class)
Ejemplo 2 de SpatialJoin (secuencia de comandos independiente)

El siguiente script independiente muestra cómo utilizar la función SpatialJoin para unir los atributos de las ciudades a los estados.

# Name: SpatialJoin_Example2.py
# Description: Join attributes of cities to states based on spatial relationships.

# Import system modules
import arcpy
import os

# Set local variables
workspace = r"C:\gpqa\mytools\spatialjoin\usa.gdb"
outWorkspace = r"C:\gpqa\mytools\spatialjoin\output.gdb"
 
# Want to join USA cities to states and calculate the mean city population
# for each state
targetFeatures = os.path.join(workspace, "states")
joinFeatures = os.path.join(workspace, "cities")
 
# Output will be the target features, states, with a mean city population field (mcp)
outfc = os.path.join(outWorkspace, "states_mcp2")
 
# Create a new fieldmappings and add the two input feature classes.
fieldmappings = arcpy.FieldMappings()
fieldmappings.addTable(targetFeatures)
fieldmappings.addTable(joinFeatures)
 
# First get the POP1990 fieldmap. POP1990 is a field in the cities feature class.
# The output will have the states with the attributes of the cities. Setting the
# field's merge rule to mean will aggregate the values for all of the cities for
# each state into an average value. The field is also renamed to be more appropriate
# for the output.
pop1990FieldIndex = fieldmappings.findFieldMapIndex("POP1990")
fieldmap = fieldmappings.getFieldMap(pop1990FieldIndex)
 
# Get the output field's properties as a field object
field = fieldmap.outputField
 
# Rename the field and pass the updated field object back into the field map
field.name = "mean_city_pop"
field.aliasName = "mean_city_pop"
fieldmap.outputField = field
 
# Set the merge rule to mean and then replace the old fieldmap in the mappings object
# with the updated one
fieldmap.mergeRule = "mean"
fieldmappings.replaceFieldMap(pop1990FieldIndex, fieldmap)
 
# Delete fields that are no longer applicable, such as city CITY_NAME and CITY_FIPS
# as only the first value will be used by default
x = fieldmappings.findFieldMapIndex("CITY_NAME")
fieldmappings.removeFieldMap(x)
y = fieldmappings.findFieldMapIndex("CITY_FIPS")
fieldmappings.removeFieldMap(y)
 
#Run the Spatial Join tool, using the defaults for the join operation and join type
arcpy.analysis.SpatialJoin(targetFeatures, joinFeatures, outfc, "#", "#", fieldmappings)