Datei geokodieren (Geocoding Tools)

Zusammenfassung

Konvertiert große lokale Tabellen mit Adressen oder Orten in Punkte in einer Feature-Class oder als CSV- bzw. XLS-Tabelle. Dieses Werkzeug verwendet Locators, die in einem ArcGIS Enterprise-Portal gehostet werden.

Verwendung

Dieses Werkzeug unterstützt die folgenden Tabellenformate als Eingabe:
- Datei mit kommagetrennten Werten (.csv)
- Tabellen in File-Geodatabase
- Microsoft Excel-Arbeitsblätter (.xls- und .xlsx-Dateien)

Für CSV-Eingabetabellen wird zusätzlich zu den vom Locator angehängten Feldern die erste Zeile der Eingabedatei für die Feldnamen in der Ausgabetabelle verwendet. Feldnamen dürfen weder Leerzeichen noch Sonderzeichen wie $ oder * enthalten.

Weitere Informationen zum Arbeiten mit Microsoft Excel-Dateien in ArcGIS Pro

Hinweis:

Die schnellsten Methoden zum Zurückgeben der Geokodierungsergebnisse mit einer Eingabetabelle in Form einer File-Geodatabase sind das Eingrenzen der Inhalte der File-Geodatabase oder das Bereitstellen einer File-Geodatabase, die nur eine Tabelle enthält.

Sie können Adressen geokodieren, die in einem einzelnen Feld gespeichert sind, sich auf mehrere Felder aufteilen oder in einem einzelnen und einem Länderfeld gespeichert sind. Die vollständige Adresse ist in einem einzelnen Eingabefeld gespeichert, z. B. 303 Peachtree St NE, Atlanta, GA 30308. Mehrere Felder werden unterstützt, wenn die Eingabeadressen in mehrere Felder wie "Address", "City", "State" und "ZIP" für eine allgemeine US-amerikanische Adresse unterteilt sind. Ebenfalls unterstützt wird die vollständige Adresse, die in einem einzelnem Eingabefeld gespeichert ist, z. B. 303 Peachtree St NE, Atlanta GA 30308, zusammen mit einem Feld, in dem das mit der Adresse verknüpfte Land gespeichert ist, z. B. USA.
Einige Locators unterstützen mehrere Eingabe-Adressenfelder wie Address, Address2 und Address3. In diesem Fall kann das Adressenelement auf mehrere Felder aufgeteilt werden. Zum Zeitpunkt der Geokodierung werden die Adressenfelder dann verkettet. Beispielsweise werden sowohl "100", "Main st" und "Apt 140" als Angabe in drei Feldern als auch "100 Main st" und "Apt 140" in zwei Feldern bei der Geokodierung zu "100 Main st Apt 140" verkettet.
Zur Verwendung dieses Werkzeugs ist ein ArcGIS Enterprise-Portal der Version 10.7 oder höher erforderlich.
Wenn der Portal-Locator, den Sie verwenden möchten, im Portal nicht als Utility-Service verfügbar ist, dann bitten Sie den Portal-Administrator, den Locator als Portal-Utility-Service hinzuzufügen, und konfigurieren Sie Batch-Geokodierung im Locator.
Verwenden Sie einen Locator in dem ArcGIS Enterprise-Portal, das für die Verwendung von mehreren Threads konfiguriert wurde, um die Performance der Geokodierung zu verbessern.
Die Geokodierungsergebnisse werden im gleichen Raumbezug wie der Locator gespeichert. Sie können den Raumbezug der Ausgabe ändern, indem Sie in den Umgebungseinstellungen des Werkzeugs ein anderes Ausgabe-Koordinatensystem festlegen.
Die Geokodierungsergebnisse enthalten alle relevanten Geokodierungsinformationen, z. B. Punktzahl, Status und die abgeglichenen Adressen der einzelnen Datensätze, sowie die Werte aus der ursprünglichen Eingabetabelle. Die Geokodierungsergebnisse aus diesem Werkzeug enthalten einen statischen Snapshot der ursprünglichen Eingabetabelle. Deshalb werden die Ergebnisse in der Ausgabedatei nach dem Hinzufügen oder Aktualisieren von Werten in der ursprünglichen Tabelle nicht aktualisiert. Führen Sie das Werkzeug erneut aus, um eine Ausgabedatei mit diesen Änderungen zu erstellen.
Wenn die Geokodierungsergebnisse als Feature-Class zurückgegeben werden, können die Adressen mit dem Werkzeug Adressen erneut abgleichen oder der Option Adressen erneut abgleichen, mit der der Bereich Adressen erneut abgleichen aufgerufen wird, erneut abgeglichen werden.

