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.
Verwendung
Adressen-Locators können im selben Workspace wie die Referenzdaten oder in einem anderen Workspace in einer angegebenen Geodatabase oder einem Dateiordner erstellt werden. Um eine bessere Geokodierungs-Performance zu erzielen, ist es empfehlenswert, Locators in einem Dateiordner statt in einer Geodatabase zu speichern.
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 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 eine JoinID aufweisen, die verwendet werden kann, um eine Verbindung mit der Primärtabelle herzustellen. 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
CreateAddressLocator_geocoding (in_address_locator_style, in_reference_data, in_field_map, out_address_locator, {config_keyword}, {enable_suggestions})| Parameter | Erläuterung | Datentyp |
in_address_locator_style | Der Adressen-Locator-Style, auf dem der neue Adressen-Locator basiert. | 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.
Mit benutzerdefinierten Locator-Styles und Locator-Styles von Drittanbietern können andere Rollen für Referenz-Datasets definiert werden. | 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: 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. Um den Aliasnamen für ein Locator-Style-Referenzdatenfeld festzulegen, öffnen Sie das Werkzeugdialogfeld Adressen-Locator erstellen und wählen den Locator-Style aus. Der in der Spalte Feldname des Elements "Feldzuordnung" angezeigte Name ist der Aliasname des Feldes. | Field Info |
out_address_locator | Der zu erstellende Adressen-Locator. | 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-Stile 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.
| Boolean |
Codebeispiel
CreateAddressLocator-Beispiel (Python-Fenster)
Das folgende Skript für das Python-Fenster veranschaulicht, wie Sie die Funktion "CreateAddressLocator" im unmittelbaren Modus verwenden.
# 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 the same file geodatabase.
# Import system modules
import arcpy
from arcpy import env
env.workspace = "C:/ArcTutor/Geocoding/atlanta.gdb"
arcpy.CreateAddressLocator_geocoding("US Address - Dual Ranges", "streets Primary", "'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;'Left City or Place' CITYL VISIBLE NONE;'Right City or Place' CITYR VISIBLE NONE;'Left Zipcode' ZIPL VISIBLE NONE;'Right Zipcode' ZIPR VISIBLE NONE;'Left State' State_Abbr VISIBLE NONE;'Right State' State_Abbr VISIBLE NONE", Atlanta_AddressLocator, "", "DISABLED")
Umgebung
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Ja
- ArcGIS for Desktop Standard: Ja
- ArcGIS for Desktop Advanced: Ja