| Beschriftung | Erläuterung | Datentyp |
Eingabe-Punkt-Features | Eingabe-Point-Feature-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:
Folgende Adressenkomponentenfelder sind verfügbar:
| 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 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:
| 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.
| String |
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
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 Werkzeug Straß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.
- Street_ObjectID: Die Objekt-ID des Straßensegments aus dem mit den Eingabepunkten verknüpften Parameterwert Straßen-Features.
Ü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
arcpy.geocoding.AssignStreetsToPoints(in_point_features, point_field_mapping, in_street_features, street_field_mapping, out_points, {street_fields}, {distance}, {output_geometry})| Name | Erläuterung | Datentyp |
in_point_features | Eingabe-Point-Feature-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:
| 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:
| 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 Parameterwert in_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.
| String |
Codebeispiel
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"
)