Unión espacial (Herramientas de análisis)

Resumen

Une los atributos de una o más entradas con otra entrada 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 los siguientes campos a la clase de entidad de salida:
- Join_Count—El número de entidades de unión que coinciden con cada entidad de destino.
  
  Cuando el valor del parámetro Unir entidades es una entrada única, la salida tendrá un campo Join_Count por defecto. Cuando hay más de una entrada, el nombre del campo de recuento de uniones incluirá el nombre de la entrada de forma predeterminada, por ejemplo, Input1_JoinCount, Input2_JoinCount, etc. Personalice el nombre de este campo especificando la columna Nombre de campo de recuento de uniones.
- TARGET_FID—El Id. de objeto de la entidad de destino,
Se agregará un campo adicional, JOIN_FID, a la salida cuando el parámetro Operación de unión se establezca en Unir uno a muchos. Este campo representa el Id. del objeto de la entidad 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:
- El parámetro Operación de unión está configurado en Unión uno a uno.
- El parámetro Conservar todas las entidades de destino está marcado.
Para transferir campos de forma permanente a la clase de entidad de destino, use la herramienta Agregar unión espacial con el 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 es el mismo que el tipo de datos del primer campo de entrada (de ese nombre) que encuentra. 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 fusionará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.
- Utilice la opción Exportar para guardar un mapa de campo como un archivo .fieldmap.
- Utilice la opción Cargar para cargar un archivo .fieldmap. La capa de entidades o el dataset especificado en el archivo debe coincidir con el dataset utilizado en la herramienta. De lo contrario, el parámetro Mapa de campo se restablecerá.
- 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 en un script 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 sobre cómo se calcula 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 Coincidencia de atributos 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.

Etiqueta	Explicación	Tipo 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 ayuda del parámetro Operación de unión para obtener más información sobre cómo el tipo de operación de unión afecta a la agregación de atributos unidos. Utilice la columna Nombre de campo de recuento de uniones para especificar un nombre personalizado para el campo de recuento de uniones. Cuando hay más de una entrada, se utilizará por defecto el nombre de campo de la clase de entidad. Columnas de la tabla de valores: Join Features—The features whose attributes will be joined to the target features. Join Count Field Name—The name of the join count field.	Value Table
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 uno—Si 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 muchos—Si 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 de 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). Activado—Todas las entidades de destino se mantendrán en la salida (unión externa). Esta es la opción predeterminada. Desactivado—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 cuando el parámetro `match_option` está definido en `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. Las entidades de destino que no estén incluidas en una entidad de unión se excluirán 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. Intersección—Las 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 3D—Las 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 distancia—Las 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ésica—Es 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 3D—Las 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. Contiene—las 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 completamente—Las 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 Clementini—Esta 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 de—Tas 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 dentro—Las 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 Clementini—El 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 a—Las 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ímite—Las 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 con—Las 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 de—Las 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 en—Las 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 cercano—Se 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 cercano—Es 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ón—La 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. Un radio de búsqueda solo es válido cuando la relación espacial se ha especificado (el parámetro Opción de coincidencia está definido como 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álida si se ha especificado la relación espacial y el parámetro Opción de coincidencia se configura en 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. Columnas de la tabla de valores: Join Fields—Fields from the join features that will be used for attribute matching. Target Fields—Fields from the target features that will be used for attribute matching.	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})

Nombre	Explicación	Tipo 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 [join_features,...]	Los atributos de las entidades de unión se unirán a los atributos de las entidades de destino. Consulte la ayuda del parámetro `join_operation` para obtener más información sobre cómo el tipo de operación de unión afecta a la agregación de atributos unidos. Utilice la segunda columna para especificar un nombre personalizado para el campo de recuento de uniones. Cuando hay más de una entrada, se utilizará por defecto el nombre de campo de la clase de entidad. Columnas de la tabla de valores: `Join Features`—The features whose attributes will be joined to the target features. `Join Count Field Name`—The name of the join count field.	Value Table
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_ONE`—Si 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_MANY`—Si 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_ALL`—Todas las entidades de destino se mantendrán en la salida (unión externa). Esta es la opción predeterminada. `KEEP_COMMON`—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 cuando el parámetro `match_option` está definido en `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. Las entidades de destino que no estén incluidas en una entidad de unión se excluirán 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, utiliza la clase `FieldMappings` para definir este parámetro.	Field Mappings
match_option (Opcional)	Especifica los criterios que se utilizarán para la correspondencia de filas. `INTERSECT`—Las 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_3D`—Las 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_DISTANCE`—Las 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_GEODESIC`—Es 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_3D`—Las 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`. `CONTAINS`—las 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_CONTAINS`—Las 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_CLEMENTINI`—Esta 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. `WITHIN`—Tas 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_WITHIN`—Las entidades en las entidades de unión se harán coincidir si una entidad objetivo las contiene completamente. Es opuesto a `COMPLETELY_CONTAINS`. `WITHIN_CLEMENTINI`—El 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_TO`—Las 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_TOUCHES`—Las 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_WITH`—Las 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_OF`—Las 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_IN`—Las 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`. `CLOSEST`—Se 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_GEODESIC`—Es 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_OVERLAP`—La 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 y el parámetro `match_option` se configura en `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. Columnas de la tabla de valores: `Join Fields`—Fields from the join features that will be used for attribute matching. `Target Fields`—Fields from the target features that will be used for attribute matching.	Value Table

Muestra de código

Ejemplo 1 de SpatialJoin (ventana de Python)

En el siguiente script se 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)

Entornos

Valor Z de salida predeterminado, Resolución M, Tolerancia M, Palabra clave CONFIG de salida, Dominio M de salida, Dominio XY de salida, Dominio Z de salida, Sistema de coordenadas de salida, Extensión, La salida tiene valores M, La salida tiene valores Z, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z

Información de licenciamiento

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

Unión espacial (Herramientas de análisis)

Resumen

Uso

Parámetros

Entornos

Información de licenciamiento

Temas relacionados