É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 à 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 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 70 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 |
Synthèse
Utilisez les informations d’adresse, telles que les numéros d’habitation et les noms de rue, ainsi que la distance, pour associer le meilleur candidat d’entité rue à 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. 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.
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 Attribuer des rues à des points.
Pour une qualité optimale, veillez à ce que les noms de rue et les composants d’adresse soient correctement orthographiés et mis en forme dans les classes d’entités ponctuelles et Rue en entrée.
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.
Pour aider les processus de calcul d’itinéraire, la sortie propose un indicateur à côté de la rue où se situe 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 depuis les entités ponctuelles en entrée avec les attributs provenant des champs spécifiés avec la valeur de paramètre Champ(s) Rues 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 Entités ponctuelles en entrée ont été associées ou mises en correspondance avec les valeurs 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_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_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})
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 70 mètres. | Double |
output_geometry (Facultatif) | Spécifie la géométrie incluse dans la classe d’entités ponctuelles en sortie.
| 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
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?