Hinweis:

Die Tabelle muss in einem ArcGIS Enterprise 10.8-Portal mit einem Locator geokodiert werden, der mehrere Threads für die Batch-Geokodierung enthält.

Weitere Informationen zum erneuten Abgleichen von Geokodierungsergebnissen
Wird ein Eingabe-Locator verwendet, der aus Daten mit Z-Wert-Unterstützung erstellt wurde, verfügt die Ausgabe des Werkzeugs nicht über Z-Wert-Unterstützung. In diesem Werkzeug werden nur 2D-Ausgaben unterstützt.
Die folgenden Parameter werden nicht für alle Locators unterstützt, die für den Parameterwert Locator verwendet werden: Land bzw. Region, Bevorzugter Positionstyp und Kategorie.
Wenn eine Locator-Sicht, die in ArcGIS Pro 3.2 erstellt wurde, als Parameterwert für Locator verwendet wird, werden die darin enthaltenen Konfigurationen nicht von diesem Werkzeug angewendet.

Beschriftung	Erläuterung	Datentyp
Eingabetabelle	Die Eingabetabelle mit den zu geokodierenden Adressen oder Orten im CSV-, XLS- oder XLSX-Format oder eine Tabelle in einer File-Geodatabase.	Record Set
Locator	Der Portal-Locator, der zum Geokodieren der Tabelle verwendet werden soll. Sie können einen Locator aus der Liste der Locators im aktiven Portal auswählen oder im aktiven Portal nach anderen verfügbaren Locators suchen. Locators, die im aktiven Portal als Utility-Services festgelegt wurden, sind standardmäßig verfügbar. Hinweis: Der ArcGIS World Geocoding Service ist für dieses Werkzeug deaktiviert. Verwenden Sie das Werkzeug Adressen geokodieren, wenn Sie den ArcGIS World Geocoding Service verwenden möchten.	Address Locator
Adressfeldzuordnung	Die vom Locator verwendeten Adressfelder werden den Feldern in der Eingabe-Adresstabelle zugeordnet. Geben Sie Einzelnes Feld an, wenn die vollständige Adresse in einem Feld der Eingabetabelle gespeichert ist, z. B. 303 Peachtree St NE, Atlanta, GA 30308. Geben Sie Mehrere Felder an, wenn die Eingabeadressen in mehrere Felder unterteilt sind, wie zum Beispiel `Address`, `City`, `State` und `ZIP` für eine allgemeine US-amerikanische Adresse. Geben Sie Einzelnes Feld und Länderfeld an, wenn die vollständige Adresse (z. B. 303 Peachtree St NE, Atlanta, GA 30308) und das Land (z. B. USA) in separate Felder (z. B. `Address` und `Country`) unterteilt sind. Einige Locators unterstützen mehrere Eingabe-Adressenfelder wie `Address`, `Address2` und `Address3`. In diesem Fall kann das Adressenelement auf mehrere Felder aufgeteilt werden. Zum Zeitpunkt der Geokodierung werden die Adressenfelder dann verkettet. Beispielsweise werden sowohl "100", "Main st" und "Apt 140" als Angabe in drei Feldern als auch "100 Main st" und "Apt 140" in zwei Feldern bei der Geokodierung zu "100 Main st Apt 140" verkettet. Wenn Sie ein optionales, vom Locator verwendetes Eingabe-Adressenfeld keinem Feld in der Eingabe-Adressentabelle zuordnen möchten, wählen Sie wie im unten stehenden Beispiel gezeigt <None> anstelle eines Feldnamens.	Field Info
Ausgabetyp	Gibt den Typ der Datei an, in die die Geokodierungsergebnisse geschrieben werden sollen. CSV—Eine `.csv`-Datei wird zurückgegeben. Feature-Class—Eine Feature-Class in einer File-Geodatabase wird zurückgegeben. XLS—Eine `.xls`-Datei wird zurückgegeben.	String
Ausgabeverzeichnis	Der Ordner, in den die Ausgabe-Geokodierungsergebnisse geschrieben werden sollen. Wenn die Ausgabe eine `.csv`- oder `.xls`-Datei ist, wird eine Ausgabedatei im angegebenen Ordner abgelegt. Wenn die Ausgabe eine Feature-Class ist, wird eine Ausgabe-File-Geodatabase erstellt und im angegebenen Ordner abgelegt. Die neue File-Geodatabase enthält dann die geokodierte Feature-Class. Die Ausgabe-File-Geodatabase und die Feature-Class in der File-Geodatabase erhalten denselben Namen.	Workspace
Ausgabename	Der Name der Ausgabe mit den geokodierten Ergebnissen.	String
Land bzw. Region (Optional)	Das Land oder die Länder, auf die die Suche nach den geokodierten Adressen begrenzt wird. Durch die Angabe von Ländern wird in den meisten Fällen die Genauigkeit der Geokodierung verbessert. Wenn kein Land angegeben wird, erfolgt die Geokodierung für alle unterstützten Länder des Locators. Dieser Parameterwert wird überschrieben, wenn Sie Einzelnes Feld und Länderfeld für den Parameter Adressenfeldzuordnung angeben.	String
Bevorzugter Positionstyp (Optional)	Gibt die bevorzugte Ausgabegeometrie an, die für `PointAddress`-Übereinstimmungen zurückgegeben wird. Wenn die bevorzugte Position in den Daten nicht vorhanden ist, wird die Standardposition der Adressposition zurückgegeben. In der ArcGIS REST API-Webhilfe finden Sie Informationen zum Parameter `locationType` für `geocodeAddresses`. Adressenposition—Für Geokodierungsergebnisse, die eine Adressposition darstellen, zum Beispiel eine Gebäudeadresse, einen Flurstücksschwerpunkt oder einen Hauseingang, wird eine Geometrie zurückgegeben. Dies ist die Standardeinstellung. Routenposition—Gibt für Geokodierungsergebnisse eine Geometrie zurück, die eine Position nahe der Straßenseite, die für das Routing von Fahrzeugen verwendet werden kann, darstellt.	String
Kategorie (Optional)	Begrenzt die Typen der Orte, nach denen der Locator sucht. Dadurch werden falsche positive Übereinstimmungen und unerwünschte Übereinstimmungen auf Adressenebene verhindert und Koordinatensuchen disambiguiert. Dieser Parameter kann dazu beitragen, den Suchvorgang zu beschleunigen. Wenn keine Kategorie verwendet wird, wird die Geokodierung mithilfe aller unterstützten Kategorien ausgeführt. Nicht alle Kategoriewerte werden für alle Positionen und Länder unterstützt. In der ArcGIS REST API-Webhilfe finden Sie weitere Informationen zum Filtern von Kategorien.	String
Ausgabefelder (Optional)	Gibt die Locator-Ausgabefelder an, die in den Geokodierungsergebnissen zurückgegeben werden sollen. Die ursprünglichen Feldnamen aus dem Parameterwert Eingabetabelle werden beibehalten, wenn die Option Nur Position, Minimal oder Minimal- und Benutzerfelder angegeben ist. Hinweis: Dieser Parameter kann mit Eingabe-Locators verwendet werden, die mit dem Werkzeug Locator erstellen oder mit dem Werkzeug Feature-Locator erstellen erstellt wurden, das in Enterprise 10.9 oder höher veröffentlicht wurde. Von kombinierten Locators, die mindestens einen Locator enthalten, der mit dem Werkzeug Adressen-Locator erstellen erstellt wurde, wird dieser Parameter nicht unterstützt. Alle—Bezieht alle verfügbaren Locator-Ausgabefelder in die Geokodierungsergebnisse ein. Dies ist die Standardeinstellung. Nur Position—Das Feld `Shape` wird gespeichert, wenn das Geokodierungsergebnis eine Feature-Class ist. Die Felder `Shape X` und `Shape Y` werden gespeichert, wenn das Ergebnis eine `.csv`- oder `.xls`-Datei ist. Minimal—Fügt die folgenden Felder als Beschreibung der Position sowie dem Grad der Übereinstimmung mit Informationen im Locator in den Geokodierungsergebnissen hinzu: `Shape`, `Status`, `Score`, `Match_type`, `Match_addr` und `Addr_type`. Minimal- und Benutzerfelder—Die Felder `MINIMAL` sowie alle benutzerdefinierten Ausgabefelder werden hinzugefügt und in den Geokodierungsergebnissen zurückgegeben.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabe-Feature-Class	Die Ausgabe-Feature-Class.	Feature Class
Ausgabetabelle	Die Ausgabetabelle im CSV- oder XLS-Format, je nach dem ausgewählten Wert Ausgabetyp.	Table

arcpy.geocoding.GeocodeFile(in_table, locator, address_fields, output_type, output_location, output_name, {country}, {location_type}, {category}, {output_fields})

Name	Erläuterung	Datentyp
in_table	Die Eingabetabelle mit den zu geokodierenden Adressen oder Orten im CSV-, XLS- oder XLSX-Format oder eine Tabelle in einer File-Geodatabase.	Record Set
locator	Der Portal-Locator, der zum Geokodieren der Tabelle verwendet werden soll. Sie können einen Locator aus der Liste der Locators im aktiven Portal auswählen oder im aktiven Portal nach anderen verfügbaren Locators suchen. Locators, die im aktiven Portal als Utility-Services festgelegt wurden, sind standardmäßig verfügbar. Hinweis: Der ArcGIS World Geocoding Service ist für dieses Werkzeug deaktiviert. Verwenden Sie das Werkzeug Adressen geokodieren, wenn Sie den ArcGIS World Geocoding Service verwenden möchten.	Address Locator
address_fields	Jede Feldzuordnung dieses Parameters weist das Format `input_locator_field, table_field_name` auf. Hierbei ist `input_locator_field` der Name des vom Locator verwendeten Eingabe-Adressfeldes und `table_field_name` der Name des entsprechenden Feldes in der Adresstabelle, die Sie geokodieren möchten. Sie können ein einzelnes Eingabefeld festlegen, in dem die vollständige Adresse gespeichert wird, zum Beispiel "303 Peachtree St NE, Atlanta, GA 30308". Sie haben auch die Möglichkeit, mehrere Felder anzugeben, wenn die Eingabeadressen in mehrere Felder wie "`Address`", "`City`", "`State`" und "`ZIP`" für eine allgemeine US-amerikanische Adresse unterteilt sind. Ebenfalls angeben können Sie ein einzelnes Feld, in dem die vollständige Adresse gespeichert ist, z. B. 303 Peachtree St NE, Atlanta, GA 30308, und ein Feld, in dem das mit der Adresse verknüpfte Land gespeichert ist, z. B. USA. Einige Locators unterstützen mehrere Eingabe-Adressenfelder wie `Address`, `Address2` und `Address3`. In diesem Fall kann das Adressenelement auf mehrere Felder aufgeteilt werden. Zum Zeitpunkt der Geokodierung werden die Adressfelder dann verkettet. Beispielsweise werden sowohl "100", "Main st" und "Apt 140" als Angabe in drei Feldern als auch "100 Main st" und "Apt 140" in zwei Feldern bei der Geokodierung zu "100 Main st Apt 140" verkettet. Wenn Sie ein optionales, vom Locator verwendetes Eingabe-Adressenfeld keinem Feld in der Eingabe-Adressentabelle zuordnen möchten, wählen Sie wie im unten stehenden Beispiel gezeigt `<None>` anstelle eines Feldnamens.	Field Info
output_type	Gibt den Typ der Datei an, in die die Geokodierungsergebnisse geschrieben werden sollen. `CSV`—Eine `.csv`-Datei wird zurückgegeben. `FEATURE_CLASS`—Eine Feature-Class in einer File-Geodatabase wird zurückgegeben. `XLS`—Eine `.xls`-Datei wird zurückgegeben.	String
output_location	Der Ordner, in den die Ausgabe-Geokodierungsergebnisse geschrieben werden sollen. Wenn die Ausgabe eine `.csv`- oder `.xls`-Datei ist, wird eine Ausgabedatei im angegebenen Ordner abgelegt. Wenn die Ausgabe eine Feature-Class ist, wird eine Ausgabe-File-Geodatabase erstellt und im angegebenen Ordner abgelegt. Die neue File-Geodatabase enthält dann die geokodierte Feature-Class. Die Ausgabe-File-Geodatabase und die Feature-Class in der File-Geodatabase erhalten denselben Namen.	Workspace
output_name	Der Name der Ausgabe mit den geokodierten Ergebnissen.	String
country [country,...] (Optional)	Das Land oder die Länder, auf die die Suche nach den geokodierten Adressen begrenzt wird. Durch die Angabe von Ländern wird in den meisten Fällen die Genauigkeit der Geokodierung verbessert. Wenn kein Land angegeben wird, erfolgt die Geokodierung für alle unterstützten Länder des Locators. Dieser Parameterwert wird überschrieben, wenn ein Feld im Parameterwert `in_table` dem Feld `Country` im Parameter `address_fields` zugeordnet ist. Geben Sie als Wert den aus zwei oder drei Zeichen bestehenden Ländercode in eine kommagetrennte Liste ein. Gültige Eingabewerte finden Sie in der Spalte "Unterstützte Ländercodes".	String
location_type (Optional)	Gibt die bevorzugte Ausgabegeometrie an, die für `PointAddress`-Übereinstimmungen zurückgegeben wird. Wenn die bevorzugte Position in den Daten nicht vorhanden ist, wird die Standardposition `ADDRESS_LOCATION` zurückgegeben. In der ArcGIS REST API-Webhilfe finden Sie Informationen zum Parameter `locationType` für `geocodeAddresses`. `ADDRESS_LOCATION`—Für Geokodierungsergebnisse, die eine Adressposition darstellen, zum Beispiel eine Gebäudeadresse, einen Flurstücksschwerpunkt oder einen Hauseingang, wird eine Geometrie zurückgegeben. Dies ist die Standardeinstellung. `ROUTING_LOCATION`—Gibt für Geokodierungsergebnisse eine Geometrie zurück, die eine Position nahe der Straßenseite, die für das Routing von Fahrzeugen verwendet werden kann, darstellt.	String
category [category,...] (Optional)	Begrenzt die Typen der Orte, nach denen der Locator sucht. Dadurch werden falsche positive Übereinstimmungen und unerwünschte Übereinstimmungen auf Adressenebene verhindert und Koordinatensuchen disambiguiert. Dieser Parameter kann dazu beitragen, den Suchvorgang zu beschleunigen. Wenn keine Kategorie verwendet wird, wird die Geokodierung mithilfe aller unterstützten Kategorien ausgeführt. Nicht alle Kategoriewerte werden für alle Positionen und Länder unterstützt. In der ArcGIS REST API-Webhilfe finden Sie weitere Informationen zum Filtern von Kategorien.	String
output_fields (Optional)	Gibt die Locator-Ausgabefelder an, die in den Geokodierungsergebnissen zurückgegeben werden sollen. Die ursprünglichen Feldnamen aus dem Parameterwert `in_table` werden beibehalten, wenn die Option `LOCATION_ONLY`, `MINIMAL` oder `MINIMAL_AND_USER` angegeben ist. Hinweis: Dieser Parameter kann mit Eingabe-Locators verwendet werden, die mit dem Werkzeug Locator erstellen oder mit dem Werkzeug Feature-Locator erstellen erstellt wurden, das in Enterprise 10.9 oder höher veröffentlicht wurde. Von kombinierten Locators, die mindestens einen Locator enthalten, der mit dem Werkzeug Adressen-Locator erstellen erstellt wurde, wird dieser Parameter nicht unterstützt. `ALL`—Bezieht alle verfügbaren Locator-Ausgabefelder in die Geokodierungsergebnisse ein. Dies ist die Standardeinstellung. `LOCATION_ONLY`—Das Feld `Shape` wird gespeichert, wenn das Geokodierungsergebnis eine Feature-Class ist. Die Felder `Shape X` und `Shape Y` werden gespeichert, wenn das Ergebnis eine `.csv`- oder `.xls`-Datei ist. `MINIMAL`—Fügt die folgenden Felder als Beschreibung der Position sowie dem Grad der Übereinstimmung mit Informationen im Locator in den Geokodierungsergebnissen hinzu: `Shape`, `Status`, `Score`, `Match_type`, `Match_addr` und `Addr_type`. `MINIMAL_AND_USER`—Die Felder `MINIMAL` sowie alle benutzerdefinierten Ausgabefelder werden hinzugefügt und in den Geokodierungsergebnissen zurückgegeben.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_feature_class	Die Ausgabe-Feature-Class.	Feature Class
out_table	Die Ausgabetabelle im CSV- oder XLS-Format, je nach dem ausgewählten Wert Ausgabetyp.	Table

Codebeispiel

GeocodeFile: Beispiel (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht die Verwendung der Funktion GeocodeFile in einem eigenständigen Skript.

Hinweis:

Wenn Sie mit Locators in Ihrem Portal arbeiten, stellen Sie sicher, dass Sie angemeldet sind und das Portal in ArcGIS Pro als aktives Portal festgelegt haben. Um auf einen Locator zuzugreifen, der sich in einem anderen als dem aktiven Portal befindet, führen Sie die Authentifizierung mithilfe der Funktion SignInToPortal durch.

import arcpy

# Input is a local table
input_table = r"C:\data\customers.csv"

# This tool works with locators on a portal
in_locator = "https://<machine_name>/server/rest/services/<service_name>/GeocodeServer/<service_name>"

# The best way to generate a field mapping is to run the tool in ArcGIS
# Pro, right-click the green success ribbon, and click "Copy Python command"

field_mapping = "'Address or Place' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;Neighborhood <None> VISIBLE NONE;City <None> VISIBLE NONE;County <None> VISIBLE NONE;State <None> VISIBLE NONE;ZIP ZIP VISIBLE NONE;ZIP4 <None> VISIBLE NONE;Country <None> VISIBLE NONE"
output_type = "FEATURE_CLASS"

# Output folder for the output CSV, Excel, or GDB table. If you select
# FEATURE_CLASS output_type, a new GDB will be created in the
# output_folder with the geocoding results
output_folder = r"C:\data\outputs"
output_name = "Geocoding_output"

# Optional geocoding parameters. Only some are supported depending on the
# in_locator that you use.
country = None
location_type = "ROUTING_LOCATION"
category = "'Street Address'"

arcpy.geocoding.GeocodeFile(input_table, in_locator, field_mapping, output_type,
                            output_folder, output_name, country, location_type,
                            category)

Umgebungen

Aktueller Workspace, Ausgabe-Koordinatensystem

Lizenzierungsinformationen

Basic: Erfordert, dass Ihr Konto in ArcGIS Enterprise über die Berechtigung "Analyse durchführen" verfügt
Standard: Erfordert, dass Ihr Konto in ArcGIS Enterprise über die Berechtigung "Analyse durchführen" verfügt
Advanced: Erfordert, dass Ihr Konto in ArcGIS Enterprise über die Berechtigung "Analyse durchführen" verfügt

Datei geokodieren (Geocoding Tools)

Zusammenfassung

Verwendung

Hinweis:

Hinweis:

Parameter

Hinweis:

Hinweis:

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen