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 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 eine JoinID aufweisen, mit der 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 eine JoinID aufweisen, mit der 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
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.
| 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. | 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.
| 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
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja