Adressen-Locator erstellen

Zusammenfassung

Mit diesem Werkzeug wird ein Adressen-Locator erstellt. Der Adressen-Locator kann verwendet werden, um die Position einer Adresse zu suchen, eine Adressentabelle zu geokodieren oder die Adresse einer Punktposition abzurufen.

Ältere Versionen:

Locators sollten in einem Dateiordner gespeichert werden, damit Sie die Vorteile neuer Features nutzen können, die nicht für Locators in Geodatabases unterstützt werden, z. B. Performance-Verbesserungen, Multithreading-Funktionen und Unterstützung von Vorschlägen. ArcGIS 10.4 ist die letzte Version, die die Speicherung von Locators in Geodatabases unterstützt.

Hinweis:

Für Locators, die mit diesem Werkzeug erstellt wurden, wird die Veröffentlichung in ArcGIS Server 11.0 oder höher nicht unterstützt.

Weitere Informationen zu gängigen Geokodierungs-Tasks

Verwendung

• Adressen-Locators können in einem beliebigen Dateiordner erstellt werden, den Sie angeben.

• Mit der Rolle eines Referenz-Datasets wird die Funktion der Referenzdaten für den Adressen-Locator definiert. Für die in ArcGIS verfügbaren Adressen-Locator-Styles werden zur Beschreibung der Rollen von Referenz-Datasets folgende Werte verwendet:

  • Primärtabelle: Legt die Feature-Class mit dem Primär-Referenz-Dataset für einen Locator fest, beispielsweise eine Feature-Class für Straßenmittelachsen. Diese Tabelle ist erforderlich.
  • Alternative Stadtnamen-Tabelle: Legt eine Tabelle mit alternativen Stadtnamen fest, die alternative Namen für die Stadt oder Ortsnamen enthält. Die Tabelle muss das Feld JoinID aufweisen, mit dem eine Verbindung zur Primärtabelle hergestellt werden kann. Diese Tabelle ist optional.
  • Alternative Namenstabelle: Legt eine Tabelle mit alternativen Straßennamen fest, die alternative Namen für die Straßen- oder Punkt-Features enthält. Die Tabelle muss das Feld JoinID aufweisen, mit dem eine Verbindung zur Primärtabelle hergestellt werden kann. Diese Tabelle ist optional.
  • Aliastabelle: Legt eine Aliasnamen-Tabelle für Ortsnamen fest, die Ortsnamen und tatsächliche Adressen für die Namen enthält. Der Benutzer kann die Position anhand des Ortsnamens, z. B. Field Museum, oder der Adresse, z. B. 1400 S Lakeshore Drive Chicago, IL 60605, suchen. Diese Tabelle ist optional.

• Mit benutzerdefinierten Locator-Styles und Locator-Styles von Drittanbietern können andere Rollen für Feature-Classes und Tabellen mit Referenzdaten definiert werden. Informationen zu den von Drittanbietern für Referenz-Datasets definierten Rollen finden Sie in der entsprechenden Dokumentation.

• Mit diesem Werkzeug können keine kombinierten Adressen-Locators erstellt werden. Verwenden Sie das Werkzeug Kombinierten Adressen-Locator erstellen, um einen kombinierten Adressen-Locator zu erstellen.

Syntax

arcpy.geocoding.CreateAddressLocator(in_address_locator_style, in_reference_data, in_field_map, out_address_locator, {config_keyword}, {enable_suggestions})

Parameter	Erklärung	Datentyp
in_address_locator_style	Der Adressen-Locator-Style, auf dem der neue Adressen-Locator basiert. US Address-Dual Ranges: Verwenden Sie diesen Style, wenn die Referenzdaten eine Line-Feature-Class darstellen, die Hausnummernbereiche auf beiden Seiten eines Straßenabschnitts enthält, und Sie nach einer Adresse auf einer bestimmten Straßenseite oder an einer Straßenkreuzung suchen möchten. US Address-One Range: Verwenden Sie diesen Style, wenn die Referenzdaten eine Line-Feature-Class mit einem Hausnummernbereich für jeden Straßenabschnitt darstellen, und Sie nach einer Adresse (ohne bestimmte Straßenseite) oder nach einer Straßenkreuzung suchen möchten. US Address-Single House: Verwenden Sie diesen Style, wenn die Referenzdaten eine Point- oder Polygon-Feature-Class darstellen, wobei jedes Feature eine einzelne Adresse darstellt, und Sie nach einer genauen Adresse für ein Flurstück, ein Gebäude oder einen Adresspunkt suchen möchten. US Address-Single House Subaddress: Verwenden Sie diesen Style, wenn die Referenzdaten einer Point- oder Polygon-Feature-Class darstellen, wobei jedes Feature eine einzelne Adresse mit optionalen Unteradresselementen darstellt, und Sie nach Appartements, Stadthäusern, Zweifamilienhäusern oder Geschäften in einem Einkaufszentrum suchen möchten. US Address-Street Name: Verwenden Sie diesen Style, wenn die Referenzdaten eine Line-Feature-Class darstellen und Sie nach Adressen nur mit dem Straßennamen suchen möchten. Informationen zum Adressbereich sind nicht erforderlich. US Address-City State: Verwenden Sie diesen Style, wenn die Referenzdaten eine Point- oder Polygon-Feature-Class darstellen und Sie nach einem bestimmten Ort in einem Bundesstaat/Bundesland suchen möchten. US Address-ZIP 5 Digit: Verwenden Sie diesen Style, wenn die Referenzdaten eine Point- oder Polygon-Feature-Class darstellen, wobei jedes Feature einen Postleitzahlenschwerpunkt oder geographischen Bereich darstellt, und Sie nach einem Ort mit einer bestimmten Postleitzahl suchen möchten. General-Gazetteer: Verwenden Sie diesen Style, wenn die Referenzdaten eine Point- oder Polygon-Feature-Class darstellen, wobei jedes Feature ein eindeutiges Feature darstellt, und Sie nach einem Ortsnamen, einer Landmark, einem Wasserzähler oder einem sonstigen eindeutigen Wert suchen möchten.	Address Locator Style
in_reference_data [[Reference Data, {Role}],...]	Die Feature-Classes und Tabellen mit Referenzdaten, die vom Adressen-Locator verwendet werden, sowie ihre Rollen. Primärtabelle: Legt die Feature-Class mit dem Primär-Referenz-Dataset für einen Locator fest, beispielsweise eine Feature-Class für Straßenmittelachsen. Diese Tabelle ist erforderlich. Alternative Stadtnamen-Tabelle: Legt eine Tabelle mit alternativen Stadtnamen fest, die alternative Namen für die Stadt oder Ortsnamen enthält. Die Tabelle muss das Feld JoinID aufweisen, mit dem eine Verbindung zur Primärtabelle hergestellt werden kann. Diese Tabelle ist optional. Alternative Namenstabelle: Legt eine Tabelle mit alternativen Straßennamen fest, die alternative Namen für die Straßen- oder Punkt-Features enthält. Die Tabelle muss das Feld JoinID aufweisen, mit dem eine Verbindung zur Primärtabelle hergestellt werden kann. Diese Tabelle ist optional. Aliastabelle: Legt eine Aliasnamen-Tabelle für Ortsnamen fest, die Ortsnamen und tatsächliche Adressen für die Namen enthält. Der Benutzer kann die Position anhand des Ortsnamens, z. B. Field Museum, oder der Adresse, z. B. 1400 S Lakeshore Drive Chicago, IL 60605, suchen. Diese Tabelle ist optional. Mit benutzerdefinierten Locator-Styles und Locator-Styles von Drittanbietern können andere Rollen für Referenz-Datasets definiert werden. Hinweis: Beim Erstellen eines Adressen-Locators mit Referenzdaten, die Millionen von Features enthalten, ist mindestens das 3- bis 4-fache der Größe dieser Daten als freier Festplattenspeicher in Ihrem Temp-Verzeichnis notwendig, da Dateien, die zum Erstellen des Locators verwendet werden, in dieses Verzeichnis geschrieben werden, bevor der Locator in das Ausgabeverzeichnis kopiert wird. Wenn auf der Festplatte nicht genügend Speicher verfügbar ist, tritt beim Ausführen des Werkzeugs irgendwann ein Fehler auf, sobald der vorhandene Speicher belegt ist. Beachten Sie zudem, dass beim Erstellen von sehr großen Locators für die Verarbeitung umfangreicher, speicherintensiver Prozesse ein Computer mit genügend RAM verwendet werden muss. Es empfiehlt sich außerdem, Background Geoprocessing (64 Bit) zu installieren und das Werkzeug bei aktivierter Geoverarbeitung im Hintergrund auszuführen.	Value Table
in_field_map	Die Zuordnung der vom Adressen-Locator-Style verwendeten Referenzdatenfelder zu den Feldern in den Referenz-Datasets. Jede Feldzuordnung dieses Parameters weist folgendes Format auf: # <locator field alias> <dataset field name> VISIBLE NONE # This shows as an example: reference_data_field_map = """ "'Feature ID' FeatureID VISIBLE NONE;'*From Left' L_F_ADD VISIBLE NONE; '*To Left' L_T_ADD VISIBLE NONE;'*From Right' R_F_ADD VISIBLE NONE; '*To Right' R_T_ADD VISIBLE NONE;'Prefix Direction' PREFIX VISIBLE NONE; 'Prefix Type' PRE_TYPE VISIBLE NONE;'*Street Name' NAME VISIBLE NONE; 'Suffix Type' TYPE VISIBLE NONE;'Suffix Direction' SUFFIX VISIBLE NONE""" Hierbei ist <locator field alias> der Aliasname des vom Adressen-Locator verwendeten Referenzdatenfeldes und <dataset field name> der Name des Feldes im Referenz-Dataset. Felder mit einem Sternchen (*) neben dem Namen sind für den Adressen-Locator-Style erforderlich. VISIBLE: Feld ist sichtbar. NONE: Die Geometrie ist eine Kopie des ursprünglichen Wertes. Wenn Sie ein optionales, vom Adressen-Locator-Style verwendetes Referenzdatenfeld keinem Feld im Referenz-Dataset zuordnen möchten, wählen Sie wie im unten stehenden Beispiel gezeigt "<None>" anstelle eines Feldnamens.	Field Info
out_address_locator	Der zu erstellende Adressen-Locator. Wenn Sie den Locator in einem Dateiordner speichern, können Sie von Performance-Verbesserungen, Multithreading-Funktionen und der Unterstützung von Vorschlägen profitieren. Sobald der Locator erstellt wurde, können zusätzliche Eigenschaften und Optionen in den Einstellungen des Locators geändert werden.	Address Locator
config_keyword (optional)	Das Konfigurationsschlüsselwort gibt die Speicherparameter der Tabelle in einem relationalen Datenbankmanagementsystem (RDBMS) – nur Enterprise- und File-Geodatabases – an.	String
enable_suggestions (optional)	Ermöglicht die Generierung von Vorschlägen zur zeichenweisen automatischen Vervollständigung für die Benutzereingabe in einer Client-Anwendung. Damit wird die interaktive Suche für Benutzer vereinfacht, da weniger Zeichen eingegeben werden müssen, bevor eine Entsprechung vorgeschlagen wird. Der Gedanke dahinter ist, dass die Client-Anwendung eine Liste mit Vorschlägen liefern kann, die mit jedem vom Benutzer eingegebenen Zeichen aktualisiert wird, bis der gesuchte Ort in der Liste erscheint. Nur die von Esri bereitgestellten Locator-Styles können zum Erstellen von Locators mit aktivierten Vorschlägen genutzt werden. Die Vorschlagsfunktionalität ist nur verfügbar, wenn ein solcher Locator als Geocode-Service veröffentlicht wird. Locators mit aktivierten Vorschlägen können nur in einem Dateiordner gespeichert werden, nicht etwa in einer Geodatabase. ENABLED —Vorschläge sind für den Locator aktiviert. DISABLED —Vorschläge sind für den Locator deaktiviert. Dies ist die Standardeinstellung.	Boolean

Codebeispiel

CreateAddressLocator – Beispiel (eigenständiges Skript)

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

# Create a street address locator using a street centerline feature class 
# in a file geodatabase as reference data.
# The new address locator will be created in a separate file folder.

# Import system modules
import arcpy

arcpy.env.workspace = "C:/ArcTutor/Geocoding/atlanta.gdb"
Atlanta_AddressLocator_OutputPath = "C:/ArcTutor/Geocoding/Atlanta"

arcpy.CreateAddressLocator_geocoding("US Address - Dual Ranges", "streets 'Primary Table'", "'Feature ID' OBJECTID VISIBLE NONE;'*From Left' L_F_ADD VISIBLE NONE;'*To Left' L_T_ADD VISIBLE NONE;'*From Right' R_F_ADD VISIBLE NONE;'*To Right' R_T_ADD VISIBLE NONE;'Prefix Direction' PREFIX VISIBLE NONE;'Prefix Type' PRE_TYPE VISIBLE NONE;'*Street Name' NAME VISIBLE NONE;'Suffix Type' TYPE VISIBLE NONE;'Suffix Direction' SUFFIX VISIBLE NONE;'Left City or Place' CITYL VISIBLE NONE;'Right City or Place' CITYR VISIBLE NONE;'Left ZIP Code' ZIPL VISIBLE NONE;'Right ZIP Code' ZIPR VISIBLE NONE;'Left State' STATE_ABBR VISIBLE NONE;'Right State' STATE_ABBR VISIBLE NONE", Atlanta_AddressLocator_OutputPath, "", "DISABLED")

Umgebungen

• Aktueller Workspace
• Ausgabe-CONFIG-Schlüsselwort
• Scratch-Workspace

Lizenzinformationen

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