Straßen den Punkten zuweisen (Geocoding)

Zusammenfassung

Mithilfe von Adresseninformationen wie z. B. Straßennamen, Hausnummern und auch Entfernungen wird nach dem besten Straßen-Feature-Kandidaten für einen Punkt gesucht. Adresseninformationen erhalten Vorrang vor der Entfernung.

Mit diesem Werkzeug lassen sich Punkt-Adressen mit Straßendaten verknüpfen. Die Verknüpfung wird hergestellt, indem die Adressinformationen des Punktes mit denen der Straßen-Features und der Entfernung zwischen ihnen verglichen werden. Der beste Kandidat weist die größte Ähnlichkeit zwischen den Namen auf und befindet sich in unmittelbarer Nähe. Sobald die Verknüpfung hergestellt ist, können die Straßen-Objekt-ID, die Straßenseite und ein neuer Punkt in der Nähe der Straße für die Punktadresse erstellt werden. Darüber hinaus können weitere Attribute von der Straße auf die Punktadresse übertragen werden. Zu den Anwendungsfällen dieses Werkzeugs zählen das Anhängen von Attributen von Straßen an Punktadressen oder umgekehrt, das Generieren von Punkten, die neben der Straße mit demselben Namen liegen, die dann als Routenposition verwendet werden können, oder das Erstellen von Ishikawa-Diagrammen, in denen die Beziehung zwischen Punktadressen und dem mit ihnen verbundenen Straßen-Feature dargestellt wird.

Weitere Informationen finden Sie unter Straßen basierend auf Straßennamen und Nähe den Punkten zuweisen.

Abbildung

Abbildung des Werkzeugs "Straßen den Punkten zuweisen"
Das Werkzeug "Straßen den Punkten zuweisen" verknüpft Punktadressen mit Straßen-Features, indem es die Straßennamen der Punkt- und Straßen-Features sowie die Entfernung zwischen ihnen vergleicht.

Verwendung

  • Dieses Werkzeug unterstützt Singlepart-Point- und Line-Feature-Classes als Eingabe.

  • Mithilfe dieses Werkzeugs lässt sich eine Join-ID für alternative Namen aus den Referenzdaten der Straßen den Referenzdaten des Punktes zuweisen, sodass beide Datasets dieselbe Join-ID haben, die mit der Tabelle mit alternativen Straßennamen verknüpft werden kann.

  • Dieses Werkzeug erzielt die besten Ergebnisse, wenn die Eingabe-Point- und Line-Feature-Classes in einer Geodatabase gespeichert werden und die Ausgabe ebenfalls in einer Geodatabase gespeichert wird.

  • Führen Sie für die Parameterwerte Punkt-Feldzuordnung und Straßen-Feldzuordnung das Werkzeug Adressen in Komponenten teilen für beide Datasets aus, und verwenden Sie die Ausgabeergebnisse aus diesem Werkzeug für die Parameterwerte Eingabe-Punkt-Features und Straßen-Features für das WerkzeugStraßen den Punkten zuweisen.

  • Stellen Sie zur Verbesserung der Qualität sicher, dass die Straßennamen und Komponenten der Straßenadresse in sämtlichen Eingabe-Punkt- und -Straßen-Feature-Classes einheitlich geschrieben und formatiert sind.

  • Speichern Sie mithilfe dieses Werkzeugs die Koordinaten des entsprechenden Punktes auf der Straße, um mit der Eigenschaft Bevorzugte Position für den Locator zu arbeiten, wenn die Eingabe-Punkt-Feature-Geometrie auf dem Dach oder dem Flurstücksschwerpunkt liegt.

  • Zur Unterstützung der Routing-Workflows bietet die Ausgabe einen Indikator für die Straßenseite, auf der sich der Punkt befindet. Wenn Sie beim Erstellen eines Locators diesen indikator verwenden, kann der Locator die Ergebnisse auf der richtigen Straßenseite anzeigen.

  • Bei der Ausgabe handelt es sich um eine Kopie aller Features und Attribute aus den Eingabe-Punkt-Features mit Attributen aus den Feldern, die mit dem Parameterwert Straßenfeld(er) festgelegt werden, der an den Punkt der verknüpften Straße angehängt ist. Dies kann z. B. ein Straßen-ID-Feld aus der Eingabe-Straßen-Feature-Class sein.

  • Die Ausgabe enthält standardmäßig die folgenden Felder:

    • Street_ObjectID: Die Objekt-ID des Straßensegments aus dem mit den Eingabepunkten verknüpften Parameterwert Straßen-Features.
      Hinweis:

      Wenn die Eingabe-Straßen-Feature-Class ein Feld mit einer Straßen-ID enthält, wählen Sie dieses Feld als Parameterwert Straßenfeld(er) aus, der beim Überprüfen der Ergebnisse verwendet werden kann.

    • InputPoint_X: Die X-Koordinate des Parameterwerts Eingabe-Punkt-Features im Raumbezug der Point-Feature-Class.
    • InputPoint_Y: Die Y-Koordinate des Parameterwerts Eingabe-Punkt-Features im Raumbezug der Point-Feature-Class.
    • Street_X: Die X-Koordinate der Eingabe-Punktposition auf der verknüpften Straße für den Parameterwert Straßen-Features im Raumbezug der Point-Feature-Class.
    • Street_Y: Die Y-Koordinate der Eingabe-Punktposition auf der verknüpften Straße für den Parameterwert Straßen-Features im Raumbezug der Point-Feature-Class.
    • Street_Side: Die Straßenseite, auf der sich ein Eingabepunkt befindet, relativ zur Digitalisierungsrichtung des Features. Dieser Wert ist nicht relativ zur Fahrtrichtung entlang der Straße. Dieses Attribut weist einen der folgenden Werte auf:
      • L: Der Punkt ist mit der linken Straßenseite verknüpft.
      • R: Der Punkt ist mit der rechten Straßenseite verknüpft.
      • NULL: Der Punkt ist mit keiner Straße verknüpft.
    • Street_MatchReason: Gibt an, wie die Eingabe-Punkt-Features nach Ausführung des Werkzeugs mit den Straßen-Features verknüpft oder ihnen zugeordnet waren. Das Attribut kann einen der folgenden Werte aufweisen:
      • Match_FullStAddr_AddNum: Alle Adressenkomponenten der Straße wurden verwendet, um den Punkt der Straße zuzuordnen, und die Hausnummer lag innerhalb des Hausnummernbereichs der verknüpften Straße.
      • Match_FullStAddr: Alle Adressenkomponenten der Straße wurden verwendet, um den Punkt der Straße zuzuordnen.
      • Match_StName_AddNum: Nur die Namenskomponente der Straße wurde verwendet, um den Punkt mit der Straße zu verknüpfen, und die Hausnummer lag innerhalb des Hausnummernbereichs der verknüpften Straße.
      • Match_StName: Nur die Namenskomponente der Straße wurde verwendet, um den Punkt mit der Straße zu verknüpfen.
      • Match_Distance_AddNum: Die Entfernung wurde verwendet, um den Punkt mit der Straße zu verknüpfen, da die Namenskomponenten der Straße zwischen den Punkten und Straßen nicht übereinstimmten, aber die Hausnummer lag innerhalb des Hausnummernbereichs der verknüpften Straße.
      • Match_Distance: Die Entfernung wurde verwendet, um den Punkt mit der Straße zu verknüpfen, da die Straßennamen zwischen den Punkten und Straßen nicht übereinstimmten.
      • Unmatched: Der Punkt war der Straße basierend auf der Entfernung oder der Adressenkomponente der Straße nicht zugeordnet.
        Hinweis:

        Wenn der Punkt der Straße nicht zugeordnet ist, haben die Standard-Ausgabefelder und die ausgewählten Straßenfelder NULL Attribute, aber die Felder InputPoint_X und InputPoint_Y werden mit den Koordinaten der Eingabe-Punkt-Feature-Class befüllt.

  • Überprüfen Sie die Ergebnisse des Parameterwerts Ausgabepunkte, wenn der Wert des Felds Street_MatchReason Match_Distance_AddNum, Match_Distance oder Unmatched lautet. Das Visualisieren der Verknüpfung der Punkte mit der Straße in der Karte erleichtert das Überprüfen der Ergebnisse.

  • Dieses Werkzeug unterstützt die parallele Verarbeitung. Wenn die Umgebung Faktor für parallele Verarbeitung nicht festgelegt ist (Standardeinstellung), wird die parallele Verarbeitung auf der Grundlage der Größe der Tabelle und der Anzahl der logischen Kerne skaliert. Bei Datasets mit weniger als 50 Zeilen wird nur ein Prozess verwendet.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Punkt-Features

Eingabe-Punkt-Layer-Class oder -Layer.

Feature Layer
Punkt-Feldzuordnung

Die Zuordnung der Adressenkomponentenfelder der Straße aus den Punkt-Features, die zum Vergleichen des vollständigen Straßennamens mit dem vollständigen Straßennamen im Parameterwert Straßen-Features verwendet wird, um das Straßensegment zu berechnen, mit dem der Punkt verknüpft ist.

Gehen Sie wie folgt vor, um Adressenkomponenten aus dem Parameterwert Eingabe-Punkt-Features auszuwählen, der zum Verknüpfen des Punktes mit der Straße verwendet wird:

  • Wählen Sie die Adressenkomponenten aus der Dropdown-Liste in der Spalte Feldname aus.
  • Wählen Sie aus der Spalte Datenfeld das Feld aus der Point-Feature-Class aus, die die entsprechende Adressenkomponente aus der Dropdown-Liste enthält.

Folgende Adressenkomponentenfelder sind verfügbar:

  • Richtungspräfix der Straße: Eine Richtung, die vor dem Straßennamen steht, wie z. B. das W in "W. Redlands Blvd"
  • Richtungstyp der Straße: Eine Straßenart, die vor dem Straßennamen steht, etwa Avenue in "Avenue B"
  • Straßenname: Der Name der Straße, z. B. Cherry in "Cherry Rd."
  • Straßentyp: Eine Straßenart, die hinter dem Straßennamen steht, z. B. St. in "New York St."
  • Straßenrichtung: Eine Richtung, die hinter dem Straßennamen steht, z. B. das NW in "Bridge St. NW"
  • Vollständiger Straßenname: Der vollständige Straßenname der Adresse, wie z. B. "S. Orange St.".
  • Hausnummer: Die mit einer Adresse verbundene Hausnummer, wie z. B. 380 in -"380 New York St.".
Value Table
Straßen-Features

Die Eingabe-Straßen-Feature-Class oder der Eingabe-Straßen-Feature-Layer, aus der bzw. dem Attribute dem Parameterwert Eingabe-Punkt-Features zugewiesen werden.

Feature Layer
Straßen-Feldzuordnung

Die Zuordnung der Adressenkomponentenfelder der Straße aus den Straßen-Features, die zum Vergleichen des vollständigen Straßennamens mit dem vollständigen Straßennamen im Parameterwert Eingabe-Punkt-Features verwendet wird, um das Straßensegment zu berechnen, mit dem der Punkt verknüpft ist.

Gehen Sie wie folgt vor, um Adressenkomponenten aus dem Parameterwert Straßen-Features auszuwählen, der zum Verknüpfen des Punktes mit der Straße verwendet wird:

  • Wählen Sie die Adressenkomponenten aus der Dropdown-Liste in der Spalte Feldname aus.
  • Wählen Sie aus der Spalte Datenfeld das Feld aus der Straßen-Feature-Class aus, die die entsprechende Adressenkomponente aus der Dropdown-Liste enthält.

Wählen Sie Felder aus der Straßen-Feature-Class in der Dropdown-Liste Datenfeld aus, die der in der Spalte Feldname aufgeführten Adressenkomponente der Straße entsprechen. Folgende Adressenkomponentenfelder sind verfügbar:

  • Richtungspräfix der Straße: Eine Richtung, die vor dem Straßennamen steht, wie z. B. das W in "W. Redlands Blvd"
  • Richtungstyp der Straße: Eine Straßenart, die vor dem Straßennamen steht, etwa Avenue in "Avenue B"
  • Straßenname: Der Name der Straße, z. B. Cherry in "Cherry Rd."
  • Straßentyp: Eine Straßenart, die hinter dem Straßennamen steht, z. B. St. in "New York St."
  • Straßenrichtung: Eine Richtung, die hinter dem Straßennamen steht, z. B. das NW in "Bridge St. NW"
  • Vollständiger Straßenname: Der vollständige Straßenname der Adresse, wie z. B. "S. Orange St.".
  • Hausnummer links ab: Ein Wert, der für die erste Zahl eines Hausnummernbereichs auf der linken Straßenseite steht.
  • Hausnummer links bis: Ein Wert, der für die letzte Zahl eines Hausnummernbereichs auf der linken Straßenseite steht.
  • Hausnummer rechts ab: Ein Wert, der für die erste Zahl eines Hausnummernbereichs auf der rechten Straßenseite steht.
  • Hausnummer rechts bis: Ein Wert, der für die letzte Zahl eines Hausnummernbereichs auf der rechten Straßenseite steht.
Value Table
Ausgabepunkte

Die Ausgabe-Punkt-Feature-Class, die die dem Punkt zugewiesenen Straßenfelder enthält.

Feature Class
Straßenfeld(er)
(optional)

Die Felder aus dem Parameterwert Straßen-Features werden dem Parameterwert Ausgabepunkte zugewiesen. Wählen Sie Felder aus den Eingabe-Straßen-Features aus, die Attribute enthalten, die den verknüpften Punkt-Features zugewiesen werden, z. B. ein Feld, das einen Straßen-ID-Wert enthält. Die ausgewählten Felder werden dem Parameterwert Ausgabepunkte hinzugefügt.

Field
Entfernung
(optional)

Die Entfernung, mit der das Straßen-Feature ermittelt wird, das dem Punkt-Feature am nächsten ist. Je höher das Entfernungslimit, umso länger dauert die Ausführung des Werkzeugs, aber die Übereinstimmungen haben eine höhere Qualität. Der Standardwert beträgt 70 Meter.

Double
Ausgabegeometrie
(optional)

Gibt die Geometrie an, die in der Ausgabe-Punkt-Feature-Class enthalten ist.

  • Geometrie des EingabepunktesDie Ausgabe-Punkt-Feature-Class enthält die Geometrie der ursprünglichen Eingabe-Punkt-Feature-Class.
  • Geometrie des StraßenpunktesDie Ausgabe-Punkt-Feature-Class enthält die Geometrie der Straßenposition des verknüpften Punktes.
String

arcpy.geocoding.AssignStreetsToPoints(in_point_features, point_field_mapping, in_street_features, street_field_mapping, out_points, {street_fields}, {distance}, {output_geometry})
NameErläuterungDatentyp
in_point_features

Eingabe-Punkt-Layer-Class oder -Layer.

Feature Layer
point_field_mapping
[point_field_mapping,...]

Die Zuordnung der Adressenkomponentenfelder der Straße aus den Punkt-Features, die zum Vergleichen des vollständigen Straßennamens mit dem vollständigen Straßennamen im Parameterwert in_street_features verwendet wird, um das Straßensegment zu berechnen, mit dem der Punkt verknüpft ist.

Geben Sie wie folgt die Adressenkomponenten-Feldnamen der Straße und die Datenfeldnamen aus dem Parameterwert in_point_features mithilfe der verfügbaren Adressenkomponenten an:

  • STREET_PREFIX_DIR: Eine Richtung, die vor dem Straßennamen steht, etwa das W in "W. Redlands Blvd."
  • STREET_PREFIX_TYPE: Eine Straßenart, die vor dem Straßennamen steht, etwa Avenue in "Avenue B"
  • STREET_NAME: Der Name der Straße, z. B. Cherry in "Cherry Rd."
  • STREET_SUFFIX_TYPE: Eine Straßenart, die hinter dem Straßennamen steht, z. B. St. in "New York St."
  • STREET_SUFFIX_DIR: Eine Richtung, die hinter dem Straßennamen steht, z. B. das NW in "Bridge St. NW"
  • STREET_FULL_NAME: Der vollständige Straßenname der Adresse, wie z. B. "S. Orange St.".
  • HOUSE_NUMBER: Die mit einer Adresse verbundene Hausnummer, wie z. B. 380 in -"380 New York St.".

