Jointure spatiale (Outils d'analyse)

Résumé

Joint des attributs d’une ou plusieurs entrées vers une autre entrée en fonction des relations spatiales. Les entités cible et les attributs joints des entités jointes sont écrits dans la classe d’entités en sortie.

En savoir plus sur les relations de jointure spatiale par type d’entité

Utilisation

Une jointure spatiale apparie des lignes de valeurs Join Features (Entités jointes) aux valeurs Target Features (Entités cible) en fonction de leurs emplacements spatiaux relatifs.
Par défaut, tous les attributs des entités jointes sont ajoutés aux attributs des entités cible et copiés dans la classe d’entités en sortie. Vous pouvez définir les attributs qui doivent être inscrits dans la sortie à l’aide du paramètre Field Map (Appariement des champs).
Les champs suivants sont ajoutés à la classe d’entités en sortie :
- Join_Count—Nombre d’entités jointes correspondant à chaque entité cible.
  
  Lorsque la valeur du paramètre Join Features (Entités jointes) correspond à une seule entrée, la sortie contient un champ Join_Count par défaut. Lorsque plusieurs entrées sont présentes, le nom du champ du nombre de jointures inclut le nom de l’entrée par défaut, par exemple, Input1_JoinCount, Input2_JoinCount, etc. Personnalisez ce nom de champ en indiquant la colonne Join Count Field Name (Nom du champ de nombre de jointures).
- TARGET_FID—ID d’objet de l’entité cible.
Un champ supplémentaire, JOIN_FID, est ajouté à la sortie lorsque le paramètre Join Operation (Opération de jointure) est défini sur Join one to many (Joindre un vers plusieurs). Ce champ représente l’ID d’objet de l’entité jointe.
Lorsque le paramètre Join Operation (Opération de jointure) est défini sur Join one to many (Joindre un vers plusieurs), il peut exister plusieurs lignes dans la classe d’entités en sortie pour chaque entité cible. Servez-vous du champ JOIN_FID pour déterminer quelle entité est jointe à quelle entité cible (TARGET_FID). La valeur -1 dans le champ JOIN_FID signifie qu’aucune entité ne présente la relation spatiale spécifiée avec l’entité cible.
Toutes les entités cible en entrée sont écrites dans la classe d’entités en sortie, si les deux conditions suivantes sont remplies :
- Le paramètre Join Operation (Opération de jointure) est défini sur Join one to one (Joindre un vers un).
- Le paramètre Keep all target features (Conserver toutes les entités cibles) est activé.
Pour transférer des champs de façon définitive vers la classe d’entités cible, utilisez l’outil Add Spatial Join (Ajouter une jointure spatiale) en activant le paramètre Permanently Join Fields (Joindre définitivement les champs).

Le paramètre Field Map (Appariement des champs) permet de gérer les champs et leur contenu dans le jeu de données en sortie.
- Ajoutez et supprimez des champs de la liste des champs, réorganisez la liste des champs et renommez des champs.
- Le type de données par défaut d’un champ en sortie est le même que le type de données du premier champ en entrée (du même nom) qu’il rencontre. Vous pouvez modifier le type de données en un autre type de données valide.
- Utilisez une action pour identifier la manière dont les valeurs d’un ou de plusieurs champs en entrée sont fusionnées en un seul champ en sortie. Les actions disponibles sont First (Premier), Last (Dernier), Concatenate (Concaténer), Sum (Somme), Mean (Moyenne), Median (Médiane), Mode, Minimum, Maximum, Standard Deviation (Écart type) et Count (Total).
- Lorsque vous utilisez l’action Concatenate (Concaténer), vous pouvez spécifier un délimiteur, comme une virgule ou d’autres caractères. Cliquez au début de la zone de texte Delimiter (Délimiteur) pour ajouter les caractères de délimitation.
- L’option Standard Deviation (Écart type) n’est pas valide pour une seule valeur en entrée.
- L’option Export (Exporter) permet d’enregistrer un appariement des champs sous forme de fichier .fieldmap.
- L’option Load (Charger) permet de charger un fichier .fieldmap. La couche d’entités ou le jeu de données spécifié dans le fichier doit correspondre à celui utilisé dans l’outil. Sinon, le paramètre Field Map (Appariement des champs) est réinitialisé.
- Utilisez le bouton Slice Text (Texte de tranche) sur les champs de la source du texte pour sélectionner les caractères d’une valeur en entrée à extraire dans le champ en sortie. Pour accéder au bouton Slice Text (Texte de tranche), survolez un champ de texte dans la liste des champs en entrée, puis spécifiez les positions des caractères de début et de fin.
- Il est également possible d’apparier des champs dans un script Python.

Les actions spécifiées dans le paramètre Field Map (Appariement des champs) s’appliquent uniquement aux attributs des entités jointes, lorsque plusieurs entités sont appariées à une entité cible (lorsque Join_Count > 1). Par exemple, si trois entités dont les valeurs de l’attribut DEPTH sont 15,5, 2,5 et 3,3 sont jointes, et que l’action Mean (Moyenne) est appliquée, le champ en sortie aura la valeur 6,1. Les valeurs Null des champs de jointure sont ignorées dans le calcul de statistiques. Par exemple, 15,5, une valeur nulle et 2,5 produisent 9,0 pour Moyenne et 2 pour Total.
Lorsque le paramètre Match Option (Option de correspondance) a pour valeur Closest (Plus proche) ou Closest geodesic (Géodésique le plus proche), il est possible qu’au moins deux entités jointes se trouvent à la même distance de l’entité cible. Dans ce cas, l’une des entités jointes est sélectionnée de manière aléatoire en tant qu’entité appariée (l’ID d’objet de l’entité jointe n’a pas d’impact sur cette sélection aléatoire). Pour trouver la deuxième, la troisième ou la nième entité la plus proche, utilisez l’outil Generate Near Table (Générer la table de proximité).

En savoir plus sur le calcul de la proximité
Si une entité jointe présente une relation spatiale avec plusieurs entités cible, elle est comptabilisée autant de fois qu’elle est appariée à l’entité cible. Par exemple, si un point se trouve dans trois polygones, il est comptabilisé trois fois, à savoir une fois pour chaque polygone.
Le paramètre Attribute Matching (Appariement d’attributs) filtre les entités qui sont appariées par la relation spatiale spécifiée dans le paramètre Match Option (Option d’appariement). Spécifiez les champs des entités de jointure et cibles qui doivent comporter des attributs d’appariement en plus de leur relation spatiale.
Pour plus d’informations sur l’utilisation des relations spatiales Intersect 3D (Intersection 3D) et Within a distance 3D (Dans une distance 3D), reportez-vous à la rubrique Sélectionner selon l’emplacement : relations 3D.

Etiqueter	Explication	Type de données
Entités cible	Les attributs des entités cible et les attributs des entités jointes sont transférés vers la classe d’entités en sortie. Toutefois, un sous-ensemble d’attributs peut être défini par le paramètre d’appariement des champs.	Feature Layer
Joindre les entités	Les attributs des entités jointes sont joints aux attributs des entités cible. Reportez-vous au paramètre Join Operation (Opération de jointure) pour en savoir plus sur les répercussions du type d’opération de jointure sur l’agrégation des attributs joints. Utilisez la colonne Join Count Field Name (Nom du champ de nombre de jointures) afin de spécifier un nom personnalisé pour le champ de nombre de jointures. Lorsque plusieurs entrées sont présentes, le nom du champ de la classe d’entités est utilisé par défaut. Colonnes de la table de valeurs : Join Features—The features whose attributes will be joined to the target features. Join Count Field Name—The name of the join count field.	Value Table
Classe d’entités en sortie	Nouvelle classe d'entités contenant les attributs des entités jointes et cible. Par défaut, tous les attributs des entités cible et des entités jointes sont écrits dans la sortie. Toutefois, l’ensemble d’attributs à transférer peut être défini par le paramètre d’appariement des champs.	Feature Class
Opération de jointure (Facultatif)	Opération qui joint les entités cible et les entités jointes dans la classe d’entités en sortie, si plusieurs entités jointes présentent la même relation spatiale avec une entité cible unique. Joindre un vers un—Si plusieurs entités jointes présentent une relation spatiale identique avec une même entité cible, les attributs des entités jointes multiples sont agrégés à l'aide d'une règle de combinaison d'appariement des champs. Par exemple, si une entité cible ponctuelle figure dans deux entités jointes surfaciques distinctes, les attributs des deux polygones sont agrégés avant leur transfert vers la classe d'entités ponctuelles en sortie. Si les polygones ont respectivement les valeurs attributaires 3 et 7 et qu'une règle de combinaison de somme est spécifiée, la valeur agrégée dans la classe d'entités en sortie est de 10. Il s’agit de l’option par défaut. Joindre un vers plusieurs—Si plusieurs entités jointes présentent une relation spatiale identique avec une même entité cible, la classe d'entités en sortie contient plusieurs copies (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é en sortie contient deux copies de l’entité cible : un enregistrement avec les attributs du premier polygone et un enregistrement avec les attributs du deuxième polygone.	String
Conserver toutes les entités cibles (Facultatif)	Indique si toutes les entités cibles sont conservées dans la classe d’entités en sortie (jointure externe), ou uniquement celles qui présentent la relation spatiale avec les entités jointes (jointure interne) spécifiée. Activé—Toutes les entités cible sont conservées dans la sortie (jointure externe). Il s’agit de l’option par défaut. Décoché—Seules les entités cible ayant la relation spatiale spécifiée avec les entités jointes sont conservées dans la classe d'entités en sortie (jointure interne). Par exemple, si une classe d’entités ponctuelles est spécifiée pour les entités cibles et qu’une classe d’entités surfaciques est spécifiée pour les entités jointes lorsque le paramètre `match_option` est défini sur `WITHIN`, la classe d’entités en sortie contient uniquement les entités cibles qui se trouvent dans une entité jointe surfacique. Toute entité cible non contenue dans une entité jointe sera exclue de la sortie.	Boolean
Appariement des champs (Facultatif)	Les champs sont inclus dans la classe d’entités en sortie avec leurs propriétés et champs sources respectifs. La sortie inclut par défaut tous les champs des entités de jointure et cible. Utilisez l’appariement des champs pour ajouter, supprimer, renommer et réorganiser les champs, ainsi que pour modifier d’autres propriétés des champs. L’appariement des champs peut servir à combiner les valeurs de deux champs en entrée ou plus en un seul champ en sortie.	Field Mappings
Option de correspondance (Facultatif)	Spécifie les critères qui seront appliqués pour apparier les lignes. Intersecter—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. Spécifiez la distance dans le paramètre Search Radius (Rayon de recherche). Intersection 3D—Les entités dans les entités jointes sont appariées si elles intersectent une entité cible dans un espace tridimensionnel (x, y et z). Spécifiez la distance dans le paramètre Search Radius (Rayon de recherche). Dans une distance—Les entités dans les entités jointes sont appariées si elles se trouvent à une distance spécifiée d'une entité cible. Spécifiez la distance dans le paramètre Search Radius (Rayon de recherche). Dans une distance géodésique—Ce paramètre est identique au paramètre Within a distance (Dans une distance), mais la distance géodésique est utilisée au lieu de la distance planaire. La distance entre les entités est calculée à l’aide d’une formule géodésique qui tient compte de la courbure du sphéroïde et gère correctement les données situées près de la ligne de changement de date et des pôles. Utilisez cette option si les données couvrent une grande étendue géographique ou si le système de coordonnées des entrées ne convient pas au calcul des distances Dans une distance 3D—Les entités dans les entités jointes sont appariées si elles se trouvent à une distance spécifiée d'une entité cible dans un espace tridimensionnel. Spécifiez la distance dans le paramètre Search Radius (Rayon de recherche). 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. Pour cette option, les entités cible ne peuvent pas être ponctuelles, et les entités jointes ne peuvent être surfaciques que lorsque les entités cible le sont également. Contient complètement—Les entités des entités jointes sont appariées si une entité cible les englobe entièrement. Un polygone peut contenir entièrement toute entité. Un point ne peut contenir entièrement aucune entité et même pas un point. Une polyligne peut contenir entièrement uniquement des entités polyligne et ponctuelles. Contient Clementini—Cette relation spatiale génère les mêmes résultats que Completely contains (Contient complètement), mais si l’entité jointe se trouve entièrement à la limite de l’entité cible (sans aucune partie véritablement à l’intérieur ou à l’extérieur), l’entité n’est pas appariée. Clementini définit le polygone de limite comme la ligne qui sépare l’intérieur et l’extérieur. La limite d’une ligne est définie par ses extrémités et la limite d’un point est toujours vide. 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 Contains (Contient). Pour cette option, les entités cible ne peuvent être que des polygones lorsque les entités jointes le sont également. Un point peut être une entité de jointure uniquement si la cible est un point. Complètement dans—Les entités des entités jointes sont appariées si une entité cible se trouve entièrement à l'intérieur d'elles. C’est l’inverse de Completely contains (Contient complètement). Dans Clementini—Le résultat est identique à celui obtenu avec Within (Dans), sauf que si la totalité de l’entité dans les entités jointes est à la limite de l’entité cible, l’entité n’est pas appariée. Clementini définit le polygone de limite comme la ligne qui sépare l’intérieur et l’extérieur. La limite d’une ligne est définie par ses extrémités et la limite d’un point est toujours vide. Sont identiques à—Les entités dans les entités jointes sont appariées si elles sont identiques à une entité cible. Les entités jointe et cible doivent présenter le même type de forme : point à point, ligne à ligne ou polygone à polygone. La limite 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 jointes et cibles sont des lignes ou des polygones, la limite de l'entité jointe ne peut toucher que la limite de l'entité cible, et aucune partie de l'entité jointe ne peut dépasser la limite de l'entité cible. Partagent un segment de ligne avec—Les entités dans les entités jointes sont appariées si elles partagent un segment de ligne avec une entité cible. Les entités jointe et cible doivent être des lignes ou des polygones. Traversé par le contour de—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, contrairement à celles qui partagent un segment de ligne. Ont leur centre dans—Les entités des entités jointes sont appariées si le centre d'une entité cible se trouve entièrement à l'intérieur d'elles. Le centre de l’entité est calculé comme suit : pour les polygones et multi-points, le centroïde de la géométrie est utilisé, tandis que pour les lignes en entrée, le centre de la géométrie est utilisé. Spécifiez la distance dans le paramètre Search Radius (Rayon de recherche). Plus proche—L’entité dans les entités jointes les plus proches d’une entité cible est appariée. Pour en savoir plus, reportez-vous aux conseils d'utilisation. Spécifiez la distance dans le paramètre Search Radius (Rayon de recherche). Géodésique le plus proche—Identique à Closest (Plus proche), mais la distance géodésique est utilisée au lieu de la distance planaire. Utilisez cette option si les données couvrent une grande étendue géographique ou si le système de coordonnées des entrées ne convient pas au calcul des distances. Superposition la plus étendue—L’entité dans les entités jointes est appariée à l’entité cible qui présente la superposition la plus étendue.	String
Rayon de recherche (Facultatif)	Les entités jointes sont prises en compte pour la jointure spatiale si elles se trouvent à une distance égale ou inférieure à cette valeur d'une entité cible. Le rayon de recherche est valide uniquement lorsque la relation spatiale est spécifiée (le paramètre Match Option (Option de correspondance) a pour valeur Intersect (Intersection), Within a distance (Dans une distance), Within a distance geodesic (Dans une distance géodésique), Have their center in (Ont leur centre dans), Closest (Plus proche) ou Closest geodesic (Géodésique le plus proche)). Par exemple, l’utilisation d’un rayon de recherche de 100 mètres avec la relation spatiale Within a distance (Dans une distance) permet de joindre une entité qui se trouve à moins de 100 mètres d’une entité cible. Pour les trois relations Within a distance (Dans une distance), si aucune valeur n’est spécifiée pour Search Radius (Rayon de recherche), une distance de 0 est utilisée.	Linear Unit
Nom du champ de distance (Facultatif)	Nom du champ contenant la distance entre l’entité cible et l’entité jointe la plus proche. Ce champ est ajouté à la classe d’entités en sortie. Ce paramètre est valide uniquement lorsque la relation spatiale est spécifiée et que le paramètre Match Option (Option d’appariement) est défini sur Closest (Le plus proche) ou sur Closest geodesic (Géodésique le plus proche). La valeur de ce champ est -1 si aucune entité ne fait l'objet d'une correspondance dans un rayon de recherche. Si aucun nom de champ n’est fourni, le champ n’est pas ajouté à la classe d’entités en sortie.	String
Champs d'appariement (Facultatif)	Paires de champs des entités de jointure et des entités cible qui sont utilisées pour l’appariement des attributs. Seuls les enregistrements des entités de jointure qui partagent les valeurs des champs d’appariement avec les entités cibles participent à la jointure spatiale. Colonnes de la table de valeurs : Join Fields—Fields from the join features that will be used for attribute matching. Target Fields—Fields from the target features that will be used for attribute matching.	Value Table

arcpy.analysis.SpatialJoin(target_features, join_features, out_feature_class, {join_operation}, {join_type}, {field_mapping}, {match_option}, {search_radius}, {distance_field_name}, {match_fields})

Nom	Explication	Type de données
target_features	Les attributs des entités cible et les attributs des entités jointes sont transférés vers la classe d’entités en sortie. Toutefois, un sous-ensemble d’attributs peut être défini par le paramètre d’appariement des champs.	Feature Layer
join_features [join_features,...]	Les attributs des entités jointes sont joints aux attributs des entités cible. Reportez-vous au paramètre `join_operation` pour en savoir plus sur les répercussions du type d’opération de jointure sur l’agrégation des attributs joints. Utilisez la deuxième colonne pour indiquer un nom personnalisé pour le champ du nombre de jointures. Lorsque plusieurs entrées sont présentes, le nom du champ de la classe d’entités est utilisé par défaut. Colonnes de la table de valeurs : `Join Features`—The features whose attributes will be joined to the target features. `Join Count Field Name`—The name of the join count field.	Value Table
out_feature_class	Nouvelle classe d'entités contenant les attributs des entités jointes et cible. Par défaut, tous les attributs des entités cible et des entités jointes sont écrits dans la sortie. Toutefois, l’ensemble d’attributs à transférer peut être défini par le paramètre d’appariement des champs.	Feature Class
join_operation (Facultatif)	Opération qui joint les entités cible et les entités jointes dans la classe d’entités en sortie, si plusieurs entités jointes présentent la même relation spatiale avec une entité cible unique. `JOIN_ONE_TO_ONE`—Si plusieurs entités jointes présentent une relation spatiale identique avec une même entité cible, les attributs des entités jointes multiples sont agrégés à l'aide d'une règle de combinaison d'appariement des champs. Par exemple, si une entité cible ponctuelle figure dans deux entités jointes surfaciques distinctes, les attributs des deux polygones sont agrégés avant leur transfert vers la classe d'entités ponctuelles en sortie. Si les polygones ont respectivement les valeurs attributaires 3 et 7 et qu'une règle de combinaison de somme est spécifiée, la valeur agrégée dans la classe d'entités en sortie est de 10. Il s’agit de l’option par défaut. `JOIN_ONE_TO_MANY`—Si plusieurs entités jointes présentent une relation spatiale identique avec une même entité cible, la classe d'entités en sortie contient plusieurs copies (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é en sortie contient deux copies de l’entité cible : un enregistrement avec les attributs du premier polygone et un enregistrement avec les attributs du deuxième polygone.	String
join_type (Facultatif)	Indique si toutes les entités cibles sont conservées dans la classe d’entités en sortie (jointure externe), ou uniquement celles qui présentent la relation spatiale avec les entités jointes (jointure interne) spécifiée. `KEEP_ALL`—Toutes les entités cible sont conservées dans la sortie (jointure externe). Il s’agit de l’option par défaut. `KEEP_COMMON`—Seules les entités cible ayant la relation spatiale spécifiée avec les entités jointes sont conservées dans la classe d'entités en sortie (jointure interne). Par exemple, si une classe d’entités ponctuelles est spécifiée pour les entités cibles et qu’une classe d’entités surfaciques est spécifiée pour les entités jointes lorsque le paramètre `match_option` est défini sur `WITHIN`, la classe d’entités en sortie contient uniquement les entités cibles qui se trouvent dans une entité jointe surfacique. Toute entité cible non contenue dans une entité jointe sera exclue de la sortie.	Boolean
field_mapping (Facultatif)	Les champs sont inclus dans la classe d’entités en sortie avec leurs propriétés et champs sources respectifs. La sortie inclut par défaut tous les champs des entités de jointure et cible. Utilisez l’appariement des champs pour ajouter, supprimer, renommer et réorganiser les champs, ainsi que pour modifier d’autres propriétés des champs. L’appariement des champs peut servir à combiner les valeurs de deux champs en entrée ou plus en un seul champ en sortie. En Python, utilisez la classe FieldMappings pour définir ce paramètre.	Field Mappings
match_option (Facultatif)	Spécifie les critères qui seront appliqués pour apparier les lignes. `INTERSECT`—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. Spécifiez la distance dans le paramètre `search_radius`. `INTERSECT_3D`—Les entités dans les entités jointes sont appariées si elles intersectent une entité cible dans un espace tridimensionnel (x, y et z). Spécifiez la distance dans le paramètre `search_radius`. `WITHIN_A_DISTANCE`—Les entités dans les entités jointes sont appariées si elles se trouvent à une distance spécifiée d'une entité cible. Spécifiez la distance dans le paramètre `search_radius`. `WITHIN_A_DISTANCE_GEODESIC`—Ce paramètre est identique au paramètre `WITHIN_A_DISTANCE`, mais la distance géodésique est utilisée au lieu de la distance planaire. La distance entre les entités est calculée à l’aide d’une formule géodésique qui tient compte de la courbure du sphéroïde et gère correctement les données situées près de la ligne de changement de date et des pôles. Utilisez cette option si les données couvrent une grande étendue géographique ou si le système de coordonnées des entrées ne convient pas au calcul des distances `WITHIN_A_DISTANCE_3D`—Les entités dans les entités jointes sont appariées si elles se trouvent à une distance spécifiée d'une entité cible dans un espace tridimensionnel. Spécifiez la distance dans le paramètre `search_radius`. `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. Pour cette option, les entités cible ne peuvent pas être ponctuelles, et les entités jointes ne peuvent être surfaciques que lorsque les entités cible le sont également. `COMPLETELY_CONTAINS`—Les entités des entités jointes sont appariées si une entité cible les englobe entièrement. Un polygone peut contenir entièrement toute entité. Un point ne peut contenir entièrement aucune entité et même pas un point. Une polyligne peut contenir entièrement uniquement des entités polyligne et ponctuelles. `CONTAINS_CLEMENTINI`—Cette relation spatiale génère les mêmes résultats que `COMPLETELY_CONTAINS`, mais si l’entité jointe se trouve entièrement à la limite de l’entité cible (sans aucune partie véritablement à l’intérieur ou à l’extérieur), l’entité n’est pas appariée. Clementini définit le polygone de limite comme la ligne qui sépare l’intérieur et l’extérieur. La limite d’une ligne est définie par ses extrémités et la limite d’un point est toujours vide. `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 `CONTAINS`. Pour cette option, les entités cible ne peuvent être que des polygones lorsque les entités jointes le sont également. Un point peut être une entité de jointure uniquement si la cible est un point. `COMPLETELY_WITHIN`—Les entités des entités jointes sont appariées si une entité cible se trouve entièrement à l'intérieur d'elles. C’est l’inverse de `COMPLETELY_CONTAINS`. `WITHIN_CLEMENTINI`—Le résultat est identique à celui obtenu avec `WITHIN`, sauf que si la totalité de l’entité dans les entités jointes est à la limite de l’entité cible, l’entité n’est pas appariée. Clementini définit le polygone de limite comme la ligne qui sépare l’intérieur et l’extérieur. La limite d’une ligne est définie par ses extrémités et la limite d’un point est toujours vide. `ARE_IDENTICAL_TO`—Les entités dans les entités jointes sont appariées si elles sont identiques à une entité cible. Les entités jointe et cible doivent présenter le même type de forme : point à point, ligne à ligne ou polygone à polygone. `BOUNDARY_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 jointes et cibles sont des lignes ou des polygones, la limite de l'entité jointe ne peut toucher que la limite de l'entité cible, et aucune partie de l'entité jointe ne peut dépasser la limite de l'entité cible. `SHARE_A_LINE_SEGMENT_WITH`—Les entités dans les entités jointes sont appariées si elles partagent un segment de ligne avec une entité cible. Les entités jointe et cible doivent être des lignes ou des polygones. `CROSSED_BY_THE_OUTLINE_OF`—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, contrairement à celles qui partagent un segment de ligne. `HAVE_THEIR_CENTER_IN`—Les entités des entités jointes sont appariées si le centre d'une entité cible se trouve entièrement à l'intérieur d'elles. Le centre de l’entité est calculé comme suit : pour les polygones et multi-points, le centroïde de la géométrie est utilisé, tandis que pour les lignes en entrée, le centre de la géométrie est utilisé. Spécifiez la distance dans le paramètre `search_radius`. `CLOSEST`—L’entité dans les entités jointes les plus proches d’une entité cible est appariée. Pour en savoir plus, reportez-vous aux conseils d'utilisation. Spécifiez la distance dans le paramètre `search_radius`. `CLOSEST_GEODESIC`—Ce paramètre est identique au paramètre `CLOSEST`, mais la distance géodésique est utilisée au lieu de la distance planaire. Utilisez cette option si les données couvrent une grande étendue géographique ou si le système de coordonnées des entrées ne convient pas au calcul des distances. `LARGEST_OVERLAP`—L’entité dans les entités jointes est appariée à l’entité cible qui présente la superposition la plus étendue.	String
search_radius (Facultatif)	Les entités jointes sont prises en compte pour la jointure spatiale si elles se trouvent à une distance égale ou inférieure à cette valeur d'une entité cible. Le rayon de recherche est valide uniquement si la relation spatiale est spécifiée (le paramètre `match_option` a pour valeur `INTERSECT`, `WITHIN_A_DISTANCE`, `WITHIN_A_DISTANCE_GEODESIC`, `HAVE_THEIR_CENTER_IN`, `CLOSEST` ou `CLOSEST_GEODESIC`). Par exemple, l’utilisation d’un rayon de recherche de 100 mètres avec la relation spatiale `WITHIN_A_DISTANCE` permet de joindre une entité qui se trouve à moins de 100 mètres d’une entité cible. Pour les trois relations Within a distance (Dans une distance), si aucune valeur n’est spécifiée pour `search_radius`, une distance de 0 est utilisée.	Linear Unit
distance_field_name (Facultatif)	Nom du champ contenant la distance entre l’entité cible et l’entité jointe la plus proche. Ce champ est ajouté à la classe d’entités en sortie. Ce paramètre est valide uniquement lorsque la relation spatiale est spécifiée et que le paramètre `match_option` est défini sur `CLOSEST` ou `CLOSEST_GEODESIC`. La valeur de ce champ est -1 si aucune entité ne fait l'objet d'une correspondance dans un rayon de recherche. Si aucun nom de champ n’est fourni, le champ n’est pas ajouté à la classe d’entités en sortie.	String
match_fields [[join_field, target_field],...] (Facultatif)	Paires de champs des entités de jointure et des entités cible qui sont utilisées pour l’appariement des attributs. Seuls les enregistrements des entités de jointure qui partagent les valeurs des champs d’appariement avec les entités cibles participent à la jointure spatiale. Colonnes de la table de valeurs : `Join Fields`—Fields from the join features that will be used for attribute matching. `Target Fields`—Fields from the target features that will be used for attribute matching.	Value Table

Exemple de code

Exemple 1 d’utilisation de l’outil SpatialJoin (fenêtre Python)

Le script ci-dessous illustre l’utilisation de la fonction SpatialJoin dans une fenêtre Python.

import arcpy

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

arcpy.analysis.SpatialJoin(target_features, join_features, out_feature_class)

Exemple 2 d’utilisation de l’outil SpatialJoin (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction SpatialJoin pour joindre des attributs de villes à des états.

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

# Import system modules
import arcpy
import os

# Set local variables
workspace = r"C:\gpqa\mytools\spatialjoin\usa.gdb"
outWorkspace = r"C:\gpqa\mytools\spatialjoin\output.gdb"

# Want to join USA cities to states and calculate the mean city population
# for each state
targetFeatures = os.path.join(workspace, "states")
joinFeatures = os.path.join(workspace, "cities")

# Output will be the target features, states, with a mean city population field (mcp)
outfc = os.path.join(outWorkspace, "states_mcp2")

# Create a new fieldmappings and add the two input feature classes.
fieldmappings = arcpy.FieldMappings()
fieldmappings.addTable(targetFeatures)
fieldmappings.addTable(joinFeatures)

# First get the POP1990 fieldmap. POP1990 is a field in the cities feature class.
# The output will have the states with the attributes of the cities. Setting the
# field's merge rule to mean will aggregate the values for all of the cities for
# each state into an average value. The field is also renamed to be more appropriate
# for the output.
pop1990FieldIndex = fieldmappings.findFieldMapIndex("POP1990")
fieldmap = fieldmappings.getFieldMap(pop1990FieldIndex)

# Get the output field's properties as a field object
field = fieldmap.outputField

# Rename the field and pass the updated field object back into the field map
field.name = "mean_city_pop"
field.aliasName = "mean_city_pop"
fieldmap.outputField = field

# Set the merge rule to mean and then replace the old fieldmap in the mappings object
# with the updated one
fieldmap.mergeRule = "mean"
fieldmappings.replaceFieldMap(pop1990FieldIndex, fieldmap)

# Delete fields that are no longer applicable, such as city CITY_NAME and CITY_FIPS
# as only the first value will be used by default
x = fieldmappings.findFieldMapIndex("CITY_NAME")
fieldmappings.removeFieldMap(x)
y = fieldmappings.findFieldMapIndex("CITY_FIPS")
fieldmappings.removeFieldMap(y)

#Run the Spatial Join tool, using the defaults for the join operation and join type
arcpy.analysis.SpatialJoin(targetFeatures, joinFeatures, outfc, "#", "#", fieldmappings)

Environnements

Valeur Z en sortie par défaut, Résolution M, Tolérance M, Mot-clé CONFIG en sortie, Domaine M en sortie, Domaine XY en sortie, Domaine Z en sortie, Système de coordonnées en sortie, Etendue, Valeurs M en sortie, Valeurs Z en sortie, Résolution XY, Tolérance XY, Résolution Z, Tolérance Z

Informations de licence