| 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 Felder mit dem Straßenadressenelement, dem Ort, dem Bundesstaat, dem Ländercode und dem Sprachcode 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-Point-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 100 Meter. | Double |
Ausgabegeometrie (optional) | Gibt die Geometrie an, die in der Ausgabe-Point-Feature-Class enthalten ist.
| String |
Land bzw. Region (optional) | Gibt an, ob landesspezifische Logik auf die Eingabedaten für die Zuweisung von Straßenabschnittsattributen zu Punkt-Features angewendet wird. Standardmäßig wird die regionale Einstellung des Betriebssystems verwendet. Sie können sie festlegen, indem Sie die Option <Wie in Daten angegeben> auswählen und einen Wert aus den Parametern Eingabe-Punkt-Features und Straßen-Features über die Parameter Punkt-Feldzuordnung und Straßen-Feldzuordnung zuordnen. Es ist auch möglich, sie durch die Angabe einer Länderoption auf das gesamte Dataset anzuwenden.
| String |
Sprachencode (optional) | Gibt an, ob sprachspezifische Logik auf die Eingabedaten für die Zuweisung von Straßenabschnittsattributen zu Punkt-Features angewendet wird. Standardmäßig wird die regionale Einstellung des Betriebssystems verwendet. Sie können sie festlegen, indem Sie die Option <Wie in Daten angegeben> auswählen und einen Wert aus den Parametern Eingabe-Punkt-Features und Straßen-Features über die Parameter Punkt-Feldzuordnung und Straßen-Feldzuordnung zuordnen. Es ist auch möglich, sie durch die Angabe einer Sprachoption auf das gesamte Dataset anzuwenden.
| String |
Zusammenfassung
Sucht nach dem besten Straßen-Feature-Kandidaten für einen Punkt mittels Adresseninformationen wie Hausnummern und Straßennamen sowie Entfernungen. 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.
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.
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 beide Datasets in den Parameterwerten Punkt-Feldzuordnung und Straßen-Feldzuordnung das Werkzeug Adressen in Komponenten teilen aus, und verwenden Sie die Ausgabeergebnisse aus diesem Werkzeug für die Parameterwerte Eingabe-Punkt-Features und Straßen-Features des Werkzeugs Straßen den Punkten zuweisen, um optimierte Straßenzuweisungen zu erhalten.
Stellen Sie sicher, dass die Felder für den Ort, Bundesstaat, Ländercode und Sprachcode den Werten in den Parametern Punkt-Feldzuordnung und Straßen-Feldzuordnung zugeordnet sind, um einen vollständig optimierten Abgleich zu ermöglichen. Achten Sie für einen teilweise optimierten Abgleich darauf, dass die Felder für den Ländercode und Sprachcode zugeordnet sind, oder geben Sie das Land im Parameter Land bzw. Region und die Sprache im Parameter Sprachcode an.
Stellen Sie zur Verbesserung der Qualität sicher, dass die Felder mit der Hausnummer und dem Straßennamen in den Eingabe-Point- und -Street-Feature-Classes für die Parameterwerte Punkt-Feldzuordnung und Straßen-Feldzuordnung angegeben wurden.
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 Werte des Parameters Eingabe-Punkt-Features nach Ausführung des Werkzeugs mit den Werten des Parameters Straßen-Features verknüpft bzw. ihnen zugeordnet wurden. 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_Enhanced_AddNum: Alle Straßenadressenelemente und die Hausnummer 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-Point-Feature-Class befüllt.
- Street_Distance: Die Entfernung in Metern vom Eingabepunkt zur nächstgelegenen Position auf der verknüpften Straße.
- 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}, {country_code}, {language_code})| 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-Point-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 100 Meter. | Double |
output_geometry (optional) | Gibt die Geometrie an, die in der Ausgabe-Point-Feature-Class enthalten ist.
| String |
country_code (optional) | Gibt an, ob landesspezifische Logik auf die Eingabedaten für die Zuweisung von Straßenabschnittsattributen zu Punkt-Features angewendet wird. Sie können sie festlegen, indem Sie die Option AS_DEFINED_IN_DATA auswählen und einen Wert aus den Parametern in_point_features und in_street_features über die Parameter point_field_mapping und street_field_mapping zuordnen. Es ist auch möglich, sie durch die Angabe des dreistelligen Ländercodenamens auf das gesamte Dataset anzuwenden.
| String |
language_code (optional) | Gibt an, ob sprachspezifische Logik auf die Eingabedaten für die Zuweisung von Straßenabschnittsattributen zu Punkt-Features angewendet wird. Sie können sie festlegen, indem Sie die Option AS_DEFINED_IN_DATA auswählen und einen Wert aus den Parametern in_point_features und in_street_features über die Parameter point_field_mapping und street_field_mapping zuordnen. Es ist auch möglich, sie durch die Angabe einer Sprache über den dreistelligen Sprachcode auf das gesamte Dataset anzuwenden.
| 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"
)Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja