| É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 à 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 de 70 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 |
Synthèse
Utilise les informations sur les adresses, telles que les numéros d’habitation et les noms de rue, ainsi que la distance, pour trouver la meilleure entité de rue pour un point. 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.
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 améliorer la qualité, assurez-vous que les noms de rue et les composants d’adresse postale sont correctement orthographiés et mis en forme dans l’ensemble des classes d’entités de rue et ponctuelles en entrée.
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.
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 avec 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_MatchReasonIndique le mode d’association ou d’appariement des valeurs Input Point Features (Entités ponctuelles en entrée) aux valeurs 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_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_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})| 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 de 70 mètres. | Double |
output_geometry (Facultatif) | Indique la géométrie incluse dans la classe d’entités ponctuelles en sortie.
| 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
Vous avez un commentaire à formuler concernant cette rubrique ?