| Étiquette | Explication | Type de données |
Entités points en entrée | Classe ou couche d’entités ponctuelles en entrée. | Feature Layer |
Appariement des champs de point | Appariement des champs des composants d’adresse postale à partir des entités ponctuelles permettant de comparer le nom complet de la rue au nom complet de la rue dans la valeur de paramètre Street Features (Entités rue) pour calculer le segment de rue auquel le point est associé. Pour sélectionner des composants d’adresse dans la valeur de paramètre Input Point Features (Entités ponctuelles en entrée) à utiliser pour associer le point à la rue, procédez comme suit :
Les champs disponibles pour les composants d’adresse sont les suivants :
| Value Table |
Entités rue | Couche ou classe d’entités de rue en entrée à partir de laquelle les attributs sont affectés à la valeur de paramètre Input Point Features (Entités ponctuelles en entrée). | Feature Layer |
Appariement des champs de rue | Appariement des champs des composants d’adresse postale, de ville, d’état, de code de pays et de 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 Input Point Features (Entités ponctuelles en entrée) pour calculer le segment de rue auquel ce point est associé. Pour sélectionner des composants d’adresse dans la valeur de paramètre Street Features (Entités rue) à utiliser pour associer le point à la rue, procédez comme suit :
Dans la classe d’entités de rue, dans la liste déroulante Data Field (Champ de données), sélectionnez un champ qui correspond au composant d’adresse postale indiqué dans la colonne Field Name (Nom de champ). Les champs disponibles pour les composants d’adresse sont les suivants :
| Value Table |
Points en sortie | Classe d’entités ponctuelles en sortie contenant les entités de rue affectées au point. | Feature Class |
Champ(s) de rue (Facultatif) | Champs de la valeur de paramètre Street Features (Entités rue) affectés à la valeur de paramètre Output Points (Points en sortie). Dans les entités de rue en entrée, sélectionnez les champs qui contiennent les attributs à affecter aux entités ponctuelles associées (par exemple, un champ contenant une valeur d’ID de rue). Les champs sélectionnés sont ajoutés à la valeur de paramètre Output Points (Points en sortie). | Field |
Distance (Facultatif) | Distance permettant de rechercher l’entité de rue la plus proche de l’entité ponctuelle. Plus la distance limite est élevée, plus la durée d’exécution de l’outil est importante, mais la qualité des correspondances augmente. La valeur par défaut est 100 mètres. | Double |
Géométrie en sortie (Facultatif) | Indique la géométrie incluse dans la classe d’entités ponctuelles en sortie.
| String |
Pays ou région (Facultatif) | Indique là où la logique propre à un pays doit s’appliquer aux données en entrée pour l’affectation d’attributs de segment de rue à des entités ponctuelles. La valeur par défaut correspond au paramètre régional du système d’exploitation. Elle peut être indiquée à l’aide de l’option <As defined in data> (<Comme défini dans les données>) et en appariant une valeur des paramètres Input Point Features (Entités ponctuelles en entrée) et Street Features (Entités rue) dans les paramètres Point Field Mapping (Appariement des champs de point) et Street Field Mapping (Appariement des champs de rue). Elle peut être également appliquée à l’ensemble du jeu de données en spécifiant une option de pays.
| String |
Code de la langue (Facultatif) | Indique là où la logique propre à une langue doit s’appliquer aux données en entrée pour l’affectation d’attributs de segment de rue à des entités ponctuelles. La valeur par défaut correspond au paramètre régional du système d’exploitation. Elle peut être indiquée à l’aide de l’option <As defined in data> (<Comme défini dans les données>) et en appariant une valeur des paramètres Input Point Features (Entités ponctuelles en entrée) et Street Features (Entités rue) dans les paramètres Point Field Mapping (Appariement des champs de point) et Street Field Mapping (Appariement des champs de rue). Elle peut être également appliquée à l’ensemble du jeu de données en spécifiant une option de langue.
| String |
Synthèse
Recherche l’entité de rue étant la meilleure candidate pour un point en utilisant des informations sur les adresses, telles que les numéros de maison 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. L’association est effectuée en comparant les informations sur les adressses du point et les entités de rue, ainsi que la distance qui les sépare. Le meilleur candidat est celui qui présente le plus de similarités entre les noms et qui se trouve à proximité. Une fois que l’association est établie, l’ID d’objet de rue, un côté de rue et un nouveau point proche de la rue peuvent être générés pour l’adresse de point. D’autres attributs peuvent également être transférés entre la rue et l’adresse du point. Parmi les cas d’utilisation de cet outil, notons l’ajout d’attributs de rues à des adresses de point et vice versa, la génération de points se trouvant à proximité de la même rue nommée et pouvant alors 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 leur entité de rues associée.
Pour plus d’informations, reportez-vous à la rubrique Attribuer des rues à des points en fonction de leur nom et de leur proximité.
Illustration
Utilisation
Cet outil accepte en entrée les classes d’entités ponctuelles et linéaires en une seule partie.
Il peut faciliter l’affectation d’un ID de jointure pour les noms secondaires entre les données de référence des rues et les données de référence ponctuelles afin que les deux jeux de données possèdent le même ID de jointure pour s’associer à la table des noms de rue secondaires.
Utilisez cet outil pour enregistrer les coordonnées du point correspondant sur la rue afin d’utiliser la propriété Preferred Location (Emplacement préféré) pour le localisateur si la géométrie de l’entité ponctuelle en entrée se trouve sur le centroïde du toit ou de la parcelle.
Cet outil fonctionne de manière optimale si les classes d’entités ponctuelles et linéaires en entrée sont stockées dans une géodatabase et que la sortie est enregistrée dans une géodatabase.
Pour les valeurs de paramètre Point Field Mapping (Appariement des champs de point) et Street Field Mapping (Appariement des champs de rue), utilisez l’outil Split Address Into Components (Fractionner des adresses en composants) sur les deux jeux de données, puis utilisez les résultats en sortie de cet outil pour les valeurs de paramètre Input Point Features (Entités ponctuelles en entrée) et Street Features (Entités rue) de l’outil Assign Streets To Points (Attribuer des rues à des points) pour obtenir des attributions de rues optimisées.
Pour un appariement totalement optimisé, veillez à apparier les champs de ville, d’état, de code pays et de code de langue pour les valeurs de paramètre Point Field Mapping (Appariement des champs de point) et Street Field Mapping (Appariement des champs de rue). Pour un appariement en partie optimisé, veillez à apparier les champs de code de pays et de code de langue ou à indiquer le pays et la langue dans les paramètres Country or Region (Pays ou région) et Language Code (Code de langue), respectivement.
Pour améliorer la qualité, veillez à spécifier les champs de numéro de maison et de nom de rue dans les classes d’entités de rue et ponctuelles en entrée pour les valeurs de paramètre Point Field Mapping (Appariement des champs de point) et Street Field Mapping (Appariement des champs de rue).
Pour faciliter les processus d’acheminement, la sortie fournit un indicateur du côté de la rue où se situe le point. L’utilisation de cet indicateur lors de la génération d’un localisateur permet à ce dernier d’afficher les résultats sur le côté correct de la rue.
La sortie est une copie de tous les attributs et entités des entités ponctuelles en entrée avec des attributs des champs spécifiés pour la valeur de paramètre Street Field(s) (Champ(s) de rue) ajoutée au point de la rue associée. Elle peut inclure un champ d’ID de rue de la classe d’entités de rue en entrée.
La sortie inclut les champs suivants par défaut :
- Street_ObjectID— ID d’objet du segment de rue à partir de la valeur de paramètre Street Features (Entités rue) associée aux points en entrée.
Remarque :
Si la classe d’entités de rue en entrée contient un champ avec un ID de rue, sélectionnez ce champ comme valeur de paramètre Street Field(s) (Champ(s) de rue) pouvant être utilisée lors de la vérification des résultats.
- InputPoint_X— Coordonnée X de la valeur de paramètre Input Point Features (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 Input Point Features (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 la localisation du point en entrée sur la rue associée pour la valeur de paramètre Street Features (Entités rue) dans la référence spatiale de la classe d’entités ponctuelles.
- Street_Y— Coordonnée Y de la localisation du point en entrée sur la rue associée pour la valeur de paramètre Street Features (Entités rue) dans la référence spatiale de la classe d’entités ponctuelles.
- Street_SideCôté de la rue du 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 possède l’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 le mode d’association ou d’appariement des valeurs de paramètre Input Point Features (Entités ponctuelles en entrée) aux valeurs de paramètre Street Features (Entités rue) une fois que l’outil a été exécuté. L’attribut peut posséder l’une des valeurs suivantes :
- Match_FullStAddr_AddNum : tous les composants d’adresse postale ont été utilisés pour apparier le point à la rue et le numéro d’habitation se trouve dans la plage des numéros d’habitation de la rue associée.
- Match_FullStAddr : tous les composants d’adresse postale ont été utilisés pour apparier le point à la rue.
- Match_Enhanced_AddNum : tous les composants d’adresse postale et le numéro de maison ont été utilisés pour apparier le point à la rue.
- Match_StName_AddNum : seul le composant de nom de rue a été utilisé pour associer le point à la rue et le numéro d’habitation se trouve dans la plage des numéros d’habitation de la rue associée.
- Match_StName : seul le composant de nom de rue a été utilisé pour apparier 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 correspondent pas, mais le numéro d’habitation se trouve dans la plage des numéros d’habitation 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 correspondent pas.
- Unmatched : le point n’a pas été apparié à la rue en fonction de la distance ou des composants d’adresse postale.
Remarque :
Si le point n’est pas apparié à la rue, les champs en sortie par défaut et les champs de rue sélectionnés possèdent des attributs NULL, mais les champs InputPoint_X et InputPoint_Y sont renseignés avec 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 d’objet du segment de rue à partir de la valeur de paramètre Street Features (Entités rue) associée aux points en entrée.
Vérifiez les résultats de la valeur de paramètre Output Points (Points en sortie) si la valeur du champ Street_MatchReason est Match_Distance_AddNum, Match_Distance ou Unmatched. La visualisation du mode d’association des points à la rue sur la carte facilite la vérification des résultts.
Cet outil prend en charge le traitement parallèle. Si l’environnement Parallel Processing Factor (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 de 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 des composants d’adresse postale à partir des entités ponctuelles permettant de comparer le nom complet de la rue au nom complet de la rue dans la valeur de paramètre in_street_features pour calculer le segment de rue auquel le point est associé. Spécifiez les noms de champ des composants d’adresse postale et les noms des champs de données à partir de la valeur de paramètre in_point_features à l’aide des composants d’adresse disponibles, comme suit :
| Value Table |
in_street_features | Couche ou classe 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 des composants d’adresse postale à 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 in_point_features pour calculer le segment de rue auquel ce point est associé. Spécifiez les noms de champ des composants d’adresse postale et les noms des champs de données à partir de la valeur de paramètre in_street_features à l’aide des composants d’adresse disponibles, comme suit :
| Value Table |
out_points | Classe d’entités ponctuelles en sortie contenant les entités de rue affectées au point. | Feature Class |
street_fields [street_fields,...] (Facultatif) | Champs de la valeur de paramètre in_street_features affectés à la valeur de paramètre out_points. Dans les entités de rue en entrée, spécifiez les champs qui contiennent les attributs à affecter aux entités ponctuelles associées (par exemple, un champ contenant une valeur d’ID de rue). Ces champs sont ajoutés à la valeur de paramètre out_points. | Field |
distance (Facultatif) | Distance permettant de rechercher l’entité de rue la plus proche de l’entité ponctuelle. Plus la distance limite est élevée, plus la durée d’exécution de l’outil est importante, mais la qualité des correspondances augmente. La valeur par défaut est 100 mètres. | Double |
output_geometry (Facultatif) | Indique la géométrie incluse dans la classe d’entités ponctuelles en sortie.
| String |
country_code (Facultatif) | Indique là où la logique propre à un pays doit s’appliquer aux données en entrée pour l’affectation d’attributs de segment de rue à des entités ponctuelles. Elle peut être indiquée à l’aide de l’option AS_DEFINED_IN_DATA et en appariant une valeur des paramètres in_point_features et in_street_features dans les paramètres point_field_mapping et street_field_mapping. Elle peut être également appliquée à l’ensemble du jeu de données en spécifiant une option de pays.
| String |
language_code (Facultatif) | Indique là où la logique propre à une langue doit s’appliquer aux données en entrée pour l’affectation d’attributs de segment de rue à des entités ponctuelles. Elle peut être indiquée à l’aide de l’option AS_DEFINED_IN_DATA et en appariant une valeur des paramètres in_point_features et in_street_features dans les paramètres point_field_mapping et street_field_mapping. Elle peut être également appliquée à 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 suivant 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
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?