Join Features (Joindre les entités) (Outils GeoAnalytics Desktop)

Résumé

Joint les attributs d’une couche à une autre en fonction de relations spatiales, temporelles ou attributaires ou d’une combinaison de ces relations.

Illustration

Utilisation

Une jointure spatiale permet d’apparier des entités (lignes) à partir des entités en entrée (les valeurs des paramètres Target Layer [Couche cible] et Join Layer [Couche de jointure]) en fonction de leurs localisations spatiales. Une jointure temporelle permet d’apparier des entités (lignes) à partir des entités en entrée en fonction de leurs relations temporelles. Une jointure attributaire permet d’apparier des entités en fonction des valeurs de champs.

Vous pouvez joindre des entités selon une relation spatiale, temporelle ou attributaire, ou une combinaison des trois.


Option	Description
Spatial Relationship (Relation spatiale)	Relation spatiale qui détermine si les entités sont jointes les unes aux autres. Les relations disponibles dépendent du type de géométrie (point, ligne ou surface) des couches jointes. Les relations spatiales disponibles sont les suivantes : Intersects (Intersecte) Equals (Est égal à) Planar Near (Planaire proche) : utilise les distances planaires Geodesic Near (Géodésique proche) : utilise les distances géodésiques Contains (Contient) Within (Dans) Touches (Touche) Crosses (Croise) Overlaps (Superpose) En savoir plus sur les relations spatiales dans les outils GeoAnalytics Desktop
Temporal Relationship (Relation temporelle)	Relation temporelle qui détermine si les entités sont jointes les unes aux autres. Les relations disponibles dépendent du type de temps (instant ou intervalle) des couches jointes. Les relations spatiales disponibles sont les suivantes : Meets (Rejoint) Met by (Rejoint par) Overlaps (Superpose) Overlapped by (Superposé par) During (Pendant) Contains (Contient) Equals (Est égal à) Finishes (Termine) Finished by (Terminé par) Starts (Démarre) Started by (Démarré par) Intersects (Intersecte) Near (Proche) Near Before (Proche avant) Near After (Proche après) En savoir plus sur les relations spatiales dans les outils GeoAnalytics Desktop
Attribute Relationship (Relation attributaire)	Relation temporelle qui détermine si les entités sont jointes les unes aux autres. Les entités sont appariées lorsque les valeurs de champ de la couche de jointure sont identiques à celles de la couche cible.

Si les entités cible et de jointure sont dans des systèmes de coordonnées différents, les systèmes de coordonnées de l’entité cible sont utilisés. Si un système de coordonnées en sortie est spécifié, les deux entités y sont projetées, puis sont jointes.
Si la valeur de paramètre Spatial Relationship (Relation spatiale) est Planar Near (Planaire proche), la valeur de paramètre Target Layer (Couche cible) doit être projetée ou le système de coordonnées en sortie doit être défini sur un système de coordonnées projetées.
Si plusieurs entités correspondent à la même entité cible, vous pouvez choisir de joindre toutes les entités correspondantes (en définissant le paramètre Join Operation [Opération de jointure] sur Join one to many [Joindre un vers plusieurs]) ou de synthétiser toutes les entités correspondantes ensemble (en définissant le paramètre Join Operation [Opération de jointure] sur Join one to one [Joindre un vers un]) comme suit :
- Join one to many (Joindre un vers plusieurs) : joint toutes les entités correspondantes de la couche de jointure à la couche cible. La couche de résultat contiendra plusieurs enregistrements de l’entité cible. Tous les attributs originaux de l’entité de jointure sont ajoutés aux attributs de l’entité cible, dans l’entité de résultat.
- Join one to one (Joindre un à un) : synthétise toutes les entités de jointure appariées à chaque entité de la couche cible. Seules les entités appariées seront incluses dans la synthèse et la sortie. Le nombre d’entités jointes est ajouté, en plus d’autres statistiques facultatives, telles que la somme, le minimum, le maximum, la plage, la moyenne, la variance et l’écart type. Seuls les attributs de résumé statistique (et leur nombre) de l’entité de jointure demandés sont ajoutés aux attributs de l’entité cible, dans l’entité de résultat. Par défaut, seules les entités cibles ayant les relations spécifiées sont conservées dans la classe d’entités en sortie (on parle de jointure interne). Si l’option Keep All Target Features (Conserver toutes les entités cibles) est activée, toutes les entités cible en entrée sont écrites dans la classe d’entités en sortie (on parle de jointure externe gauche). Seuls les attributs de résumé statistique de l’entité de jointure demandés sont ajoutés aux attributs de l’entité cible, dans l’entité de résultat.
Des exemples de jointure un vers plusieurs et de jointure un vers un sont illustrés. Dans cet exemple, la jointure un vers un ne comprend que le total. Les statistiques supplémentaires pouvant être calculées sont indiquées ci-dessous.
Vous pouvez créer une expression pour joindre des entités à l’aide du paramètre Join Condition (Condition de jointure). Si vous spécifiez une expression, seules les entités qui remplissent la condition sont utilisées. Par exemple, à l’aide de l’expression $target["Magnitude"] > $join["Explosion"], vous ne pouvez joindre des entités cibles à partir du champ Magnitude que si la valeur est supérieure à l’entité jointe avec un champ nommé Explosion. Reportez-vous à la rubrique Expressions Arcade dans les outils GeoAnalytics Desktop pour plus d’informations.

Les champs suivants sont inclus dans les entités en sortie lors de l’exécution d’une jointure un vers plusieurs :

All fields from the target layers (Tous les champs des couches cible)
All fields from the joined layer (Tous les champs de la couche jointe)

Si un champ porte le même nom dans les deux jeux de données cible et de jointure, le champ joint commence par le terme join (par exemple, join_fieldname).


Nom du champ	Description
`start_date`	Ce champ représente l’heure de début et est créé si l’entrée comporte une heure définie comme un instant ou un intervalle.
`end_date`	Ce champ représente l’heure de fin et est créé si l’entrée comporte une heure définie comme un intervalle.

En plus de tous les champs de la couche cible, les champs suivants sont inclus dans les entités en sortie lors de l’exécution d’une jointure un vers un :


Nom du champ	Description
`count`	Nombre d’entités qui ont été jointes.
`statistic_fieldname`	Les statistiques spécifiées créent chacune un champ attributaire, dont le nom se présente au format suivant : statistic_fieldname. Par exemple, l’écart maximal et l’écart type du champ `id` sont respectivement `MAX_id` et `SD_id`.
`start_date`	Ce champ représente l’heure de début et est créé si l’entrée comporte une heure définie comme un instant ou un intervalle.
`end_date`	Ce champ représente l’heure de fin et est créé si l’entrée comporte une heure définie comme un intervalle.

Si le paramètre Include Distance (Inclure la distance) est activé et que le paramètre Join Operation (Opération de jointure) est défini sur Join one to many (Joindre un vers plusieurs), les champs suivants peuvent être inclus dans les entités en sortie :


Nom du champ	Description
`distance`	Distance entre les entités cible et de jointure. Ce champ est inclus si le paramètre Spatial Relationship (Relation spatiale) est Planar Near (Planaire à proximité) ou Geodesic Near (Géodésique à proximité). Une distance de 0 indique que les géométries cibles et de jointure se coupent. Une valeur nulle indique que les géométries sont éloignées de la valeur du paramètre Spatial Near Distance (Distance de proximité spatiale). Si la valeur du paramètre Spatial Relationship (Relation spatiale) est Planar Near (Planaire proche), les valeurs de distance sont planaires. Si la valeur du paramètre est Geodesic Near (Géodésique proche), les valeurs de distance sont géodésiques. Les valeurs sont exprimées dans les unités spécifiées dans le paramètre Distance Unit (Unité de distance). L’unité de distance par défaut est le mètre.
`timegap`	La différence temporelle entre les entités cible et de jointure est exprimée en millisecondes. Ce champ est inclus si le paramètre Temporal Relationship (Relation temporelle) a pour valeur Near (Proche), Near Before (Proche avant) ou Near After (Proche après). Une différence de 0 indique que les entités cibles et de jointure se coupent d’un point de vue temporel. Des valeurs positives indiquent que l’entité cible se produit avant l’entité de jointure, une valeur négative indiquant que l’entité de jointure se produit avant l’entité cible. Des valeurs nulles indiquent que les entités ne satisfont pas à la condition de jointure. Par exemple, les entités sont éloignées de la valeur du paramètre Temporal Near Distance (Distance de proximité temporelle).

Vous pouvez améliorer les performances de l’outil Join Features (Joindre les entités) de l’une des manières suivantes :
- Définissez l’environnement d’étendue de manière à n’analyser que les données présentant un intérêt.
- Faites en sorte que les conditions de jointure soient aussi sélectives que possible. Par exemple, une jointure proche de 1 kilomètre donne de meilleurs résultats qu’une jointure proche de 5 kilomètres avec les mêmes données.
- Ajoutez plusieurs conditions de jointure. Des conditions de jointure supplémentaires rendent la jointure plus sélective. Par exemple, une jointure proche de 1 kilomètre et de 1 heure fonctionne mieux qu’une jointure proche de 1 kilomètre pour les mêmes données.
- Appliquez une expression de jonction.
- Utilisez les données locales de l’environnement d’exécution de l’analyse.
Une analyse similaire peut également être réalisée à l’aide de l’outil Spatial Join (Jointure spatiale) de la boîte à outils Analysis (Analyse).
Cet outil de géotraitement est optimisé par Spark. L'analyse est effectuée sur votre ordinateur de bureau à l'aide de plusieurs cœurs en parallèle. Pour en savoir plus sur l’exécution d’une analyse, reportez-vous à la rubrique Remarques sur les outils de GeoAnalytics Desktop.
Lors de l’exécution d’outils de GeoAnalytics Desktop, l’analyse est effectuée sur votre ordinateur de bureau. Pour des performances optimales, les données doivent être disponibles sur votre bureau : Si vous utilisez une couche d’entités hébergée, il est recommandé d’utiliser ArcGIS GeoAnalytics Server. Si vos données ne sont pas locales, l'exécution d'un outil est plus longue. Pour utiliser votre serveur ArcGIS GeoAnalytics Server en vue d’une analyse, reportez-vous à la rubrique Outils GeoAnalytics.

Etiqueter	Explication	Type de données
Couche cible	Contient les entités cibles. Les attributs provenant des entités cibles et les attributs provenant des entités de jointure sont transférés vers la sortie.	Table View
Couche de jointure	Contient les entités de jointure. Les attributs des entités jointes sont joints aux attributs des entités cible. Reportez-vous à l’explication du paramètre Join Operation (Opération de jointure) pour des détails sur la manière dont le type d’opération de jointure affecte l’agrégation des attributs joints.	Table View
Jeu de données en sortie	Nouvelle classe d’entités contenant les entités de couche cible avec des entités jointes.	Feature Class; Table
Opération de jointure	Spécifie le mode de traitement des jointures entre les valeurs Target Layer (Couche cible) et les valeurs Join Layer (Couche de jointure) dans la sortie si plusieurs entités de jointure présentent la même relation spatiale avec une entité cible unique. Joindre un vers un—Les attributs provenant de plusieurs entités de jointure sont agrégés. Par exemple, si une entité cible ponctuelle se trouve dans deux entités de jointure surfaciques distinctes, les attributs des deux polygones sont agrégés avant d’être transférés vers la classe d’entités ponctuelle en sortie. Si les polygones ont respectivement les valeurs attributaires 3 et 7, et que la somme des résumés statistiques est spécifiée pour ce champ, la valeur agrégée dans la classe d'entité en sortie est 10. Il s’agit du comportement par défaut et seule la statistique de comptage est renvoyée. Joindre un vers plusieurs—La classe d’entités en sortie contient plusieurs exemplaires (enregistrements) de l’entité cible. Par exemple, si une même entité cible ponctuelle figure dans deux entités de jointure surfaciques distinctes, la classe d’entités en sortie contient deux exemplaires de l’entité cible : un enregistrement avec les attributs du premier polygone et un enregistrement avec les attributs du deuxième polygone. Aucun résumé statistique n’est disponible avec cette option.	String
Relation spatiale (Facultatif)	Définit les critères utilisés pour joindre spatialement les entités. Intersecte—Les entités dans les entités de jointure sont appariées si elles intersectent une entité cible. Il s’agit de l’option par défaut. Est égal à—Les entités dans les entités de jointure sont appariées si elles possèdent la même géométrie qu'une entité cible. Planaire proche—Les entités dans les entités jointes sont appariées si elles se trouvent à une distance spécifiée d'une entité cible. La distance est mesurée à l’aide de la distance planaire. Spécifiez une distance dans le paramètre Spatial Near Distance (Distance de proximité spatiale). Géodésique proche—Les entités dans les entités jointes sont appariées si elles se trouvent à une distance spécifiée d'une entité cible. La distance est mesurée de manière géodésique. Spécifiez une distance dans le paramètre Spatial Near Distance (Distance de proximité spatiale). Contient—Les entités des entités jointes sont appariées si une entité cible les englobe. Les entités cible doivent être des polygones ou des polylignes. Les entités de jointure ne peuvent être que des polygones lorsque les entités cible le sont également. Un polygone peut contenir tout type d’entité. Une polyligne peut contenir uniquement des polylignes et des points. Un point ne peut pas contenir d’entité, pas même un point. Si l'entité de jointure se trouve entièrement sur la limite de l'entité cible (aucune partie n'est véritablement à l'intérieur ni à l'extérieur), l'entité n'est pas appariée. Dans—Les entités des entités jointes sont appariées si une entité cible se trouve à l'intérieur d'elles. C’est l’inverse de la relation Contient. Les entités cibles ne peuvent être que des polygones lorsque les entités de jointure le sont également. Un point ne peut être une entité de jointure que s’il est également une entité cible. Si la totalité de l'entité dans les entités de jointure est sur la limite de l'entité cible, l'entité n'est pas appariée. Touche—Les entités dans les entités jointes sont appariées si elles comportent une limite qui touche une entité cible. Lorsque les entités de jointure et les entités cibles sont des lignes ou des polygones, la limite de l’entité de jointure ne peut toucher que la limite de l’entité cible et aucune partie de l’entité de jointure ne peut dépasser la limite de l’entité cible. Croise—Les entités dans les entités jointes sont appariées si une entité cible est intersectée par leur contour. Les entités jointe et cible doivent être des lignes ou des polygones. Si des polygones sont utilisés pour les entités jointe et cible, la limite (ligne) du polygone est utilisée. Les lignes qui se croisent au niveau d’un point sont appariées, à l’inverse de celles qui partagent un segment de ligne. Superpose—Les entités figurant dans les entités de jointure sont appariées si elles recouvrent une entité cible.	String
Distance de proximité spatiale (Facultatif)	Distance à partir d’une entité cible dans laquelle les entités de jointure sont prises en compte pour la jointure spatiale. Le rayon de recherche est valide uniquement si la valeur du paramètre Spatial Relationship (Relation spatiale) est Planar Near (Planaire proche) ou Geodesic Near (Géodésique proche).	Linear Unit
Relation temporelle (Facultatif)	Définit les critères temporels utilisés pour l’appariement des entités. Rejoint—Lorsque la fin d'un intervalle temporel cible est égale au début de l'intervalle temporel de jointure, les données temporelles cible rejoignent les données temporelles de jointure. Rejoint par—Lorsque le début d'un intervalle temporel cible est égal à la fin de l'intervalle temporel de jointure, les données temporelles cible sont rejointes par les données temporelles de jointure. Superpose—Lorsqu'un intervalle temporel cible commence et se termine avant le début et la fin de l'intervalle temporel de jointure, les données temporelles cible recouvrent les données temporelles de jointure. Superposé par—Lorsqu'un intervalle temporel cible commence et se termine après l'heure de début et l'heure de fin de l'intervalle temporel de jointure, les données temporelles cible sont recouvertes par les données temporelles de jointure. Pendant—Lorsque des données temporelles cible interviennent entre le début et la fin de l'intervalle temporel de jointure, les données temporelles cible se situent pendant les données temporelles de jointure. Contient—Lorsque les données temporelles d'une entité de jointure interviennent entre le début et la fin de l'intervalle temporel cible, les données temporelles cible contiennent les données temporelles de jointure. Est égal à—Des données temporelles sont considérées égales si leurs instants ou intervalles sont identiques. Termine—Lorsque des données temporelles cible se terminent au même moment que des données temporelles de jointure, et que les données temporelles cible ont commencé après celles de jointure, les données temporelles cible terminent les données temporelles de jointure. Terminé par—Lorsque les données temporelles d'une entité de jointure se terminent au même moment que les données temporelles cible, et que les données temporelles de jointure ont commencé après les données temporelles cible, les données temporelles cible sont terminées par les données temporelles de jointure. Démarre—Lorsque des données temporelles cibles commencent au même moment que l’intervalle temporel de jointure et se terminent avant la fin de l’intervalle temporel de jointure, les données temporelles cibles démarrent les données temporelles de jointure. Démarré par—Lorsqu'un intervalle temporel cible commence au même moment que les données temporelles de jointure, et se terminent après les données temporelles de jointure, les données temporelles cible sont démarrées par les données temporelles de jointure. Intersecte—Lorsqu'une partie quelconque de données temporelles cible intervient au même moment que les données temporelles de jointure, les données temporelles cible intersectent les données temporelles de jointure. Proche—Lorsque des données temporelles cible sont comprises dans une plage de temps spécifiée à partir des données temporelles de jointure, les données temporelles cible sont proches des données temporelles de jointure. Near before (À proximité avant)—Lorsque des données temporelles cibles sont avant les données temporelles de jointure, mais comprises dans une plage de temps spécifiée à partir des données temporelles de jointure, les données temporelles cibles sont proches avant les données temporelles de jointure. Near after (À proximité après)—Lorsque des données temporelles cibles sont après les données temporelles de jointure, mais comprises dans une plage de temps spécifiée à partir des données temporelles de jointure, les données temporelles cibles sont proches après les données temporelles de jointure.	String
Distance de proximité temporelle (Facultatif)	Distance dans les données temporelles à partir d’une entité cible dans laquelle les entités de jointure sont prises en compte pour la jointure spatiale. Les données temporelles sont valides uniquement si la valeur du paramètre Temporal Relationship (Relation temporelle) est Near (Proche), Near Before (Proche avant) ou Near After (Proche après) et que les données temporelles sont activées pour les deux entités.	Time Unit
Relation attributaire (Facultatif)	Joint des entités en fonction des valeurs d'un champ attributaire. Spécifiez le champ attributaire de la couche cible qui correspond à un champ attributaire de la couche de jointure. Colonnes de la table de valeurs : Champ cible—Un champ attributaire émanant de la couche cible et contenant les valeurs à apparier. Joindre un champ—Un champ attributaire émanant de la couche de jointure et contenant les valeurs à apparier.	Value Table
Champs de récapitulation (Facultatif)	Statistiques qui seront calculées sur les champs spécifiés. Colonnes de la table de valeurs : Le champ—Champs dans lesquels les statistiques vont être calculées. Statistique—Statistiques qui seront calculées sur les champs spécifiés. Effectif—Nombre de valeurs non nulles. Peut être utilisé sur des champs numériques ou des chaînes. Le total de [Null, 0, 2] est égal à 2. Somme—Somme des valeurs numériques dans un champ. La somme de [Null, 0, 3] est égale à 3. Moyenne—Moyenne des valeurs numériques. La moyenne de [0,2, Null] est égale à 1. Minimum—Valeur minimale d’un champ numérique. La valeur minimale de [0, 2, Null] est égale à 0. Maximum—Valeur maximale d’un champ numérique. La valeur maximale de [0, 2, Null] est égale à 2. Écart type—Écart type d’un champ numérique. L'écart type de [1] est la valeur Null. L’écart type de [null, 1,1,1] est nul. Variance—Variance d’un champ numérique dans une piste. La variance de [1] est la valeur nulle. La variance de [null, 1,1,1] est nulle. Plage—Plage d’un champ numérique. Elle est calculée comme la valeur minimale soustraite de la valeur maximale. La plage de [0, Null, 1] est égale à 1. La plage de [Null, 4] est égale à 0. Tout—Exemple de chaîne provenant d’un champ de type chaîne.	Value Table
Condition de jointure (Facultatif)	Applique une condition à des champs spécifiés. Seules les entités présentant des champs qui remplissent ces conditions sont jointes. Par exemple, vous pouvez appliquer une condition de jointure à des entités dans lesquelles l’attribut HealthSpending de la couche de jointure est supérieur à 20 % de l’attribut Income de la couche cible. Utilisez une expression Arcade telle que `$join["HealthSpending"] > $target["Income"] * .2`.	String
Conserver toutes les entités cible (Facultatif)	Indique si toutes les entités cibles sont conservées dans la classe d’entités en sortie (jointure externe gauche) ou uniquement celles qui présentent la relation spécifiée avec les entités jointes (jointure interne). Activé—Toutes les entités cibles sont conservées dans la sortie. Décoché—Seules les entités cibles ayant les relations spécifiées sont conservées dans la classe d’entités en sortie. Les entités ponctuelles qui ne se trouvent pas dans les entités surfaciques sont exclues de la sortie. Il s’agit de l’option par défaut.	Boolean
Inclure la distance (Facultatif)	Spécifie si la distance spatiale ou la différence temporelle est incluse dans le résultat. Ce paramètre est actif si la valeur du paramètre Join Operation (Opération de jointure) est Join one to many (Joindre un vers plusieurs) et que la valeur du paramètre Spatial Relationship (Relation spatiale) est Planar Near (Planaire proche) ou Geodesic Near (Géodésique proche) ou que la valeur du paramètre Temporal Relationship (Relation temporelle) est Near (Proche), Near Before (Proche avant) ou Near After (Proche après). Activé—La distance spatiale ou la différence temporelle est incluse dans le résultat. Décoché—La distance spatiale et la différence temporelle ne sont pas incluses dans le résultat. Il s’agit de l’option par défaut.	Boolean
Unité de distance (Facultatif)	Spécifie l’unité de mesure qui sera utilisée pour les valeurs de distance dans la classe d’entités en sortie. Mètres—L’unité de mesure est le mètre. Il s’agit de l’option par défaut. Kilomètres—L’unité de mesure est le kilomètre. Milles d’arpentage américains—L’unité de mesure est le mile d’arpentage américain. Milles nautiques d’arpentage américains—L’unité de mesure est le mille nautique d’arpentage américain. Yards d’arpentage américains—L’unité de mesure est le yard d'arpentage américain Pieds d’arpentage américains—L’unité de mesure est le pied d’arpentage américain Milles terrestres—L’unité de mesure est le mille terrestre. Milles nautiques internationaux—L’unité de mesure est le mille nautique international. Yards internationaux—L’unité de mesure est le yard international. Pied international—L’unité de mesure est le pied international.	String

arcpy.gapro.JoinFeatures(target_layer, join_layer, output, join_operation, {spatial_relationship}, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {attribute_relationship}, {summary_fields}, {join_condition}, {keep_all_target_features}, {include_distance}, {distance_unit})

Nom	Explication	Type de données
target_layer	Contient les entités cibles. Les attributs provenant des entités cibles et les attributs provenant des entités de jointure sont transférés vers la sortie.	Table View
join_layer	Contient les entités de jointure. Les attributs des entités jointes sont joints aux attributs des entités cible. Reportez-vous à l’explication du paramètre Join Operation (Opération de jointure) pour des détails sur la manière dont le type d’opération de jointure affecte l’agrégation des attributs joints.	Table View
output	Nouvelle classe d’entités contenant les entités de couche cible avec des entités jointes.	Feature Class; Table
join_operation	Spécifie le mode de traitement des jointures entre les valeurs `target_layer` et les valeurs `join_layer` dans la sortie si plusieurs entités de jointure présentent la même relation spatiale avec une entité cible unique. `JOIN_ONE_TO_ONE`—Les attributs provenant de plusieurs entités de jointure sont agrégés. Par exemple, si une entité cible ponctuelle se trouve dans deux entités de jointure surfaciques distinctes, les attributs des deux polygones sont agrégés avant d’être transférés vers la classe d’entités ponctuelle en sortie. Si les polygones ont respectivement les valeurs attributaires 3 et 7, et que la somme des résumés statistiques est spécifiée pour ce champ, la valeur agrégée dans la classe d'entité en sortie est 10. Il s’agit du comportement par défaut et seule la statistique de comptage est renvoyée. `JOIN_ONE_TO_MANY`—La classe d’entités en sortie contient plusieurs exemplaires (enregistrements) de l’entité cible. Par exemple, si une même entité cible ponctuelle figure dans deux entités de jointure surfaciques distinctes, la classe d’entités en sortie contient deux exemplaires de l’entité cible : un enregistrement avec les attributs du premier polygone et un enregistrement avec les attributs du deuxième polygone. Aucun résumé statistique n’est disponible avec cette option.	String
spatial_relationship (Facultatif)	Définit les critères utilisés pour joindre spatialement les entités. `INTERSECTS`—Les entités dans les entités de jointure sont appariées si elles intersectent une entité cible. Il s’agit de l’option par défaut. `EQUALS`—Les entités dans les entités de jointure sont appariées si elles possèdent la même géométrie qu'une entité cible. `NEAR`—Les entités dans les entités jointes sont appariées si elles se trouvent à une distance spécifiée d'une entité cible. La distance est mesurée à l’aide de la distance planaire. Spécifiez une distance dans le paramètre `spatial_near_distance`. `NEAR_GEODESIC`—Les entités dans les entités jointes sont appariées si elles se trouvent à une distance spécifiée d'une entité cible. La distance est mesurée de manière géodésique. Spécifiez une distance dans le paramètre `spatial_near_distance`. `CONTAINS`—Les entités des entités jointes sont appariées si une entité cible les englobe. Les entités cible doivent être des polygones ou des polylignes. Les entités de jointure ne peuvent être que des polygones lorsque les entités cible le sont également. Un polygone peut contenir tout type d’entité. Une polyligne peut contenir uniquement des polylignes et des points. Un point ne peut pas contenir d’entité, pas même un point. Si l'entité de jointure se trouve entièrement sur la limite de l'entité cible (aucune partie n'est véritablement à l'intérieur ni à l'extérieur), l'entité n'est pas appariée. `WITHIN`—Les entités des entités jointes sont appariées si une entité cible se trouve à l'intérieur d'elles. C’est l’inverse de la relation Contient. Les entités cibles ne peuvent être que des polygones lorsque les entités de jointure le sont également. Un point ne peut être une entité de jointure que s’il est également une entité cible. Si la totalité de l'entité dans les entités de jointure est sur la limite de l'entité cible, l'entité n'est pas appariée. `TOUCHES`—Les entités dans les entités jointes sont appariées si elles comportent une limite qui touche une entité cible. Lorsque les entités de jointure et les entités cibles sont des lignes ou des polygones, la limite de l’entité de jointure ne peut toucher que la limite de l’entité cible et aucune partie de l’entité de jointure ne peut dépasser la limite de l’entité cible. `CROSSES`—Les entités dans les entités jointes sont appariées si une entité cible est intersectée par leur contour. Les entités jointe et cible doivent être des lignes ou des polygones. Si des polygones sont utilisés pour les entités jointe et cible, la limite (ligne) du polygone est utilisée. Les lignes qui se croisent au niveau d’un point sont appariées, à l’inverse de celles qui partagent un segment de ligne. `OVERLAPS`—Les entités figurant dans les entités de jointure sont appariées si elles recouvrent une entité cible.	String
spatial_near_distance (Facultatif)	Distance à partir d’une entité cible dans laquelle les entités de jointure sont prises en compte pour la jointure spatiale. Le rayon de recherche est valide uniquement lorsque la valeur du paramètre `spatial_relationship` est `NEAR` ou `NEAR_GEODESIC`.	Linear Unit
temporal_relationship (Facultatif)	Définit les critères temporels utilisés pour l’appariement des entités. `MEETS`—Lorsque la fin d'un intervalle temporel cible est égale au début de l'intervalle temporel de jointure, les données temporelles cible rejoignent les données temporelles de jointure. `MET_BY`—Lorsque le début d'un intervalle temporel cible est égal à la fin de l'intervalle temporel de jointure, les données temporelles cible sont rejointes par les données temporelles de jointure. `OVERLAPS`—Lorsqu'un intervalle temporel cible commence et se termine avant le début et la fin de l'intervalle temporel de jointure, les données temporelles cible recouvrent les données temporelles de jointure. `OVERLAPPED_BY`—Lorsqu'un intervalle temporel cible commence et se termine après l'heure de début et l'heure de fin de l'intervalle temporel de jointure, les données temporelles cible sont recouvertes par les données temporelles de jointure. `DURING`—Lorsque des données temporelles cible interviennent entre le début et la fin de l'intervalle temporel de jointure, les données temporelles cible se situent pendant les données temporelles de jointure. `CONTAINS`—Lorsque les données temporelles d'une entité de jointure interviennent entre le début et la fin de l'intervalle temporel cible, les données temporelles cible contiennent les données temporelles de jointure. `EQUALS`—Des données temporelles sont considérées égales si leurs instants ou intervalles sont identiques. `FINISHES`—Lorsque des données temporelles cible se terminent au même moment que des données temporelles de jointure, et que les données temporelles cible ont commencé après celles de jointure, les données temporelles cible terminent les données temporelles de jointure. `FINISHED_BY`—Lorsque les données temporelles d'une entité de jointure se terminent au même moment que les données temporelles cible, et que les données temporelles de jointure ont commencé après les données temporelles cible, les données temporelles cible sont terminées par les données temporelles de jointure. `STARTS`—Lorsque des données temporelles cibles commencent au même moment que l’intervalle temporel de jointure et se terminent avant la fin de l’intervalle temporel de jointure, les données temporelles cibles démarrent les données temporelles de jointure. `STARTED_BY`—Lorsqu'un intervalle temporel cible commence au même moment que les données temporelles de jointure, et se terminent après les données temporelles de jointure, les données temporelles cible sont démarrées par les données temporelles de jointure. `INTERSECTS`—Lorsqu'une partie quelconque de données temporelles cible intervient au même moment que les données temporelles de jointure, les données temporelles cible intersectent les données temporelles de jointure. `NEAR`—Lorsque des données temporelles cible sont comprises dans une plage de temps spécifiée à partir des données temporelles de jointure, les données temporelles cible sont proches des données temporelles de jointure. `NEAR_BEFORE`—Lorsque des données temporelles cibles sont avant les données temporelles de jointure, mais comprises dans une plage de temps spécifiée à partir des données temporelles de jointure, les données temporelles cibles sont proches avant les données temporelles de jointure. `NEAR_AFTER`—Lorsque des données temporelles cibles sont après les données temporelles de jointure, mais comprises dans une plage de temps spécifiée à partir des données temporelles de jointure, les données temporelles cibles sont proches après les données temporelles de jointure.	String
temporal_near_distance (Facultatif)	Distance dans les données temporelles à partir d’une entité cible dans laquelle les entités de jointure sont prises en compte pour la jointure spatiale. Les données temporelles sont valides uniquement lorsque la valeur du paramètre `temporal_relationship` est `NEAR`, `NEAR_BEFORE` ou `NEAR_AFTER` et que les données temporelles sont activées pour les deux entités.	Time Unit
attribute_relationship [attribute_relationship,...] (Facultatif)	Joint des entités en fonction des valeurs d'un champ attributaire. Spécifiez le champ attributaire de la couche cible qui correspond à un champ attributaire de la couche de jointure. Colonnes de la table de valeurs : `Target Field`—Un champ attributaire émanant de la couche cible et contenant les valeurs à apparier. `Join Field`—Un champ attributaire émanant de la couche de jointure et contenant les valeurs à apparier.	Value Table
summary_fields [[Field, Statistic],...] (Facultatif)	Statistiques qui seront calculées sur les champs spécifiés. Colonnes de la table de valeurs : `Field`—Champs dans lesquels les statistiques vont être calculées. `Statistic`—Statistiques qui seront calculées sur les champs spécifiés. `COUNT`—Nombre de valeurs non nulles. Peut être utilisé sur des champs numériques ou des chaînes. Le total de [Null, 0, 2] est égal à 2. `SUM`—Somme des valeurs numériques dans un champ. La somme de [Null, 0, 3] est égale à 3. `MEAN`—Moyenne des valeurs numériques. La moyenne de [0,2, Null] est égale à 1. `MIN`—Valeur minimale d’un champ numérique. La valeur minimale de [0, 2, Null] est égale à 0. `MAX`—Valeur maximale d’un champ numérique. La valeur maximale de [0, 2, Null] est égale à 2. `STDDEV`—Écart type d’un champ numérique. L'écart type de [1] est la valeur Null. L’écart type de [null, 1,1,1] est nul. `VAR`—Variance d’un champ numérique dans une piste. La variance de [1] est la valeur nulle. La variance de [null, 1,1,1] est nulle. `RANGE`—Plage d’un champ numérique. Elle est calculée comme la valeur minimale soustraite de la valeur maximale. La plage de [0, Null, 1] est égale à 1. La plage de [Null, 4] est égale à 0. `ANY`—Exemple de chaîne provenant d’un champ de type chaîne.	Value Table
join_condition (Facultatif)	Applique une condition à des champs spécifiés. Seules les entités présentant des champs qui remplissent ces conditions sont jointes. Par exemple, vous pouvez appliquer une condition de jointure à des entités dans lesquelles l’attribut HealthSpending de la couche de jointure est supérieur à 20 % de l’attribut Income de la couche cible. Utilisez une expression Arcade telle que `$join["HealthSpending"] > $target["Income"] * .2`.	String
keep_all_target_features (Facultatif)	Indique si toutes les entités cibles sont conservées dans la classe d’entités en sortie (jointure externe gauche) ou uniquement celles qui présentent la relation spécifiée avec les entités jointes (jointure interne). `KEEP_ALL`—Toutes les entités cibles sont conservées dans la sortie. `KEEP_COMMON`—Seules les entités cibles ayant les relations spécifiées sont conservées dans la classe d’entités en sortie. Il s’agit de l’option par défaut.	Boolean
include_distance (Facultatif)	Spécifie si la distance spatiale ou la différence temporelle est incluse dans le résultat. Ce paramètre est actif lorsque la valeur du paramètre `join_operation` est `JOIN_ONE_TO_MANY` et que la valeur du paramètre `spatial_relationship` est `NEAR` ou `NEAR_GEODESIC`, ou que la valeur du paramètre `temporal_relationship` est `NEAR`, `NEAR_BEFORE` ou `NEAR_AFTER`. `INCLUDE_DISTANCE`—La distance spatiale ou la différence temporelle est incluse dans le résultat. `NO_INCLUDE_DISTANCE`—La distance spatiale et la différence temporelle ne sont pas incluses dans le résultat. Il s’agit de l’option par défaut.	Boolean
distance_unit (Facultatif)	Spécifie l’unité de mesure qui sera utilisée pour les valeurs de distance dans la classe d’entités en sortie. `METERS`—L’unité de mesure est le mètre. Il s’agit de l’option par défaut. `KILOMETERS`—L’unité de mesure est le kilomètre. `MILES`—L’unité de mesure est le mile d’arpentage américain. `NAUTICAL_MILES`—L’unité de mesure est le mille nautique d’arpentage américain. `YARDS`—L’unité de mesure est le yard d'arpentage américain `FEET`—L’unité de mesure est le pied d’arpentage américain `MILES_INT`—L’unité de mesure est le mille terrestre. `NAUTICAL_MILES_INT`—L’unité de mesure est le mille nautique international. `YARDS_INT`—L’unité de mesure est le yard international. `FEET_INT`—L’unité de mesure est le pied international.	String

Exemple de code

Exemple d’utilisation de la fonction JoinFeatures (script autonome)

Le script autonome ci-après illustre l’utilisation de la fonction 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).

# Import system modules
import arcpy

arcpy.env.workspace = "C:/data/CityData.gdb"

# Enable time on the input features using an .lyrx file.
# To create the .lyrx file, add your layer to a map, open the layer properties
# and enable time. Then right-click the layer and select Share As Layer File.
inputLyrx = r'C:\data\ChicagoCrimes.lyrx'

# MakeFeatureLayer converts the .lyrx to features
chicagoCrimesLayer = arcpy.management.MakeFeatureLayer(inputLyrx, "Crimes_layer")

# ApplySymbologyFromLayer sets the time using the .lyrx file definition
arcpy.management.ApplySymbologyFromLayer(chicagoCrimesLayer, inputLyrx)

# Set local variables
spatialOperation = "NEAR"
nearDistance = "1 Kilometers"
temporalOperation = "NEAR"
nearTime = "3 Hours"
out = "CloseCrimes"

# Run Join Features
arcpy.gapro.JoinFeatures(chicagoCrimesLayer, inFeatures, out, "JOIN_ONE_TO_ONE",
                         spatialOperation, nearDistance, temporalOperation,
                         nearTime)

Environnements

Système de coordonnées en sortie, Etendue, Espace de travail courant

Informations de licence

Basic: Non
Standard: Non
Advanced: Oui

[Vue d’ensemble du jeu d’outils Summarize Data (Synthétiser les données)] (an-overview-of-the-summarize-data-toolset.md)
Remarques sur les outils GeoAnalytics Desktop
Rechercher un outil de géotraitement
Relations spatiales dans la boîte à outils GeoAnalytics Desktop
Relations temporelles dans la boîte à outils GeoAnalytics Desktop
Expressions ArcGIS Arcade dans la boîte à outils GeoAnalytics Desktop