Value Table
in_street_features

Die Eingabe-Straßen-Feature-Class oder der Eingabe-Straßen-Feature-Layer, aus der bzw. dem Attribute dem Parameterwert in_point_features zugewiesen werden.

Feature Layer
street_field_mapping
[street_field_mapping,...]

Die Zuordnung der Adressenkomponentenfelder der Straße aus den Straßen-Features, die zum Vergleichen des vollständigen Straßennamens mit dem vollständigen Straßennamen im Parameterwert in_point_features verwendet wird, um das Straßensegment zu berechnen, mit dem der Punkt verknüpft ist.

Geben Sie wie folgt die Adressenkomponenten-Feldnamen der Straße und die Datenfeldnamen aus dem Parameterwert in_street_features mithilfe der verfügbaren Adressenkomponenten an:

  • STREET_PREFIX_DIR: Eine Richtung, die vor dem Straßennamen steht, etwa das W in "W. Redlands Blvd."
  • STREET_PREFIX_TYPE: Eine Straßenart, die vor dem Straßennamen steht, etwa Avenue in "Avenue B"
  • STREET_NAME: Der Name der Straße, z. B. Cherry in "Cherry Rd."
  • STREET_SUFFIX_TYPE: Eine Straßenart, die hinter dem Straßennamen steht, z. B. St. in "New York St."
  • STREET_SUFFIX_DIR: Eine Richtung, die hinter dem Straßennamen steht, z. B. das NW in "Bridge St. NW"
  • STREET_FULL_NAME: Der vollständige Straßenname der Adresse, wie z. B. "S. Orange St.".
  • HOUSE_NUMBER_FROM_LEFT: Ein Wert, der für die erste Zahl eines Hausnummernbereichs auf der linken Straßenseite steht.
  • HOUSE_NUMBER_TO_LEFT: Ein Wert, der für die letzte Zahl eines Hausnummernbereichs auf der linken Straßenseite steht.
  • HOUSE_NUMBER_FROM_RIGHT: Ein Wert, der für die erste Zahl eines Hausnummernbereichs auf der rechten Straßenseite steht.
  • HOUSE_NUMBER_TO_RIGHT: Ein Wert, der für die letzte Zahl eines Hausnummernbereichs auf der rechten Straßenseite steht.
Value Table
out_points

Die Ausgabe-Punkt-Feature-Class, die die dem Punkt zugewiesenen Straßenfelder enthält.

Feature Class
street_fields
[street_fields,...]
(optional)

Die Felder aus dem Parameterwertin_street_features werden dem Parameterwert out_points zugewiesen. Geben Sie Felder aus den Eingabe-Straßen-Features an, die Attribute enthalten, die den verknüpften Punkt-Features zugewiesen werden, z. B. ein Feld, das einen Straßen-ID-Wert enthält. Die Felder werden dem Parameterwert out_points hinzugefügt.

Field
distance
(optional)

Die Entfernung, mit der das Straßen-Feature ermittelt wird, das dem Punkt-Feature am nächsten ist. Je höher das Entfernungslimit, umso länger dauert die Ausführung des Werkzeugs, aber die Übereinstimmungen haben eine höhere Qualität. Der Standardwert beträgt 70 Meter.

Double
output_geometry
(optional)

Gibt die Geometrie an, die in der Ausgabe-Punkt-Feature-Class enthalten ist.

  • INPUT_POINT_GEOMETRYDie Ausgabe-Punkt-Feature-Class enthält die Geometrie der ursprünglichen Eingabe-Punkt-Feature-Class.
  • STREET_POINT_GEOMETRYDie Ausgabe-Punkt-Feature-Class enthält die Geometrie der Straßenposition des verknüpften Punktes.
String

Codebeispiel

AssignStreetsToPoints: Beispiel (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion AssignStreetsToPoints verwendet wird.

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

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen