Nach oben

Feature-Locator erstellen (Geocoding)

In diesem Thema

  1. Zusammenfassung
  2. Verwendung
  3. Parameter
  4. Umgebungen
  5. Lizenzinformationen

Zusammenfassung

Erstellt einen Locator mithilfe von Referenzdaten, die einen eindeutigen Namen oder Wert für jedes in einem einzelnen Feld gespeicherte Feature enthalten. Der mit diesem Werkzeug erstellte Locator bietet vielfältige Anwendungsmöglichkeiten. Er kann zum Suchen nach Namen oder eindeutigen Attributen von Features verwendet werden, z. B. zum Suchen von Wasserzählern, kurzen Ortsnamen, Mobilfunkmasten oder alphanumerischen Zeichenfolgen für die Identifizierung von Positionen (z. B. N1N115).

Die mit diesem Werkzeug erstellten Locators suchen mithilfe der indizierten Werte in einem einzelnen Feld Werte in dem einzelnen Feld und geben sie als Sammlung von Punkten zurück, oder sie identifizieren Features in der Nähe einer Punktposition. Adressentabellen, die mit einem Locator geokodiert werden können, müssen ebenfalls ein einzelnes Feld mit demselben eindeutigen Namen oder Wert enthalten, der zur Positionsermittlung verwendet werden kann.

Hinweis:

Von diesem Werkzeug erstellte Locators können in ArcGIS Pro 2.5 oder höher, Enterprise 10.8 oder höher und als Locator-Service in ArcMap verwendet werden. Von diesem Werkzeug erstellte Locators können nicht als lokale Locators in ArcMap verwendet werden.

Verwendung

  • Als Services dargestellte Feature-Classes sind unterstützte Datentypen zur Verwendung als Referenzdaten.

  • Das Werkzeug unterstützt Feature-Classes, die als Referenzdaten Punkt- und Polygongeometrie enthalten.

  • Ein mit diesem Werkzeug erstellter Locator kann zum Suchen eindeutiger Kennungen oder kurzer Zeichenfolgenwerte (nicht länger als fünf Wörter) verwendet werden.

  • Locators, die mit diesem Werkzeug erstellt wurden, unterstützen die globale Suche nach Koordinaten (Breitengrad/Längengrad, MGRS, DD oder USNG). Die primären Referenzdaten, mit denen der Locator erstellt wurde, müssen mindestens ein Feature enthalten. Die Unterstützung der Koordinatensuche wird unter Zu unterstützende Kategorien auf der Seite Geokodierungsoptionen des Dialogfeldes Locator-Eigenschaften für den Locator deaktiviert bzw. aktiviert.

  • Bei der Erstellung des Locators können zusätzliche Felder aus den Referenzdaten angegeben und dem Locator als benutzerdefinierte Ausgabefelder hinzugefügt werden. In diesen Feldern können weitere Informationen zu den Kandidaten des Geokodierungsergebnisses angegeben werden. Wenn Sie z. B. wissen möchten, mit welchem Zählblock oder Feuerwehrbezirk ein Hydrant verknüpft ist, können Sie die Hydranten-ID geokodieren und die Attribute des Zählblocks oder Feuerwehrbezirks räumlich mit den Geokodierungsergebnissen verbinden. Indem Sie die Attribute aus den Layern, die die zusätzlichen Informationen enthalten, räumlich mit den Referenzdaten, die zum Erstellen des Locators verwendet werden, verbinden, können Sie beim Erstellen des Locators die verbundenen Felder als benutzerdefinierte Ausgabefelder angeben. Das Geokodierungsergebnis enthält die zusätzlichen benutzerdefinierten Ausgabefelder und ihre Werte.

  • Die Ausgabe dieses Werkzeugs kann als Eingabe für das Werkzeug Kombinierten Adressen-Locator erstellen verwendet werden. Beim Kombinieren eines mit diesem Werkzeug erstellten Locators mit anderen auf Rollen basierenden Adressen-Locators in einem kombinierten Locator ist Vorsicht geboten, da die Feldzuordnung des Rollenfeldes Name des Feature-Locators zu unerwartetem Verhalten führen kann. Es empfiehlt sich, stattdessen einen Locator zu verwenden, der mit dem Werkzeug Locator erstellen basierend auf der Rolle POI erstellt wurde.

  • Um die richtige Python-Syntax zu generieren, führen Sie zuerst das Werkzeug im Bereich Geoverarbeitung mit den zutreffenden Parameteroptionen aus. Öffnen Sie anschließend das Menü Ausführen, und wählen Sie die Option Python-Befehl kopieren aus.

  • Sie können Locators erstellen, die Point-Feature-Classes mit Z-Wert-Unterstützung als primäre Referenzdaten verwenden. Die Features mit Z-Wert-Unterstützung müssen mit absoluter Höhe erstellt werden, damit die Geokodierungsergebnisse mit der erwarteten Höhe in der Karte dargestellt werden.

