Joindre les entités

L’outil Joindre des entités ajoute les attributs d’une couche ou d’une table à une autre en fonction de relations spatiales et attributaires spécifiées. Les statistiques peuvent éventuellement être calculées pour les entités jointes.

La sortie correspond à une couche d’entités hébergée ou une couche tabulaire hébergée, selon que la couche cible en entrée est une table ou non.

Exemple

Vous disposez de données stockées dans une table et vous devez les afficher spatialement. La table dénombre les centres de santé primaires (PHC) dans chaque État ou territoire de l’Union de l’Inde. L’outil Joindre des entités peut être utilisé pour joindre la table à une couche d’entités de façon à ce que les données PHC puissent s’afficher spatialement.

La première image montre la couche d’entités en entrée (Inde et territoires de l’union). La deuxième image montre des diagrammes à secteurs indiquant le nombre de centres de santé primaires ruraux et urbains par limite.

Consultez le didacticiel Join a table to a feature layer in ArcGIS Online (Joindre une table à une couche d’entités dans ArcGIS Online) pour découvrir le processus complet.

Remarques sur l’utilisation

L’outil Join Features (Joindre des entités) inclut des configurations pour les entités en entrée, les paramètres de jointure et la couche de résultat.

Entités en entrée

Le groupe Input features (Entités en entrée) comprend les paramètres suivant :

• Target layer (Couche cible) spécifie la couche ou la table à laquelle seront ajoutés les enregistrements.Vous pouvez sélectionner une couche à l’aide du bouton Layer (Couche) ou créer une couche de dessin en entrée à l’aide du bouton Draw input features (Dessiner des entités en entrée).

  Pour les entités en entrée, le nombre d’entités est affiché sous le nom de la couche. Ce nombre inclut toutes les entités de la couche, à l’exception des entités supprimées à l’aide d’un filtre. Les paramètres d’environnement, comme Processing extent (Étendue de traitement), ne sont pas comptabilisés dans le nombre d’entités.

• Join layer (Couche de jointure) spécifie la couche ou la table dont les enregistrements seront ajoutés à la couche cible.

  Pour les entités en entrée, le nombre d’entités est affiché sous le nom de la couche. Ce nombre inclut toutes les entités de la couche, à l’exception des entités supprimées à l’aide d’un filtre. Les paramètres d’environnement, comme Processing extent (Étendue de traitement), ne sont pas comptabilisés dans le nombre d’entités.

Paramètres de jointure

Le groupe Join settings (Paramètres de jointure) inclut les paramètres suivants :

• Use spatial relationship (Utiliser la relation spatiale) détermine si une jointure spatiale est créée. Si l’option Use spatial relationship (Utiliser la relation spatiale) est désactivée, Use attribute relationship (Utiliser la relation attributaire) doit être activé. Cette option n’est pas disponible si une ou plusieurs des entrées correspondent à une couche tabulaire.
• Spatial relationship (Relation spatiale) détermine la façon dont les entités spatiales sont jointes les unes aux autres. Les relations disponibles dépendent du type de géométrie (point, ligne ou polygone) des couches jointes. Spatial relationship (Relation spatiale) est disponible lorsque l’option Use spatial relationship (Utiliser la relation spatiale) est activée. Les options sont les suivantes :
  • Intersecte : les entités dans la couche cible sont appariées si elles intersectent les entités de la couche de jointure.
  • Within a distance (Dans une distance de) : les entités de la couche de jointure sont appariées si elles se trouvent à une distance spécifiée des entités de la couche cible.
  • Identique à : les entités dans la couche cible sont appariées si elles sont identiques aux entités de la couche de jointure.
  • Contient complètement : les entités dans la couche cible sont appariées si elles contiennent complètement les entités de la couche de jointure.
  • Complètement dans : les entités dans la couche cible sont appariées si elles se trouvent complètement au sein des entités de la couche de jointure.
• Distance détermine quelle doit être la proximité des entités de la couche de jointure avec les entités de la couche cible pour être jointes les unes aux autres. L’option Distance est disponible lorsque Within a distance (Dans une distance de) est le paramètre choisi pour Spatial relationship (Relation spatiale).
• Units (Unités) correspond aux unités de distance qui déterminent quelle doit être la proximité des entités de la couche de jointure avec les entités de la couche cible pour être jointes les unes aux autres. L’option Units (Unités) est disponible lorsque Within a distance (Dans une distance de) est le paramètre choisi pour Spatial relationship (Relation spatiale).
• Use attribute relationship (Utiliser la relation attributaire) détermine si une jointure attributaire est créée. Si l’option Use attribute relationship (Utiliser la relation attributaire) est désactivée, Use spatial relationship (Utiliser la relation spatiale) doit être activé. Use attribute relationship (Utiliser la relation attributaire) est la seule option si une ou plusieurs des entrées correspondent à une couche tabulaire.
• L’option Attribute relationships (Relations attributaires) détermine la façon dont les attributs sont joints les uns aux autres. Attribute relationships (Relations attributaires) est disponible lorsque l’option Use attribute relationship (Utiliser la relation attributaire) est activée. Les sous-paramètres suivants sont disponibles :
  • Target field (Champ cible) : champ de la couche cible qui sera utilisé pour créer la jointure attributaire.
  • Join field (Champ de jointure) : champ de la couche de jointure qui sera utilisé pour créer la jointure attributaire.

  Target field (Champ cible) et Join field (Champ de jointure) doivent contenir des valeurs appariées pour créer une jointure valide.

  Des champs cibles et des champs de jointure supplémentaires peuvent être ajoutés à la jointure en cliquant sur le bouton Add (Ajouter).
• Join operation (Opération de jointure) détermine le mode de traitement des jointures entre la couche cible et la couche de jointure si plusieurs entités de la couche de jointure présentent la même relation à la couche cible. Les options sont les suivantes :
  • Join one to one (Joindre un vers un) : joint un seul enregistrement de la couche de jointure à chaque entité de la couche cible. Il peut s’agir du premier enregistrement ou d’un résumé de tous les enregistrements correspondants, selon la définition du paramètre Multiple matching records (Plusieurs enregistrements correspondants).
  • Join one to many (Joindre un vers plusieurs) : joint toutes les entités appariées de la couche de jointure à la couche cible. La couche de résultat contiendra plusieurs enregistrements de l’entité cible.
• Multiple matching records (Plusieurs enregistrements correspondants) détermine quels enregistrements de la couche de jointure seront utilisés dans une jointure un vers un. L’option Multiple matching records (Plusieurs enregistrements correspondants) est disponible si Join one to one (Joindre un vers un) est le paramètre choisi pour Join operation (Opération de jointure). Les options sont les suivantes :
  • Only keep first matching record (Conserver uniquement le premier enregistrement correspondant) : seul un enregistrement correspondant de la couche de jointure est utilisé pour chaque entité cible. L’enregistrement correspondant est déterminé par le paramètre Sort by (Trier par).
  • Calculate field statistics (Calculer les statistiques de champ) : calcule les résumés statistiques pour le champ de votre choix pour tous les enregistrements appariés à chaque entité de la couche cible. Le nombre d’enregistrements récapitulés est également ajouté par défaut.
  • Calculate count only (Calculer uniquement le total) : calcule le nombre total d’entités appariées sans renvoyer d’autre résumé statistique.

• Sort by (Trier par) détermine la façon dont le premier enregistrement correspondant est choisi. Sort by (Trier par) est disponible si l’option Only keep first matching record (Conserver uniquement le premier enregistrement correspondant) est sélectionnée pour le paramètre Multiple matching records (Plusieurs enregistrements correspondants).

  Sort by (Trier par) inclut les sous-paramètres suivants :
  • Field (Champ) : détermine quel champ de la couche de jointure est utilisé pour choisir l’enregistrement correspondant à conserver. Par défaut, le champ ObjectID est utilisé pour conserver le premier enregistrement correspondant dans le jeu de données. Si un champ est sélectionné, les valeurs de ce champ seront utilisées pour sélectionner l’enregistrement à conserver en fonction du paramètre Sort order (Ordre de tri). Les champs numériques et de date sont pris en charge.
  • Sort order (Ordre de tri) : détermine si le champ est trié par ordre croissant ou décroissant lors du choix du premier enregistrement correspondant.

• Le paramètre Field statistics (Statistiques de champ) détermine les champs numériques de la couche de jointure à synthétiser. Les résumés statistiques pris en charge sont les suivants : somme, minimum, maximum, moyenne et écart type. Les statistiques sont calculées pour chaque entité cible. L’option Field statistics (Statistiques de champ) est disponible si Summarize matching records (Synthétiser les enregistrements correspondants) est sélectionné pour le paramètre Multiple matching records (Plusieurs enregistrements correspondants).

  En savoir plus sur les statistiques récapitulatives.
• L’option Join type (Type de jointure) détermine si la sortie inclut uniquement les entités appariées ou bien toutes les entités de la couche cible. Les options sont les suivantes :
  • Inner join (Jointure interne) : seules les entités d’appariement entre la couche cible et la couche de jointure seront renvoyées dans la couche de résultat.
  • Left join (Jointure gauche) : toutes les entités de la couche cible seront renvoyées, qu’elles correspondent ou non à des entités de la couche de jointure.

Un exemple montre des jointures attributaires un vers un et un vers plusieurs utilisant des types de jointure interne et gauche. Dans cet exemple, les jointures un vers un incluent l’enregistrement par défaut, la somme des Occupants et le maximum d’Occupants.

Couche de résultat

Le groupe Result layer (Couche de résultat) comprend les paramètres suivants :

• Le paramètre Output name (Nom en sortie) spécifie le nom de la couche qui a été créée et est affichée. Le nom doit être unique. Si une couche du même nom existe déjà dans votre organisation, l’outil échoue et vous êtes invité à utiliser un autre nom.
• Le paramètre Save in folder (Enregistrer dans un dossier) indique le nom d’un dossier de My content (Mon contenu) dans lequel est enregistré le résultat.

Limitations

Les limitations suivantes s’appliquent à l'outil :

• L’outil Join Features (Joindre les entités) ne peut pas créer des sorties en tant que vues de couches d’entités hébergées. Pour plus d’informations sur la création de vues de couches d’entités hébergées, reportez-vous à la rubrique Créer des vues de couches d’entités hébergées.
• Vous pouvez calculer des statistiques de champ uniquement si une opération Join one to one (Joindre un vers un) est spécifiée.
• Il n’est pas possible de créer des jointures à l’aide de champs dont le type est ObjectID. Si les valeurs d’un champ ObjectID doivent être utilisées dans une jointure, vous pouvez créer un champ entier et calculer le champ à partir de la valeur ObjectID.
• Les pièces jointes de la couche cible ou de la couche de jointure ne sont pas incluses dans la couche en sortie.
• Le bouton Draw input features (Dessiner des entités en entrée) n’est pas disponible dans Scene Viewer.

Environnements

Les paramètres d’environnement d’analyse sont des paramètres supplémentaires qui affectent les résultats d’un outil. Vous pouvez accéder aux paramètres d’environnement d’analyse de l'outil à partir du groupe de paramètres Environment settings (Paramètres d'environnement).

Cet outil respecte les environnements d'analyse suivants :

• Système de coordonnées en sortie
• Etendue de traitement

  Remarque :

  L’étendue de traitement par défaut correspond à l’étendue Full extent (Vue générale). Ce paramètre par défaut diffère de Map Viewer Classic, où Use current map extent (Utiliser l’étendue courante de la carte) est activé par défaut.

Crédits

Cet outil consomme des crédits.

Utilisez le paramètre Estimate credits (Estimer les crédits) pour calculer le nombre de crédits requis pour exécuter l’outil. Pour plus d’informations, reportez-vous à la rubrique Comprendre les crédits pour l’analyse spatiale.

Sorties

La sortie de l’outil inclut une couche contenant les enregistrements d’origine de la couche cible auxquels sont ajoutés les enregistrements correspondants de la couche de jointure. La géométrie de la couche en sortie est identique à celle de la couche cible. Si la couche cible est une table, la sortie sera également une table.

Remarque :

L’outil Join Features (Joindre les entités) ne peut pas créer des sorties en tant que vues de couches d’entités hébergées. Pour plus d’informations sur la création de vues de couches d’entités hébergées, reportez-vous à la rubrique Créer des vues de couches d’entités hébergées.

Licences requises

Cet outil requiert le type d’utilisateur et les configurations suivants :

• Type d’utilisateur Creator, Professional ou Professional Plus
• Rôle d’éditeur, de facilitateur ou d’administrateur, ou rôle personnalisé équivalent

Ressources

Référez-vous aux ressources suivantes pour en savoir plus :

• Résumés statistiques
• Joindre des entités dans ArcGIS REST API
• join_features dans ArcGIS API for Python
• Spatial Join (Jointure spatiale) dans ArcGIS Pro
• Ajouter une jointure dans ArcGIS Pro
• Summary Statistics (Résumés statistiques) dans ArcGIS Pro