Beschriftung | Erläuterung | Datentyp |
Land bzw. Region | Gibt die Landesadressierungsstruktur an, die für die Teilung von Adressen in Elemente verwendet wird. Standardmäßig wird die regionale Einstellung des Betriebssystems verwendet.
| String |
Eingabe-Adressendaten | Die Tabelle oder Feature-Class mit Straßenadressinformationen, die in einzelne Adressenelemente geteilt werden. Zoneninformationen wie Stadt, Stadtviertel und Postleitzahl werden nicht unterstützt. | Table View |
Eingabe-Adressfelder | Die Felder in der Eingabe-Tabelle oder -Feature-Class ergeben durch Verkettung die zu teilende Straßenadresse. Zoneninformationen wie Stadt, Stadtviertel und Postleitzahl werden nicht unterstützt. Die Reihenfolge, in der die Felder ausgewählt werden, entspricht der Reihenfolge, in der die Felder verkettet werden. | String |
Ausgabe-Adressendaten | Die Ausgabe-Feature-Class oder Ausgabetabelle, die die Daten der geteilten Straßenadresse enthält. | Dataset |
Ausnahmendatei (optional) | Die Tabelle, die Straßenanalyseausnahmen enthält. Die Tabelle kann ein beliebiges unterstütztes Tabellenformat aufweisen. | Table View |
Zusammenfassung
Teilt Straßenadresseninformationen in Adressenelemente und erstellt eine Tabelle oder Feature-Class mit den zusätzlichen Elementen, die als einzelne Felder hinzugefügt werden.
Abbildung
Verwendung
Bei den Eingabe-Adressendaten kann es sich um eine Tabelle oder eine Feature-Class mit Straßenadressattributen handeln, die in einzelne Straßenadressenelemente geparst oder geteilt werden können.
Die Eingabe-Straßenadresse, die geteilt werden soll, kann in einem einzelnen Feld (z. B. StreetName oder Address) gespeichert werden, das im Werkzeug als Eingabeadressenfeld ausgewählt werden kann.
Die Eingabe-Straßenadresse kann auch in mehreren Feldern gespeichert werden, beispielsweise wenn sich die Hausnummer und die Einheiteninformationen in separaten Feldern befinden. In diesem Fall werden die Felder on-the-fly in der Reihenfolge verkettet, in der sie ausgewählt wurden, und die Straßenadresse wird in die entsprechenden Elemente geteilt.
Binden Sie in die Eingabe-Straßenadresse keine Zoneninformationen wie Stadt, Stadtviertel, Subregion und Postleitzahl ein. Diese Elemente werden bei der Verarbeitung nicht geparst und führen zu falschen Ergebnissen, wenn Sie eingebunden werden.
Der Parameterwert Ausnahmendatei muss für jeden Datensatz, der ein benutzerdefiniertes Analysemuster aufweist, jeweils eine Zeile enthalten. Formatieren Sie die Datei so, dass sie das Eingabeadressenfeld (wenn mehrere Felder vorhanden sind, verketten Sie die Werte zu einer Zeichenfolge) und danach die erwarteten Elemente der geteilten Adresse enthält. Die Feldnamen für die Elemente der geteilten Adresse müssen mit Folgendem übereinstimmen:
- AddNum
- StPreDir
- StPreType
- StName
- StType
- StDir
- UnitType
- UnitName
- BuildingType
- BuildingUnit
- LevelType
- LevelName
Hinweis:
Nicht alle Felder sind erforderlich. Nur die Felder, die basierend auf der benutzerdefinierten Adresse beim Teilen in Elemente erforderlich sind, sind erforderlich.
Hinweis:
Weitere Informationen erhalten Sie, wenn Sie ein Beispiel für eine Ausnahmendatei herunterladen.
Die erste Adresse in der Datei, 123 South Beach Avenue, wird üblicherweise in die folgenden Felder geteilt:
AddNum StPreDir StName StType 123
South
Beach
Avenue
Mit der Ausnahmendatei wird jedoch die folgende benutzerdefinierte Teilung erstellt:
AddNum StName StType 123
South Beach
Avenue
Dieses Werkzeug unterstützt die parallele Verarbeitung. Wenn Ihr Computer mit mehreren Prozessoren oder mit Prozessoren, die mehrere Kerne haben, ausgestattet ist, kann eine höhere Leistung erzielt werden, insbesondere beim Teilen von Adressen in größeren Datasets. 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. Für Tabellen mit weniger als 50 Zeilen wird nur ein Prozess verwendet, aber das Werkzeug skaliert die Anzahl der verwendeten Prozesse bis zur Anzahl der logischen Prozessoren auf dem Computer für Tabellen mit vielen Zeilen. Durch Festlegen der Umgebung auf 0 wird die parallele Verarbeitung deaktiviert. Wenn ein Faktor zwischen 1 und 99 festgelegt wird, identifiziert das Werkzeug den Prozentsatz der zu verwendenden logischen Kerne, indem die Formel (Faktor für parallele Verarbeitung / 100 * logische Kerne) auf die nächste ganze Zahl aufgerundet angewendet wird. Wenn das Ergebnis dieser Formel 0 oder 1 ist, wird die parallele Verarbeitung nicht aktiviert.
Sie können die durch dieses Werkzeug generierte Ausgabedatei im Bereich Geteilte Adresse überprüfen überprüfen und aktualisieren. Mit diesem Prozess können Sie auch eine aktualisierte Ausgabendatei generieren bzw. ergänzen. Diese kann im Parameter Ausnahmendatei verwendet werden, wenn zukünftig Daten mit diesem Werkzeug geteilt werden.
Parameter
arcpy.geocoding.SplitAddressIntoComponents(country_code, in_address_data, in_address_fields, out_address_data, {in_exceptions})
Name | Erläuterung | Datentyp |
country_code | Gibt die Landesadressierungsstruktur an, die für die Teilung von Adressen in Elemente verwendet wird. Standardmäßig wird die regionale Einstellung des Betriebssystems verwendet.
| String |
in_address_data | Die Tabelle oder Feature-Class mit Straßenadressinformationen, die in einzelne Adressenelemente geteilt werden. Zoneninformationen wie Stadt, Stadtviertel und Postleitzahl werden nicht unterstützt. | Table View |
in_address_fields [in_address_fields,...] | Die Felder in der Eingabe-Tabelle oder -Feature-Class ergeben durch Verkettung die zu teilende Straßenadresse. Zoneninformationen wie Stadt, Stadtviertel und Postleitzahl werden nicht unterstützt. Die Reihenfolge, in der die Felder ausgewählt werden, entspricht der Reihenfolge, in der die Felder verkettet werden. | String |
out_address_data | Die Ausgabe-Feature-Class oder Ausgabetabelle, die die Daten der geteilten Straßenadresse enthält. | Dataset |
in_exceptions (optional) | Die Tabelle, die Straßenanalyseausnahmen enthält. Die Tabelle kann ein beliebiges unterstütztes Tabellenformat aufweisen. | Table View |
Codebeispiel
Teilt eine Tabelle, die Adresszeichenfolgen in einem Feld enthält, in separate Elemente.
import arcpy
atlanta_addresses = r"C:\AtlantaAddresses.csv"
arcpy.geocoding.SplitAddressIntoComponents("USA", atlanta_addresses, "Address",
r"C:\MySplitAddresses.csv",
"ExceptionsFile.csv")