Unir entidades (Geoanálisis)

Resumen

Une atributos de una capa con otra en función de las relaciones espaciales, temporales o de atributos o de una combinación de dichas relaciones.

Ilustración

Ilustración de la herramienta Unir entidades
Ambos ejemplos muestran una unión espaciotemporal utilizando la herramienta Unir entidades.

Uso

  • Una unión espacial hace coincidir las entidades (filas) de las entidades de entrada (valores de los parámetros Capa de destino y Capa de unión) en función de sus ubicaciones espaciales. Una unión temporal hace coincidir las entidades (filas) de las entidades de entrada en función de sus relaciones temporales. Un atributo de unión hace coincidir entidades según los valores de campo.

  • Puede unir entidades basándose en una relación espacial, una relación temporal, una relación de atributos o una combinación de las tres.

    OpcionesDescripción

    Relación espacial

    La relación espacial que determinará si las entidades se van a unir entre sí. Las relaciones disponibles dependen del tipo de geometría (punto, línea o área) de las capas que se unen. Las relaciones espaciales disponibles son las siguientes:

    • Interseca
    • Es igual a
    • Cercanía planar: utiliza distancias planares.
    • Cercanía geodésica: utiliza distancias geodésicas. Esto solo está disponible en ArcGIS Enterprise 10.7.1 y versiones posteriores.
    • Contiene
    • Dentro de
    • Toca
    • Cruza
    • Superpone

    Más información sobre las relaciones espaciales en las herramientas de GeoAnalytics Server

    Relación temporal

    La relación temporal que determinará si las entidades se van a unir entre sí. Las relaciones disponibles dependen del tipo de tiempo (instante o intervalo) de las capas que se unen. Las relaciones temporales disponibles son las siguientes:

    • Cumple
    • Alcanzado por
    • Superpone
    • Superpuesto por
    • Durante
    • Contiene
    • Es igual a
    • Finaliza
    • Finalizado por
    • Se inicia
    • Iniciado por
    • Interseca
    • Cerca
    • Cerca de después
    • Cerca de antes

    Más información sobre las relaciones temporales en las herramientas de GeoAnalytics Server

    Relación de atributos

    La relación de atributos que determinará si las entidades se unen entre sí. Las entidades se cotejan si los valores de campo de la capa de unión son iguales a los valores de campo de la capa de destino.

  • Si las entidades de destino y de unión están en sistemas de coordenadas diferentes, se usará el sistema de coordenadas de la entidad de destino. Si se ha especificado un sistema de coordenadas de salida, las dos entidades se proyectan en el sistema de coordenadas de salida y después se unen.

  • Cuando el valor del parámetro Relación espacial es Cercanía planar, el valor del parámetro Capa de destino debe ser proyectado o el sistema de coordenadas de salida debe establecerse en un sistema de coordenadas proyectado.

  • Si varias entidades coinciden con la misma entidad de destino, puede decidir si todas las entidades coincidentes se unirán (Operación Unión establecida en Unión de uno a muchos) o si todas las entidades coincidentes se resumirán juntas (Operación Unión establecida en Unión de uno a uno) como se muestra a continuación:

    • Unir uno a muchos: une todas las entidades coincidentes de la capa de unión con la capa de destino. La capa de resultados contendrá varios registros de la entidad de destino.
    • Unión de uno a uno: resume todas las entidades de unión coincidentes con cada entidad de la capa de destino. Solo las entidades que tengan una coincidencia se incluirán en el resumen y en la salida. El recuento de entidades unidas se agregará junto con otras estadísticas como, por ejemplo, suma, mínimo, máximo, rango, valor medio, varianza y desviación estándar. Por defecto, solo las entidades de destino que tengan las relaciones especificadas se mantendrán en la clase de entidad de salida (es lo que se conoce como unión interna). Si la opción Mantener todas las entidades de destino está activada, todas las entidades de destino de entrada se escribirán en la clase de entidad de salida (es lo que se conoce como unión externa izquierda).
    Ejemplos de unión de uno a muchos y de uno a uno
    Se muestran ejemplos de unión de uno a muchos y de uno a uno. En este ejemplo, en la unión de uno a uno solo se incluye el recuento; las estadísticas adicionales que se pueden calcular se muestran debajo.

  • Puede crear una expresión para unir entidades mediante el parámetro Condición de unión. Si especifica una expresión, solo se van a utilizar las entidades que cumplan esta condición. Por ejemplo, mediante la expresión $target["Magnitude"] > $join["Explosion"], solo puede unir las entidades de destino del campo Magnitude si son mayores que la unidad de unión con un campo denominado Explosion. Consulte Expresiones de Unir entidades para obtener más información.

  • Cuando se ejecuta una unión de uno a muchos, los siguientes campos se incluyen en las entidades de salida:

    • Todos los campos de las capas de destino
    • Todos los campos de la capa unida

    Si existe el mismo nombre de campo en los dataset de destino y de unión, el campo unido comenzará con la palabra unión (join) (por ejemplo, join_fieldname).

    Nombre de campoDescripción

    start_datetime

    Este campo representa la hora de inicio y se crea cuando la entrada tiene el tiempo establecido como un instante o intervalo.

    end_datetime

    Este campo representa la hora de finalización y se crea cuando la entrada tiene el tiempo establecido como intervalo.

    Además de todos los campos de la capa de destino, los siguientes campos se incluyen en las entidades de salida cuando se ejecuta una unión uno a uno:

    Nombre de campoDescripción

    count

    Recuento de entidades que se han unido.

    statistic_fieldname

    Cada una de las estadísticas especificadas creará un campo de atributo con el siguiente formato: nombre_ampo_estadística. Por ejemplo, la desviación máxima y estándar del campo id es MAX_id y SD_id.

    start_datetime

    Este campo representa la hora de inicio y se crea cuando la entrada tiene el tiempo establecido como un instante o intervalo.

    end_datetime

    Este campo representa la hora de finalización y se crea cuando la entrada tiene el tiempo establecido como intervalo.

  • Si el parámetro Incluir distancia está activado y el parámetro Operación Unir está establecido en Unir uno a muchos, los siguientes campos pueden incluirse en las entidades de salida:

    Nombre de campoDescripción

    distance

    Distancia entre entidades de destino y unión. Este campo se incluye si el parámetro Relación espacial está establecido en Cercanía planar o Cercanía geodésica.

    Una distancia de 0 indica que las geometrías de destino y de unión intersecan. Un valor nulo indica que las geometrías están más alejadas que el valor del parámetro Distancia de cercanía espacial. Si el valor del parámetro Relación espacial es Cercanía planar, los valores de distancia serán planares; si el valor del parámetro es Cercanía geodésica, los valores de distancia serán geodésicos. Los valores se expresarán en las unidades especificadas por el parámetro Unidad de distancia. La unidad de distancia por defecto es metros.

    timegap

    Diferencia temporal en milisegundos entre las entidades de destino y de unión. Este campo se incluye si el parámetro Relación temporal está establecido en Cerca de, Cerca de antes o Cerca de después.

    Una diferencia de 0 indica que las entidades de destino y de unión intersecan temporalmente. Los valores positivos significan que la entidad de destino se produce antes que la entidad de unión, y los valores negativos significan que la entidad de unión se produce antes que la entidad de destino. Los valores nulos indican que las entidades no cumplían la condición de unión. Por ejemplo, las características están más alejadas que el valor del parámetro Distancia de cercanía temporal.

  • Puede mejorar el rendimiento de la herramienta Unir entidades siguiendo uno o varios de estos pasos:

    • Defina el entorno de extensión para analizar únicamente datos de interés.
    • Haga que las condiciones de unión sean lo más selectivas posible. Por ejemplo, una unión cercana de 1 kilómetro funcionará mejor que una unión cercana de 5 kilómetros en los mismos datos.
    • Agregue más de una condición de unión. Las condiciones de unión adicionales hacen que la unión sea más selectiva. Por ejemplo, una unión cercana de 1 kilómetro y 1 hora funcionará mejor que una unión cercana de 5 kilómetros en los mismos datos.
    • Aplique una expresión de unión.
    • Utilice datos locales en los que se ejecute el análisis.

  • Es posible realizar análisis similares con la herramienta Unión espacial de la caja de herramientas Análisis.

  • Esta herramienta de geoprocesamiento se basa en ArcGIS GeoAnalytics Server. El análisis se completa en su GeoAnalytics Server y los resultados se almacenan en su contenido en ArcGIS Enterprise.

  • Al ejecutar herramientas de GeoAnalytics Server, el análisis se completa en GeoAnalytics Server. Para obtener un rendimiento óptimo, haga que los datos estén disponibles para GeoAnalytics Server mediante capas de entidades alojadas en su portal de ArcGIS Enterprise o mediante recursos compartidos de archivos de big data. Los datos que no son locales para su GeoAnalytics Server se moverán a GeoAnalytics Server antes de que comience el análisis. Significa que ejecutar una herramienta tardará más tiempo y, en algunos casos, mover los datos de ArcGIS Pro a GeoAnalytics Server podría fallar. El umbral de error depende de la velocidad de su red, así como del tamaño y complejidad de los datos. Se recomienda que siempre comparta sus datos o que cree un recurso compartido de archivos de big data.

    Más información acerca del uso compartido de datos en el portal

    Más información sobre cómo crear un archivo compartido de Big Data mediante Server Manager

Parámetros

EtiquetaExplicaciónTipo de datos
Capa de destino

Contiene las entidades de destino. Los atributos de las entidades de destino y los atributos de las entidades unidas se transferirán a la salida.

Record Set
Capa de unión

Contiene las entidades de unión. 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 Unir para obtener detalles acerca de cómo la agregación de atributos unidos se ve afectada por el tipo de operación de unión.

Record Set
Nombre de salida

El nombre del servicio de entidades de salida.

String
Operación Unión

Especifica cómo se tratarán en la salida las uniones entre los valores de Capa de destino y los valores de Capa de unión si hay varias entidades de unión que tienen la misma relación espacial con una única entidad de destino.

  • Unir uno a unoSe agregarán los atributos de las distintas entidades de unión. Por ejemplo, si una entidad de destino de punto se encuentra 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 suma de resumen de estadísticas para ese campo, el valor consolidado en la clase de entidad de salida será 10. Esta es la configuración predeterminada y únicamente se devuelve la estadística de recuento.
  • Unir uno a muchosLa clase de entidad de salida contendrá varias copias (registros) de la entidad de destino. Por ejemplo, si una única entidad de destino de un punto se encuentra 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. No hay estadísticas de resumen disponibles con esta opción.
String
Relación espacial
(Opcional)

Especifica los criterios que se utilizarán para unir entidades espacialmente.

  • IntersecaLas entidades de las entidades de unión se harán coincidir si se intersecan con una entidad objetivo. Esta es la opción predeterminada.
  • Es igual aLas entidades de las entidades de unión se harán coincidir si tienen la misma geometría que una entidad de destino.
  • Cercanía planarLas entidades en las entidades de unión se harán coincidir si están dentro de una distancia especificada de una entidad objetivo. La distancia se mide con la distancia planar. Especifique una distancia en el parámetro Distancia de cercanía espacial.
  • Cercanía geodésicaLas entidades de las entidades de unión se harán coincidir si están dentro de una distancia especificada de una entidad de destino. La distancia se mide a nivel geodésico. Especifique una distancia en el parámetro Distancia de cercanía espacial. Esta opción está disponible con ArcGIS Enterprise 10.7 o posterior.
  • 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. Las entidades de unión solo pueden ser polígonos cuando las entidades de destino también son polígonos. Un polígono puede contener cualquier tipo de entidad. Una polilínea puede contener únicamente polilíneas y puntos. Un punto no puede contener ninguna entidad, ni siquiera un punto. Si la entidad de unión reside completamente en el límite de la entidad de destino (ninguna parte está dentro o fuera), la entidad no tendrá coincidencia.
  • Dentro deTas entidades en las entidades de unión se harán coincidir si una entidad de destino está dentro de ellas. Esto es lo opuesto a la relación Contiene. Las entidades de destino solo pueden ser polígonos cuando las entidades de unión también son polígonos. Un punto puede ser una entidad de unión solo si el punto es también una entidad de destino. 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.
  • TocaLas 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.
  • CruzaLas 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, pero no las que comparten un segmento de línea.
  • SuperponeLas entidades de las entidades de unión se harán coincidir si se superponen con una entidad de destino.
String
Distancia de cercanía espacial
(Opcional)

La distancia respecto de una entidad de destino dentro de la cual las entidades de unión se tendrán en cuenta para la unión espacial. Un radio de búsqueda solo es válido cuando el valor del parámetro Relación espacial es Cercanía planar o Cercanía geodésica.

Linear Unit
Relación temporal
(Opcional)

Especifica los criterios de tiempo que se utilizarán para la coincidencia de las entidades.

  • CumpleCuando el final de un intervalo de tiempo de destino es igual que el inicio del intervalo de tiempo de unión, el tiempo de destino alcanza al tiempo de unión.
  • Alcanzado porCuando el inicio de un intervalo de tiempo de destino es igual que el final del intervalo de tiempo de unión, el tiempo de destino es alcanzado por el tiempo de unión.
  • SuperponeCuando el intervalo de tiempo de destino empieza y termina antes del inicio y el final del intervalo de tiempo de unión, el tiempo de destino se superpone sobre el tiempo de unión.
  • Superpuesto porCuando el intervalo de tiempo de destino empieza y termina después del inicio y el final del intervalo de tiempo de unión, el tiempo de unión se superpone sobre el tiempo de destino.
  • DuranteCuando el tiempo de destino está entre el inicio y el final del intervalo de tiempo de unión, el tiempo de destino se da durante el tiempo de unión.
  • ContieneCuando el tiempo de la entidad de unión está entre el inicio y el final del intervalo de tiempo de destino, el tiempo de destino contiene el tiempo de unión.
  • Es igual aDos tiempos se consideran iguales si sus instantes o intervalos son idénticos.
  • FinalizaCuando un tiempo de destino termina al mismo tiempo que un tiempo de unión, y el tiempo de destino se inició después del tiempo de unión, el tiempo de destino finaliza el tiempo de unión.
  • Finalizado porCuando el tiempo de una entidad de unión termina al mismo tiempo que un tiempo de destino, y el tiempo de unión se inició después del tiempo de destino, el tiempo de unión finaliza el tiempo de destino.
  • Se iniciaCuando un tiempo de destino comienza al mismo tiempo que el intervalo de tiempo de unión y termina antes del fin del intervalo de tiempo de unión, el tiempo de destino inicia el tiempo de unión.
  • Iniciado porCuando el tiempo de un intervalo de destino comienza al mismo tiempo que el tiempo de unión y termina después del tiempo de unión, el tiempo de unión inicia el tiempo de destino.
  • IntersecaCuando cualquier parte de un tiempo de destino se produce al mismo tiempo que el tiempo de unión, el tiempo de destino se interseca con el tiempo de unión.
  • CercaCuando un tiempo de destino está dentro de un rango de tiempo especificado con respecto al tiempo de unión, el tiempo de destino estará cerca del tiempo de unión.
  • Justo antesCuando un tiempo de destino es anterior al tiempo de unión, pero está dentro de un rango de tiempo especificado con respecto al tiempo de unión, el tiempo de destino estará cerca de antes del tiempo de unión. Esta opción está disponible con ArcGIS Enterprise 10.6 o posterior.
  • Justo despuésCuando un tiempo de destino es posterior al tiempo de unión, pero está dentro de un rango de tiempo especificado con respecto al tiempo de unión, el tiempo de destino estará cerca de después del tiempo de unión. Esta opción está disponible con ArcGIS Enterprise 10.6 o posterior.
String
Distancia de cercanía temporal
(Opcional)

La distancia en el tiempo respecto de una entidad de destino dentro de la cual las entidades de unión se tendrán en cuenta para la unión espacial. Un tiempo solo es válido cuando el valor del parámetro Relación temporal es Cerca, Cerca de antes o Cerca de después y las dos entidades tienen el tiempo habilitado.

Time Unit
Relación de atributos
(Opcional)

Une las entidades en función de los valores de un campo de atributos. Especifique el campo de atributo de la capa de destino que coincide con un campo de atributo de la capa de unión.

  • Campo de destino: un campo de atributo de la capa de destino que contiene los valores que se deben hacer coincidir.
  • Campo de unión: un campo de atributo de la capa de unión que contiene los valores que se deben hacer coincidir.

Value Table
Campos de resumen
(Opcional)

Las estadísticas que se calcularán en campos concretos.

Value Table
Condición de unión
(Opcional)

Aplica una condición a los campos especificados. Solo se unirán las entidades con campos que cumplan estas condiciones.

Por ejemplo, puede aplicar una condición de unión a las entidades en las que el atributo HealthSpending de la capa de unión sea superior al 20 por ciento del atributo Income de la capa de destino. En ArcGIS Enterprise 10.5 y 10.5.1, la condición de unión para aplicar esta expresión es join["HealthSpending"] > target["Income"] * .2. En ArcGIS Enterprise 10.6 o posterior, utilice una expresión Arcade, como, por ejemplo, $join["HealthSpending"] > $target["Income"] * .2.

Si se agrega la capa al mapa, es posible usar los filtros Campos y Auxiliares para construir una expresión.

Más información sobre las expresiones de Unir entidades en 10.6

String
Data store
(Opcional)

Especifica el ArcGIS Data Store en el que se guardará la salida. Por defecto es big data store espaciotemporal. Todos los resultados almacenados en un big data store espaciotemporal se almacenarán en WGS84. Los resultados almacenados en un data store relacional mantendrán su sistema de coordenadas.

  • Big data store espaciotemporalLa salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada.
  • Data store relacionalLa salida se almacenará en un data store relacional.
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 izquierda) o solo aquellas que tienen relaciones especificadas con las entidades de unión (unión interna).

  • Activada: todas las entidades de destino se mantendrán en la salida.
  • Desactivada: solo se mantendrán en la clase de entidad de salida aquellas entidades de destino que tengan las relaciones especificadas. Los puntos que no se encuentren dentro del polígono se excluirán del resultado. Esta es la opción predeterminada.

Boolean
Incluir distancia
(Opcional)

Especifica si se incluirá en el resultado la distancia espacial o la diferencia temporal.

Este parámetro está activo cuando el valor del parámetro Operación Unir es Unir uno a muchos y cualquiera de las siguientes opciones es cierta:

  • El valor del parámetro Relación espacial es Cercanía planar o Cercanía geodésica.
  • El valor del parámetro Relación temporal es Cerca de, Cerca de antes o Cerca de después.
.
  • Activado: la distancia espacial o la diferencia temporal se incluirá en el resultado.
  • Desactivado: no se incluirá en el resultado la distancia espacial ni la diferencia temporal. Esta es la opción predeterminada.

Boolean
Unidad de distancia
(Opcional)

Especifica la unidad de medida que se utilizará para los valores de distancia en la clase de entidad de salida.

  • MetrosLa unidad de medida será el metro. Esta es la opción predeterminada.
  • KilómetrosLa unidad de medida será el kilómetro.
  • Millas de agrimensura de EE. UU.La unidad de medida será la milla topográfica estadounidense.
  • Millas náuticas topográficas de EE. UU.La unidad de medida será la milla náutica topográfica estadounidense.
  • Yardas de agrimensura de EE. UU.La unidad de medida será la yarda topográfica estadounidense.
  • Pies de agrimensura de EE. UU.La unidad de medida será el pie topográfico estadounidense.
  • Millas terrestresLa unidad de medida será la milla terrestre.
  • Millas náuticas internacionalesLa unidad de medida será la milla náutica internacional.
  • Yardas internacionalesLa unidad de medida será la yarda internacional.
  • Pies internacionalesLa unidad de medida será el pie internacional.
String

Salida derivada

EtiquetaExplicaciónTipo de datos
Output_Feature_Class

La salida unida.

Record Set

arcpy.geoanalytics.JoinFeatures(target_layer, join_layer, output_name, join_operation, {spatial_relationship}, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {attribute_relationship}, {summary_fields}, {join_condition}, {data_store}, {keep_all_target_features}, {include_distance}, {distance_unit})
NombreExplicaciónTipo de datos
target_layer

Contiene las entidades de destino. Los atributos de las entidades de destino y los atributos de las entidades unidas se transferirán a la salida.

Record Set
join_layer

Contiene las entidades de unión. 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 Unir para obtener detalles acerca de cómo la agregación de atributos unidos se ve afectada por el tipo de operación de unión.

Record Set
output_name

El nombre del servicio de entidades de salida.

String
join_operation

Especifica cómo se tratarán en la entidad de salida las uniones entre los valores de target_layer y los valores de join_layer si varias entidades de unión tienen la misma relación espacial con una única entidad de destino.

  • JOIN_ONE_TO_ONESe agregarán los atributos de las distintas entidades de unión. Por ejemplo, si una entidad de destino de punto se encuentra 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 suma de resumen de estadísticas para ese campo, el valor consolidado en la clase de entidad de salida será 10. Esta es la configuración predeterminada y únicamente se devuelve la estadística de recuento.
  • JOIN_ONE_TO_MANYLa clase de entidad de salida contendrá varias copias (registros) de la entidad de destino. Por ejemplo, si una única entidad de destino de un punto se encuentra 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. No hay estadísticas de resumen disponibles con esta opción.
String
spatial_relationship
(Opcional)

Especifica los criterios que se utilizarán para unir entidades espacialmente.

  • INTERSECTSLas entidades de las entidades de unión se harán coincidir si se intersecan con una entidad objetivo. Esta es la opción predeterminada.
  • EQUALSLas entidades de las entidades de unión se harán coincidir si tienen la misma geometría que una entidad de destino.
  • NEARLas entidades en las entidades de unión se harán coincidir si están dentro de una distancia especificada de una entidad objetivo. La distancia se mide con la distancia planar. Especifique una distancia en el parámetro spatial_near_distance.
  • NEAR_GEODESICLas entidades de las entidades de unión se harán coincidir si están dentro de una distancia especificada de una entidad de destino. La distancia se mide a nivel geodésico. Especifique una distancia en el parámetro spatial_near_distance. Esta opción está disponible con ArcGIS Enterprise 10.7 o posterior.
  • 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. Las entidades de unión solo pueden ser polígonos cuando las entidades de destino también son polígonos. Un polígono puede contener cualquier tipo de entidad. Una polilínea puede contener únicamente polilíneas y puntos. Un punto no puede contener ninguna entidad, ni siquiera un punto. Si la entidad de unión reside completamente en el límite de la entidad de destino (ninguna parte está dentro o fuera), la entidad no tendrá coincidencia.
  • WITHINTas entidades en las entidades de unión se harán coincidir si una entidad de destino está dentro de ellas. Esto es lo opuesto a la relación Contiene. Las entidades de destino solo pueden ser polígonos cuando las entidades de unión también son polígonos. Un punto puede ser una entidad de unión solo si el punto es también una entidad de destino. 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.
  • 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.
  • CROSSESLas 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, pero no las que comparten un segmento de línea.
  • OVERLAPSLas entidades de las entidades de unión se harán coincidir si se superponen con una entidad de destino.
String
spatial_near_distance
(Opcional)

La distancia respecto de una entidad de destino dentro de la cual las entidades de unión se tendrán en cuenta para la unión espacial. Un radio de búsqueda solo es válido cuando el valor del parámetro spatial_relationship es NEAR o NEAR_GEODESIC.

Linear Unit
temporal_relationship
(Opcional)

Especifica los criterios de tiempo que se utilizarán para la coincidencia de las entidades.

  • MEETSCuando el final de un intervalo de tiempo de destino es igual que el inicio del intervalo de tiempo de unión, el tiempo de destino alcanza al tiempo de unión.
  • MET_BYCuando el inicio de un intervalo de tiempo de destino es igual que el final del intervalo de tiempo de unión, el tiempo de destino es alcanzado por el tiempo de unión.
  • OVERLAPSCuando el intervalo de tiempo de destino empieza y termina antes del inicio y el final del intervalo de tiempo de unión, el tiempo de destino se superpone sobre el tiempo de unión.
  • OVERLAPPED_BYCuando el intervalo de tiempo de destino empieza y termina después del inicio y el final del intervalo de tiempo de unión, el tiempo de unión se superpone sobre el tiempo de destino.
  • DURINGCuando el tiempo de destino está entre el inicio y el final del intervalo de tiempo de unión, el tiempo de destino se da durante el tiempo de unión.
  • CONTAINSCuando el tiempo de la entidad de unión está entre el inicio y el final del intervalo de tiempo de destino, el tiempo de destino contiene el tiempo de unión.
  • EQUALSDos tiempos se consideran iguales si sus instantes o intervalos son idénticos.
  • FINISHESCuando un tiempo de destino termina al mismo tiempo que un tiempo de unión, y el tiempo de destino se inició después del tiempo de unión, el tiempo de destino finaliza el tiempo de unión.
  • FINISHED_BYCuando el tiempo de una entidad de unión termina al mismo tiempo que un tiempo de destino, y el tiempo de unión se inició después del tiempo de destino, el tiempo de unión finaliza el tiempo de destino.
  • STARTSCuando un tiempo de destino comienza al mismo tiempo que el intervalo de tiempo de unión y termina antes del fin del intervalo de tiempo de unión, el tiempo de destino inicia el tiempo de unión.
  • STARTED_BYCuando el tiempo de un intervalo de destino comienza al mismo tiempo que el tiempo de unión y termina después del tiempo de unión, el tiempo de unión inicia el tiempo de destino.
  • INTERSECTSCuando cualquier parte de un tiempo de destino se produce al mismo tiempo que el tiempo de unión, el tiempo de destino se interseca con el tiempo de unión.
  • NEARCuando un tiempo de destino está dentro de un rango de tiempo especificado con respecto al tiempo de unión, el tiempo de destino estará cerca del tiempo de unión.
  • NEAR_BEFORECuando un tiempo de destino es anterior al tiempo de unión, pero está dentro de un rango de tiempo especificado con respecto al tiempo de unión, el tiempo de destino estará cerca de antes del tiempo de unión. Esta opción está disponible con ArcGIS Enterprise 10.6 o posterior.
  • NEAR_AFTERCuando un tiempo de destino es posterior al tiempo de unión, pero está dentro de un rango de tiempo especificado con respecto al tiempo de unión, el tiempo de destino estará cerca de después del tiempo de unión. Esta opción está disponible con ArcGIS Enterprise 10.6 o posterior.
String
temporal_near_distance
(Opcional)

La distancia en el tiempo respecto de una entidad de destino dentro de la cual las entidades de unión se tendrán en cuenta para la unión espacial. Un tiempo solo es válido cuando el valor del parámetro temporal_relationship es NEAR, NEAR_BEFORE o NEAR_AFTER y las dos entidades tienen el tiempo habilitado.

Time Unit
attribute_relationship
[attribute_relationship,...]
(Opcional)

Une las entidades en función de los valores de un campo de atributos. Especifique el campo de atributo de la capa de destino que coincide con un campo de atributo de la capa de unión.

  • Campo de destino: un campo de atributo de la capa de destino que contiene los valores que se deben hacer coincidir.
  • Campo de unión: un campo de atributo de la capa de unión que contiene los valores que se deben hacer coincidir.

Value Table
summary_fields
[summary_fields,...]
(Opcional)

Las estadísticas que se calcularán en campos concretos.

  • COUNT: el número de valores no nulos. Se puede usar en campos numéricos o de cadenas de caracteres. El recuento de [null, 0, 2] es 2.
  • SUM: la suma de valores numéricos en un campo. La suma de [null, null, 3] es 3.
  • MEAN: el valor medio de los valores numéricos. El valor medio de [0,2, null] es 1.
  • MIN: el valor mínimo de un campo numérico. El mínimo de [0, 2, null] es 0.
  • MAX: el valor máximo de un campo numérico. El valor máximo de [0, 2, null] es 2.
  • STDDEV: la desviación estándar de un campo numérico. La desviación estándar de [1] es null. La desviación estándar de [null, 1,1,1] es null.
  • VAR: la varianza de un campo numérico en un recorrido. La varianza de [1] es null. La varianza de [null, 1,1,1] es null.
  • RANGE: el rango de un campo numérico. Se calcula como el valor mínimos restado del valor máximo. El rango de [0, null, 1] es 1. El rango de [null, 4] es 0.
  • ANY: una cadena de caracteres de un campo de tipo cadena de caracteres.

Value Table
join_condition
(Opcional)

Aplica una condición a los campos especificados. Solo se unirán las entidades con campos que cumplan estas condiciones.

Por ejemplo, puede aplicar una condición de unión a las entidades en las que el atributo HealthSpending de la capa de unión sea superior al 20 por ciento del atributo Income de la capa de destino. En ArcGIS Enterprise 10.5 y 10.5.1, la condición de unión para aplicar esta expresión es join["HealthSpending"] > target["Income"] * .2. En ArcGIS Enterprise 10.6 o posterior, utilice una expresión Arcade, como, por ejemplo, $join["HealthSpending"] > $target["Income"] * .2.

String
data_store
(Opcional)

Especifica el ArcGIS Data Store en el que se guardará la salida. El valor predeterminado es SPATIOTEMPORAL_DATA_STORE. Todos los resultados almacenados en un big data store espaciotemporal se almacenarán en WGS84. Los resultados almacenados en un data store relacional mantendrán su sistema de coordenadas.

  • SPATIOTEMPORAL_DATA_STORELa salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada.
  • RELATIONAL_DATA_STORELa salida se almacenará en un data store relacional.
String
keep_all_target_features
(Opcional)

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

  • KEEP_ALLTodas las entidades de destino se mantendrán en la salida.
  • KEEP_COMMONSolo se mantendrán en la clase de entidad de salida aquellas entidades de destino que tengan las relaciones especificadas. Esta es la opción predeterminada.
Boolean
include_distance
(Opcional)

Especifica si se incluirá en el resultado la distancia espacial o la diferencia temporal.

Este parámetro está activo cuando el valor del parámetro join_operation es JOIN_ONE_TO_MANY y cualquiera de las siguientes opciones es cierta:

  • El valor del parámetro spatial_relationship es NEAR o NEAR_GEODESIC.
  • El valor del parámetro temporal_relationship es NEAR, NEAR_BEFORE o NEAR_AFTER.

  • INCLUDE_DISTANCELa distancia espacial o la diferencia temporal se incluirá en el resultado.
  • NO_INCLUDE_DISTANCENi la distancia espacial ni la diferencia temporal se incluirán en el resultado. Esta es la opción predeterminada.
Boolean
distance_unit
(Opcional)

Especifica la unidad de medida que se utilizará para los valores de distancia en la clase de entidad de salida.

  • METERSLa unidad de medida será el metro. Esta es la opción predeterminada.
  • KILOMETERSLa unidad de medida será el kilómetro.
  • MILESLa unidad de medida será la milla topográfica estadounidense.
  • NAUTICAL_MILESLa unidad de medida será la milla náutica topográfica estadounidense.
  • YARDSLa unidad de medida será la yarda topográfica estadounidense.
  • FEETLa unidad de medida será el pie topográfico estadounidense.
  • MILES_INTLa unidad de medida será la milla terrestre.
  • NAUTICAL_MILES_INTLa unidad de medida será la milla náutica internacional.
  • YARDS_INTLa unidad de medida será la yarda internacional.
  • FEET_INTLa unidad de medida será el pie internacional.
String

Salida derivada

NombreExplicaciónTipo de datos
output

La salida unida.

Record Set

Muestra de código

Ejemplo de Unir entidades (script independiente)

El siguiente script independiente muestra cómo utilizar la función JoinFeatures.

# Name: JoinFeatures.py
# Description: Join crime events that are close together in time and space, and 
#              return the count of nearby crimes. This example is a self join 
#              (joining the same layer to itself).
# Requirements: ArcGIS GeoAnalytics Server 

# Import system modules 
import arcpy 

# Set local variables 
inFeatures = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Crimes/BigDataCatalogServer/Chicago"
spatialOperation = "NEAR" 
nearDistance = "1 Kilometers" 
temporalOperation = "NEAR" 
nearTime = "3 Hours" 
outFS = "CloseCrimes" 
dataStore = "SPATIOTEMPORAL_DATA_STORE" 

# Run Join Features
arcpy.geoanalytics.JoinFeatures(inFeatures, inFeatures, outFS, "JOIN_ONE_TO_ONE", 
                                spatialOperation, nearDistance, temporalOperation, 
                                nearTime, None, None, None, dataStore)

Entornos

Casos especiales

Sistema de coordenadas de salida

El sistema de coordenadas que se usará para el análisis. El análisis se completará en el sistema de coordenadas de entrada salvo que este parámetro especifique otra opción. En GeoAnalytics Tools, los resultados finales se almacenarán en el data store espaciotemporal en WGS84.

Información de licenciamiento

  • Basic: Requiere ArcGIS GeoAnalytics Server
  • Standard: Requiere ArcGIS GeoAnalytics Server
  • Advanced: Requiere ArcGIS GeoAnalytics Server

Temas relacionados