Parameter

DialogfeldPython

BeschriftungErläuterungDatentyp
Eingabe-Features

Die Feature-Class oder der Feature-Layer mit Referenzdaten, die bzw. der zum Erstellen des Locators verwendet wird.

Als Services dargestellte Feature-Classes sind unterstützte Datentypen zur Verwendung als Referenzdaten.

Vorsicht:

Wenn eine Definitionsabfrage für die Referenzdaten definiert wird oder wenn Features ausgewählt wurden, werden beim Erstellen des Locators nur die abgefragten und ausgewählten Features einbezogen.

Hinweis:

Beim Erstellen eines Locators mit Referenzdaten, die Millionen von Features enthalten, ist mindestens das drei- bis vierfache 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 ein Fehler auf, sobald nicht genügend Speicher für das Ausführen des Werkzeugs verfügbar ist. Beim Erstellen von großen Locators für die Verarbeitung umfangreicher, speicherintensiver Prozesse muss Ihr Computer über genügend RAM verfügen.

Feature Layer
Suchfelder

Ordnet das Referenzdatenfeld dem Feld zu, das im Parameter Eingabe-Features für die Suche verwendet wird. Felder mit einem Sternchen (*) neben dem Namen sind Pflichtfelder. Das ausgewählte Feld wird indiziert und für die Suche verwendet.

Field Info
Ausgabe-Locator

Die Ausgabe-Locator-Datei, die in einem Dateiordner erstellt werden soll. Sobald der Locator erstellt wurde, können zusätzliche Eigenschaften und Optionen in den Einstellungen des Locators geändert werden.

Address Locator
Zusätzliche Locator-Felder
(optional)

Ordnet zusätzliche Felder für die Ausdehnung und den Rang zu, sofern in den Daten vorhanden. Mit dem Feld Rank werden Ergebnisse von mehrdeutigen Abfragen sowie Kandidaten mit demselben Namen und derselben Punktzahl sortiert. Die Ausdehnungsfelder helfen, die Kartenausdehnung zum Anzeigen geokodierter Ergebnisse festzulegen.

Field Info
Benutzerdefinierte Ausgabefelder
(optional)

Fügt dem Locator benutzerdefinierte Ausgabefelder hinzu. Die für diesen Parameter angegebenen Werte definieren die Namen der benutzerdefinierten Ausgabefelder, die im Ergebnis der Geokodierung zurückgegeben werden. Dabei muss jedoch jedes neue Feld einem Feld in den Referenzdaten zugeordnet werden. Die maximale Anzahl der vom Locator unterstützten Felder beträgt 50.

Gehen Sie wie folgt vor, um dem Locator benutzerdefinierte Ausgabefelder zur Verwendung im Ergebnis der Geokodierung hinzuzufügen:

  • Geben Sie die Namen der benutzerdefinierten Ausgabefelder ein. Die Namen der benutzerdefinierten Ausgabefelder werden der Feldzuordnung hinzugefügt.
  • Wählen Sie das Feld in den Referenzdaten aus, die die zusätzlichen Werte enthalten, die in die Ausgabe der Geokodierung einbezogen werden sollen.
String

arcpy.geocoding.CreateFeatureLocator(in_features, search_fields, output_locator, {locator_fields}, {custom_output_fields})
NameErläuterungDatentyp
in_features

Die Feature-Class oder der Feature-Layer mit Referenzdaten, die bzw. der zum Erstellen des Locators verwendet wird.

Als Services dargestellte Feature-Classes sind unterstützte Datentypen zur Verwendung als Referenzdaten.

Vorsicht:

Wenn eine Definitionsabfrage für die Referenzdaten definiert wird oder wenn Features ausgewählt wurden, werden beim Erstellen des Locators nur die abgefragten und ausgewählten Features einbezogen.

Hinweis:

Beim Erstellen eines Locators mit Referenzdaten, die Millionen von Features enthalten, ist mindestens das drei- bis vierfache 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 ein Fehler auf, sobald nicht genügend Speicher für das Ausführen des Werkzeugs verfügbar ist. Beim Erstellen von großen Locators für die Verarbeitung umfangreicher, speicherintensiver Prozesse muss Ihr Computer über genügend RAM verfügen.

Feature Layer
search_fields

Ordnet das Referenzdatenfeld dem Feld zu, das im Parameter in_features für die Suche verwendet wird. Die Zuordnung von search_fields erfolgt im nachstehenden Format. Dabei ist <locator field name> der Name des Feldes, das von der Locator-Rolle unterstützt wird, während <data field name> der Name des für die Suche verwendeten Feldes im Parameter in_features ist.

# <locator field name> <data field name>

# This shows an example:
reference_data_field_map = """
"'Name' AssetName"
"""

Das ausgewählte Feld wird indiziert und für die Suche verwendet. Ordnen Sie das relevante Feld für die Referenzdaten im Parameter in_features zu.

Field Info
output_locator

Die Ausgabe-Locator-Datei, die in einem Dateiordner erstellt werden soll. Sobald der Locator erstellt wurde, können zusätzliche Eigenschaften und Optionen in den Einstellungen des Locators geändert werden.

Address Locator
locator_fields
(optional)

Ordnet zusätzliche Felder für die Ausdehnung und den Rang zu, sofern in den Daten vorhanden. Mit dem Feld Rank werden Ergebnisse von mehrdeutigen Abfragen sowie Kandidaten mit demselben Namen und derselben Punktzahl sortiert. Die Ausdehnungsfelder helfen, die Kartenausdehnung zum Anzeigen geokodierter Ergebnisse festzulegen. Die locator_fields-Zuordnung erfolgt im folgenden Format:

# <additional locator field name> <additional data field name>

# This shows an example:
additional_fields_map = """
"'Rank' RANK;'Min X' Xmin;
'Max X' Xmax;'Min Y' Ymin;
'Max Y' Ymax"
"""

Das Feld <additional locator field name> ist der Name der zusätzlicher Felder, die vom Locator unterstützt werden, und das Feld <additional data field name> ist der Name des Feldes im Parameter in_features. Ordnen Sie die relevanten Felder für die Referenzdaten im Parameter in_features zu.

Field Info
custom_output_fields
[custom_output_fields,...]
(optional)

Fügt dem Locator benutzerdefinierte Ausgabefelder hinzu. Die für diesen Parameter angegebenen Werte definieren die Namen der benutzerdefinierten Ausgabefelder, die im Ergebnis der Geokodierung zurückgegeben werden. Dabei muss jedoch jedes neue Feld einem Feld in den Referenzdaten zugeordnet werden. Die maximale Anzahl der vom Locator unterstützten Felder beträgt 50.

Hinweis:

Sie müssen zuerst die Namen der benutzerdefinierten Ausgabefelder in den Parameter field_mapping aufnehmen und danach die Namen im Parameter custom_output_fields auflisten.

String

Codebeispiel

CreateFeatureLocator: Beispiel 1 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion CreateFeatureLocator in einem eigenständigen Skript verwendet wird.

# Description: Create a feature locator using local data.

# Import system modules
import arcpy

# Set local variables
in_features = r"C:\data\arizona.gdb\az_points"
search_field = "*Name NAME VISIBLE NONE"
output_locator = r"C:\output\locators\az_points_locator"
locator_fields = "Rank <None> VISIBLE NONE;'Min X' <None> VISIBLE NONE;'Max X' <None> VISIBLE NONE;'Min Y' <None> VISIBLE NONE;'Max Y' <None> VISIBLE NONE"

# Run CreateFeatureLocator
arcpy.geocoding.CreateFeatureLocator(in_features, search_field, output_locator, 
                                     locator_fields)
CreateFeatureLocator: Beispiel 2 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion CreateFeatureLocator in einem eigenständigen Skript verwendet wird.

# Description: Create a feature locator using data from a hosted feature service in ArcGIS Online.

# Import system modules
import arcpy

# Sign in to Portal
arcpy.SignInToPortal("https://www.arcgis.com", "<username>", "<password>")

# Set local variables
in_features = "https://services.arcgis.com/<layer_id>/arcgis/rest/services/<service_name>/FeatureServer/<layer_number>"
search_field = "*Name NAME VISIBLE NONE"
output_locator = r"C:\output\locators\service_locator"
locator_fields = "Rank <None> VISIBLE NONE;'Min X' <None> VISIBLE NONE;'Max X' <None> VISIBLE NONE;'Min Y' <None> VISIBLE NONE;'Max Y' <None> VISIBLE NONE"

arcpy.geocoding.CreateFeatureLocator(in_features, search_field, output_locator, 
                                     locator_fields)

Umgebungen

Aktueller Workspace

Feedback zu diesem Thema?

In diesem Thema
  1. Zusammenfassung
  2. Verwendung
  3. Parameter
  4. Umgebungen
  5. Lizenzinformationen