Attribuer des rues à des points (Géocodage)

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

Illustration de l’outil Assign Streets To Points (Attribuer des rues à des points)
L’outil Assign Streets To Points (Attribuer des rues à des points) lie les adresses des points à des entités de rue en comparant le nom de la rue du point aux entités de rue, ainsi que la distance entre eux.

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.

  • 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

ÉtiquetteExplicationType 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 :

  • Sélectionnez le composant d’adresse depuis la liste déroulante dans la colonne Nom de champ.
  • Sous la colonne Champ de données, sélectionnez le champ depuis la classe d’entités ponctuelles qui contient le composant d’adresse correspondant depuis la liste déroulante.

Les champs disponibles du composant d’adresse sont les suivants :

  • Direction préfixe rue : direction qui précède le nom de la rue, par exemple W dans W. Redlands Blvd.
  • Type de préfixe de rue : type de rue qui précède le nom de la rue, par exemple Avenue dans Avenue B.
  • Nom de rue : nom de la rue, par exemple Cherry dans Cherry Rd.
  • Type de rue : type de rue qui suit le nom de cette rue, par exemple St. dans New York St.
  • Direction de la rue : direction qui suit le nom de la rue, par exemple NW dans Bridge St. NW.
  • Nom complet de la rue : nom de rue complet de l’adresse, comme S. Orange St.
  • Numéro de résidence : numéro de résidence associé à une adresse, tel que 380 dans 380 New York St.
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 le composant d’adresse depuis la liste déroulante dans la colonne Nom de champ.
  • Sous la colonne Champ de données, sélectionnez le champ depuis la classe d’entités Rue qui contient le composant d’adresse correspondant depuis la liste déroulante.

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 :

  • Direction préfixe rue : direction qui précède le nom de la rue, par exemple W dans W. Redlands Blvd.
  • Type de préfixe de rue : type de rue qui précède le nom de la rue, par exemple Avenue dans Avenue B.
  • Nom de rue : nom de la rue, par exemple Cherry dans Cherry Rd.
  • Type de rue : type de rue qui suit le nom de cette rue, par exemple St. dans New York St.
  • Direction de la rue : direction qui suit le nom de la rue, par exemple NW dans Bridge St. NW.
  • Nom complet de la rue : nom de rue complet de l’adresse, comme S. Orange St.
  • Numéro d’habitation de début (gauche) : valeur représentant le numéro de début d’une plage de numéros de résidence à gauche de la rue.
  • Numéro d’habitation de fin (gauche) : valeur représentant le numéro de début d’une plage de numéros de résidence à gauche de la rue.
  • Numéro d’habitation de début (droite) : valeur représentant le numéro de début d’une plage de numéros de résidence à droite de la rue.
  • Numéro d’habitation de fin (droite) : valeur représentant le numéro de début d’une plage de numéros de résidence à droite de la rue.
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.

  • Géométrie ponctuelle en entréeLa géométrie pour la classe d’entités ponctuelles en entrée d’origine est incluse dans la classe d’entités ponctuelles en sortie.
  • Géométrie ponctuelle RueLa géométrie pour l’emplacement de la rue du point associé est incluse dans la classe d’entités ponctuelles en sortie.
String

arcpy.geocoding.AssignStreetsToPoints(in_point_features, point_field_mapping, in_street_features, street_field_mapping, out_points, {street_fields}, {distance}, {output_geometry})
NomExplicationType 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 :

  • STREET_PREFIX_DIR :  direction qui précède le nom de la rue, par exemple W dans W. Redlands Blvd.
  • STREET_PREFIX_TYPE : type de rue qui précède le nom de la rue, par exemple Avenue dans Avenue B.
  • STREET_NAME : nom de la rue, par exemple Cherry dans Cherry Rd.
  • STREET_SUFFIX_TYPE : type de rue qui suit le nom de cette rue, par exemple St. dans New York St.
  • STREET_SUFFIX_DIR : direction qui suit le nom de la rue, par exemple NW dans Bridge St. NW.
  • STREET_FULL_NAME : nom de rue complet de l’adresse, comme S. Orange St.
  • HOUSE_NUMBER : numéro de résidence associé à une adresse, tel que 380 dans 380 New York St.

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 :

  • STREET_PREFIX_DIR :  direction qui précède le nom de la rue, par exemple W dans W. Redlands Blvd.
  • STREET_PREFIX_TYPE : type de rue qui précède le nom de la rue, par exemple Avenue dans Avenue B.
  • STREET_NAME : nom de la rue, par exemple Cherry dans Cherry Rd.
  • STREET_SUFFIX_TYPE : type de rue qui suit le nom de cette rue, par exemple St. dans New York St.
  • STREET_SUFFIX_DIR : direction qui suit le nom de la rue, par exemple NW dans Bridge St. NW.
  • STREET_FULL_NAME : nom de rue complet de l’adresse, comme S. Orange St.
  • HOUSE_NUMBER_FROM_LEFT : valeur représentant le numéro de début d’une plage de numéros de résidence à gauche de la rue.
  • HOUSE_NUMBER_TO_LEFT : valeur représentant le numéro de fin d’une plage de numéros de résidence à gauche de la rue.
  • HOUSE_NUMBER_FROM_RIGHT : valeur représentant le numéro de début d’une plage de numéros de résidence à droite de la rue.
  • HOUSE_NUMBER_TO_RIGHT : valeur représentant le numéro de fin d’une plage de numéros de résidence à droite de la rue.
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.

  • INPUT_POINT_GEOMETRYLa géométrie pour la classe d’entités ponctuelles en entrée d’origine est incluse dans la classe d’entités ponctuelles en sortie.
  • STREET_POINT_GEOMETRYLa géométrie pour l’emplacement de la rue du point associé est incluse dans la classe d’entités ponctuelles en sortie.
String

Exemple de code

Exemple AssignStreetsToPoints (script autonome)

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"
)

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes