Étiquette | Explication | Type de données |
Entités ponctuelles en entrée | Classe ou couche d’entités ponctuelles en entrée. | Feature Layer |
Appariement de champs Points | Appariement des champs du composant d’adresse à partir des entités ponctuelles à utiliser pour comparer le nom complet de la rue par rapport au nom de la rue dans la valeur du paramètre Entités Rue pour calculer le segment de rue auquel le point est associé. Pour sélectionner les composants d’adresse depuis la valeur de paramètre Entités ponctuelles en entrée utilisés pour associer le point à la rue, procédez comme suit :
Les champs disponibles du composant d’adresse sont les suivants :
| Value Table |
Entités Rue | Classe ou couche d’entités Rue en entrée à partir de laquelle les attributs sont affectés à la valeur de paramètre Entités ponctuelles en entrée. | Feature Layer |
Appariement de champs Rues | Appariement des champs du composant d’adresse de rue, de la ville, de l’État, du code de pays et du code de langue à partir des entités de rue permettant de comparer le nom complet de la rue au nom complet de la rue dans la valeur de paramètre Entités ponctuelles en entrée pour calculer le segment de rue auquel ce point est associé. Pour sélectionner les composants d’adresse depuis la valeur de paramètre Entités Rue à utiliser pour associer le point à la rue, procédez comme suit :
Sélectionnez les champs depuis la classe d’entités Rue dans la liste déroulante Champ de données qui correspondent au composant d’adresse répertorié dans la colonne Nom de champ. Les champs disponibles du composant d’adresse sont les suivants :
| Value Table |
Points en sortie | Classe d’entités ponctuelles en sortie contenant les champs Rue affectés au point. | Feature Class |
Champ(s) Rues (Facultatif) | Champs provenant de la valeur de paramètre Entités Rue qui sont affectés à la valeur de paramètre Points en sortie. Sélectionnez les champs depuis les entités Rue en entrée qui contiennent des attributs à attribuer aux entités ponctuelles associées, par exemple un champ qui contient une valeur ID de rue. Les champs sélectionnés sont ajoutés à la valeur de paramètre Points en sortie. | Field |
Distance (Facultatif) | Distance utilisée pour trouver l’entité Rue la plus proche de l’entité ponctuelle. Plus la limite de la distance est élevée, plus l’outil met du temps à s’exécuter, mais la qualité des correspondances s’améliore. La valeur par défaut est 100 mètres. | Double |
Géométrie en sortie (Facultatif) | Spécifie la géométrie incluse dans la classe d’entités ponctuelles en sortie.
| String |
Pays ou région (Facultatif) | Indique le lieu d’application de la logique propre à un pays sur les données en entrée pour attribuer des attributs de segment de rue aux entités ponctuelles. La valeur par défaut correspond au paramètre régional du système d’exploitation. Il peut être spécifié en sélectionnant l’option <Comme défini dans les données> et en associant une valeur des paramètres Entités points en entrée et Entités rue à la fois dans les paramètres Appariement des champs de point et Appariement des champs de rue. Il est également possible de l’appliquer à l’ensemble du jeu de données en spécifiant une option de pays.
| String |
Code de la langue (Facultatif) | Indique le lieu d’application de la logique propre à une langue sur les données en entrée pour attribuer des attributs de segment de rue aux entités ponctuelles. La valeur par défaut correspond au paramètre régional du système d’exploitation. Il peut être spécifié en sélectionnant l’option <Comme défini dans les données> et en associant une valeur des paramètres Entités points en entrée et Entités rue dans les paramètres Appariement des champs de point et Appariement des champs de rue. Il est également possible de l’appliquer à l’ensemble du jeu de données en spécifiant une option de langue.
| String |
Synthèse
Recherche le meilleur candidat d’entité de rue pour un point à l’aide d’informations d’adresse telles que les numéros de domicile et les noms de rue, ainsi que la distance. Les informations sur les adresses sont prioritaires par rapport à la distance.
Cet outil permet d’associer des adresses de point à des données de rue. Le lien est établi en comparant les informations d’adresse du point et les entités rue, ainsi que la distance entre elles. Le meilleur candidat est celui dont le nom présente le plus de similitudes, mais il doit également se trouver à proximité. Une fois le lien établi, l’ID d’objet de la rue, un côté de la rue et un nouveau point à proximité de la rue peuvent être générés pour la même adresse de point. Des attributs supplémentaires peuvent également être transférés de la rue vers l’adresse du point. Parmi les cas d’utilisation de cet outil, notons l’ajout d’attributs de rues à des adresses de point ou inversement, la génération de points se trouvant à proximité de la même rue nommée et pouvant servir de localisation d’itinéraire, ou la production de diagramme en arêtes de poisson pour illustrer la relation entre des adresses de point et l’entité rue qui leur est associée.
Pour en savoir plus, voir Attribuer des rues à des points en fonction des noms de rue et de la proximité.
Illustration

Utilisation
Cet outil accepte les classes ponctuelles en une seule partie et les classes d’entité linéaire en entrée.
Cet outil permet d’attribuer un ID de jointure pour les noms alternatifs provenant des données de référence des rues aux données de référence des points, de sorte que le même ID de jointure soit utilisé pour les deux jeux de données pour la liaison à la table des noms de rue alternatifs.
Utilisez cet outil pour enregistrer les coordonnées du point correspondant sur la rue pour utiliser la propriété Emplacement préféré pour le localisateur lorsque la géométrie de l’entité ponctuelle en entrée est sur le toit ou centroïde de la parcelle.
Cet outil enregistre de meilleures performances lorsque les classes d’entités linéaires et ponctuelles en entrée sont stockées dans une géodatabase et que la sortie est enregistrée vers une géodatabase.
Pour les valeurs de paramètre Appariement des champs de point et Appariement des champs de rue, utilisez l’outil Fractionner des adresses en composants dans les deux jeux de données et utilisez les résultats en sortie de cet outil pour les valeurs de paramètre Entités ponctuelles en entrée et Entités rue pour que l’outil Attribuer des rues à des points puisse obtenir des affectations de rue optimisées.
Pour un appariement entièrement optimisé, vérifiez que les champs de ville, d’État, de code pays et de code de langue sont appariés aux valeurs de paramètre Appariement des champs de point et Appariement des champs de rue. Pour un appariement partiellement optimisé, vérifiez que les champs de code pays et de code de langue sont appariés ou spécifiez le pays dans le paramètre Pays ou région et la langue dans le paramètre Code de la langue.
Pour une qualité optimale, vérifiez que les champs de numéro de domicile et de nom de rue dans les classes d’entités ponctuelles et de rue en entrée sont spécifiés pour les valeurs de paramètre Appariement des champs de point et Appariement des champs de rue.
Pour faciliter les processus de calcul d’itinéraire, la sortie fournit un indicateur du côté de la rue où se trouve le point. Lors de la création d’un localisateur, utiliser cet indicateur permettra au localisateur d’afficher les résultats du bon côté de la rue.
La sortie est une copie de toutes les entités et de tous les attributs des entités ponctuelles en entrée avec les attributs des champs spécifiés pour la valeur de paramètre Champ(s) de rue ajoutée au point de la rue associée. Cela peut inclure un champ ID de rue depuis la classe d’entités Rue en entrée.
La sortie inclura les champs suivants par défaut :
- Street_ObjectID– ID objet du segment de rue depuis la valeur de paramètre Entités Rue associée aux points en entrée.
Remarque :
Si la classe d’entités Rue en entrée contient un champ avec un ID de rue, sélectionnez ce champ comme valeur de paramètre Champ(s) de rues qui peut être utilisée lors de l’examen des résultats.
- InputPoint_X– Coordonnée x de la valeur de paramètre Entités ponctuelles en entrée dans la référence spatiale de la classe d’entités ponctuelles.
- InputPoint_Y– Coordonnée y de la valeur de paramètre Entités ponctuelles en entrée dans la référence spatiale de la classe d’entités ponctuelles.
- Street_X– Coordonnée x de l’emplacement ponctuel en entrée sur la rue associée pour la valeur de paramètre Entités Rue dans la référence spatiale de la classe d’entités ponctuelles.
- Street_Y– Coordonnée y de l’emplacement ponctuel en entrée sur la rue associée pour la valeur de paramètre Entités Rue dans la référence spatiale de la classe d’entités ponctuelles.
- Street_Side– Côté de la rue où se trouve le point en entrée par rapport à la direction de la numérisation de l’entité. Cette valeur n'est pas relative à la direction du déplacement dans la rue. Cet attribut aura une des valeurs suivantes :
- L : le point est associé au côté gauche de la rue.
- R : le point est associé au côté droit de la rue.
- NULL : le point n’est pas associé à une rue.
- Street_MatchReason : indique comment les valeurs de paramètre Entités ponctuelles en entrée ont été associées ou appariées aux valeurs de paramètre Entités rue après exécution de l’outil. L’attribut peut avoir une des valeurs suivantes :
- Match_FullStAddr_AddNum : tous les composants d’adresse ont été utilisés pour mettre en correspondance le point avec la rue et le numéro de résidence figurait dans la plage de numéros de résidence de la rue associée.
- Match_FullStAddr : tous les composants de l’adresse de la rue ont été utilisés pour mettre en correspondance le point avec la rue.
- Match_Enhanced_AddNum : tous les composants de l’adresse postale ainsi que le numéro d’habitation ont été utilisés pour apparier le point à la rue.
- Match_StName_AddNum : seul le composant du nom de rue était utilisé pour associer le point à la rue, et le numéro de résidence était dans la plage des numéros de résidence de la rue associée.
- Match_StName : seul le composant du nom de rue était utilisé pour associer le point à la rue.
- Match_Distance_AddNum : la distance a été utilisée pour associer le point à la rue, car les composants de nom de rue entre les points et les rues ne correspondaient pas, mais le numéro de résidence se trouvait dans la plage des numéros de résidence de la rue associée.
- Match_Distance : la distance a été utilisée pour associer le point à la rue, car les valeurs de nom de rue entre les points et les rues ne correspondaient pas.
- Unmatched : le point ne correspondait pas à la rue en fonction de la distance ou des composants d’adresse.
Remarque :
Lorsque le point ne correspond pas à la rue, les champs de sortie par défaut et les champs de rue sélectionnés ont des attributs NULL, mais les champs InputPoint_X et InputPoint_Y sont complétés par les coordonnées de la classe d’entités ponctuelles en entrée.
- Street_Distance : la distance en mètres entre le point en entrée et l’emplacement le plus proche sur la rue associée.
- Street_ObjectID– ID objet du segment de rue depuis la valeur de paramètre Entités Rue associée aux points en entrée.
Passez en revue les résultats depuis la valeur de paramètre Points en sortie lorsque la valeur pour le champ Street_MatchReason est Match_Distance_AddNum, Match_Distance ou Unmatched. Visualiser la manière dont les points sont associés à la rue dans la carte simplifie l’examen des résultats.
Cet outil prend en charge le traitement parallèle. Si l’environnement Facteur de traitement parallèle n’est pas défini (par défaut), le traitement parallèle est mis à l’échelle en fonction de la taille de la table et du nombre de cœurs logiques. Un seul processus est utilisé pour les jeux de données avec moins de 50 lignes.
Paramètres
arcpy.geocoding.AssignStreetsToPoints(in_point_features, point_field_mapping, in_street_features, street_field_mapping, out_points, {street_fields}, {distance}, {output_geometry}, {country_code}, {language_code})
Nom | Explication | Type de données |
in_point_features | Classe ou couche d’entités ponctuelles en entrée. | Feature Layer |
point_field_mapping [point_field_mapping,...] | Appariement des champs du composant d’adresse à partir des entités ponctuelles à utiliser pour comparer le nom complet de la rue par rapport au nom de la rue dans la valeur du paramètre in_street_features pour calculer le segment de rue auquel ce point est associé. Fournissez les noms de champs du composant d’adresse et les noms de champ de données depuis la valeur de paramètre in_point_features avec les composants d’adresse disponibles comme suit :
| Value Table |
in_street_features | Classe ou couche d’entités de rue en entrée à partir de laquelle les attributs sont affectés à la valeur de paramètre in_point_features. | Feature Layer |
street_field_mapping [street_field_mapping,...] | Appariement des champs du composant d’adresse à partir des entités Rue à utiliser pour comparer le nom complet de la rue par rapport au nom de la rue dans la valeur du paramètre in_point_features pour calculer le segment de rue auquel ce point est associé. Fournissez les noms de champs du composant d’adresse et les noms de champ de données depuis la valeur de paramètre in_street_features avec les composants d’adresse disponibles comme suit :
| Value Table |
out_points | Classe d’entités ponctuelles en sortie contenant les champs Rue affectés au point. | Feature Class |
street_fields [street_fields,...] (Facultatif) | Champs du paramètre in_street_features qui sont attribués à la valeur du paramètre out_points en entrée. Spécifiez les champs depuis les entités Rue en entrée qui contiennent des attributs à attribuer aux entités ponctuelles associées, par exemple un champ qui contient une valeur ID de rue. Les champs sont ajoutés à la valeur de paramètre out_points. | Field |
distance (Facultatif) | Distance utilisée pour trouver l’entité Rue la plus proche de l’entité ponctuelle. Plus la limite de la distance est élevée, plus l’outil met du temps à s’exécuter, mais la qualité des correspondances s’améliore. La valeur par défaut est 100 mètres. | Double |
output_geometry (Facultatif) | Spécifie la géométrie incluse dans la classe d’entités ponctuelles en sortie.
| String |
country_code (Facultatif) | Indique le lieu d’application de la logique propre à un pays sur les données en entrée pour attribuer des attributs de segment de rue aux entités ponctuelles. Il peut être spécifié à l’aide de l’option AS_DEFINED_IN_DATA et en associant une valeur des paramètres in_point_features et in_street_features à la fois dans les paramètres point_field_mapping et street_field_mapping. Il est également possible de l’appliquer à l’ensemble du jeu de données en spécifiant un nom de code de pays à trois caractères.
| String |
language_code (Facultatif) | Indique le lieu d’application de la logique propre à une langue sur les données en entrée pour attribuer des attributs de segment de rue aux entités ponctuelles. Il peut être spécifié à l’aide de l’option AS_DEFINED_IN_DATA et en associant une valeur des paramètres in_point_features et in_street_features à la fois dans les paramètres point_field_mapping et street_field_mapping. Il est également possible de l’appliquer à l’ensemble du jeu de données en spécifiant une langue à l’aide du code de langue à trois caractères.
| String |
Exemple de code
Le script Python ci-dessous illustre l’utilisation de la fonction AssignStreetsToPoints.
import arcpy
# Point Address Data from Tutorial Data
in_point_features = r"C:\Data\SanMarcos.gdb\Address_Points"
point_field_mapping = "STREET_FULL_NAME ADDRESS"
# Street Address Data from Tutorial Data
in_street_features = r"C:\Data\SanMarcos.gdb\Address_Lines"
street_field_mapping = "HOUSE_NUMBER_FROM_LEFT L_ADDNUM_FROM;HOUSE_NUMBER_TO_LEFT L_ADDNUM_TO;HOUSE_NUMBER_FROM_RIGHT R_ADDNUM_FROM;HOUSE_NUMBER_TO_RIGHT R_ADDNUM_TO;STREET_PREFIX_DIR STPREDIR;STREET_NAME STNAME;STREET_SUFFIX_TYPE STSUFFIX;STREET_SUFFIX_DIR STPOSTDIR"
output_data_path = r"C:\Data\SanMarcos.gdb\Street_Points"
arcpy.geocoding.AssignStreetsToPoints(
in_point_features,
point_field_mapping,
in_street_features,
street_field_mapping,
output_data_path,
street_fields=None,
distance=70,
output_geometry="STREET_POINT_GEOMETRY"
)
Environnements
Vous avez un commentaire à formuler concernant cette rubrique ?