Batch-Geokodierung (Geocoding Tools)

Zusammenfassung

Geokodiert asynchron eine große Tabelle oder .csv-Datei mit Adressen oder Orten unter Verwendung der REST API "batchGeocode". Die geokodierten Ergebnisse werden als Feature-Class zurückgegeben. ArcGIS Pro ist nicht erforderlich, um die Anforderung in kleinere Batches zu unterteilen.

Bei der Verwendung dieses Werkzeugs kann die Geokodierung isoliert und unabhängig von anderen Prozessen auf dem Server skaliert werden. Wenn Sie beispielsweise einen Auftrag an den ArcGIS World Geocoding Service übermitteln, wird dedizierte Hardware zugewiesen, um die Datei zu verarbeiten. Dadurch wird die Reaktionszeit verkürzt. Sie können zwischen dem ArcGIS World Geocoding Service und einem in ArcGIS Enterprise on Kubernetes 11.5 oder höher mit Ihrem konfigurierten Kubernetes-Cluster gehosteten Service wählen.

Hinweis:

Für das Ausführen von Geokodierungsvorgängen mit ArcGIS World Geocoding Service ist ein ArcGIS-Organisationskonto erforderlich. Hierfür werden Credits verbraucht. Das Organisationskonto muss über ein ausreichendes Credit-Guthaben verfügen, um die gesamte Geokodierungsanforderung durchzuführen.

Die Credit-Schätzung wird oben im Werkzeug im Bereich Geoverarbeitung angezeigt, wenn ArcGIS Online das aktive Portal ist.

Verwendung

Wenn der ArcGIS World Geocoding Service als Wert des Parameters Eingabe-Batch-Service verwendet wird, dann muss die Eingabetabelle oder -datei mindestens 100.000 Datensätze enthalten.
Wenn der ArcGIS World Geocoding Service als Wert des Parameters Eingabe-Batch-Service verwendet wird, dann wird der Wert des Parameters Eingabetabelle vorübergehend in Ihrem ArcGIS Online-Portal gespeichert, bis der Auftrag abgeschlossen ist. Nachdem der Auftrag abgeschlossen wurde, wird diese temporäre Datei wieder aus dem Portal gelöscht.
Die maximale Anzahl von Datensätzen, die von diesem Werkzeug unterstützt werden, beträgt 50 Millionen. Wenn die Tabelle 50 Millionen Datensätze überschreitet, teilen Sie die Tabelle in mehrere Tabellen mit 50 Millionen oder weniger Datensätzen auf. Wenn es sich bei der Eingabe um eine .csv-Datei handelt, muss die UTF-8-Encodierung mit einer Bytereihenfolgemarke (Byte Order Mark, BOM) verwendet werden.

Hinweis:

Sie können eine Anwendung eines Drittanbieters (z. B. Microsoft Excel oder Notepad++) verwenden, um der .csv-Datei eine UTF-8-BOM hinzuzufügen.
Die erste Zeile der .csv-Eingabedatei wird zusätzlich zu den vom Locator angehängten Feldern für die Feldnamen in der Ausgabe-Feature-Class verwendet. Feldnamen dürfen keine Leerzeichen und mit Ausnahme eines Unterstrichs auch keine Sonderzeichen enthalten.

Hinweis:

Bei der Verwendung des Werkzeugs in Python muss für die Feldzuordnung mit dem Parameter table_field_name in den Feldern des Parameterwertes input_address_field die gleiche Schreibweise (Groß- oder Kleinschreibung) verwendet werden wie in den Feldern des Parameterwertes address_fields.
Wenn der Locator in ArcGIS Enterprise on Kubernetes mit aktivierter Funktion "Batch-Geokodierung" veröffentlicht wird, werden zwei Services erstellt: ein GeocodeServer-Service und ein GPServer-Service. Bei der Verwendung des Werkzeugs in Python muss der Parameterwert in_batch_service der GPServer sein, z. B. https://machinename.domain.com/server/rest/services/service_name/GPServer.
Die Geokodierungsergebnisse werden im gleichen Raumbezug wie der Service gespeichert. Sie können den Raumbezug der Ausgabe ändern, indem Sie den Umgebungsparameter "Ausgabe-Koordinatensystem" festlegen.
Die Geokodierungsergebnisse enthalten alle relevanten Geokodierungsinformationen, darunter Punktzahl, Status und die abgeglichenen Adressen der einzelnen Datensätze, sowie die Werte aus der ursprünglichen Eingabetabelle oder -datei. Die Geokodierungsergebnisse aus diesem Werkzeug enthalten einen statischen Snapshot der ursprünglichen Eingabetabelle. Deshalb werden die Ergebnisse in der Ausgabe-Feature-Class nach dem Hinzufügen oder Aktualisieren von Werten in der ursprünglichen Tabelle nicht aktualisiert. Führen Sie das Werkzeug erneut aus, um eine Ausgabe-Feature-Class mit diesen Änderungen zu erstellen.
Die folgenden Parameter werden nicht für alle Batch-Services unterstützt, die für den Parameterwert Eingabe-Batch-Service verwendet werden: Land bzw. Region, Bevorzugter Positionstyp und Kategorie.
Bei diesem Werkzeug wird keine Auswahl unterstützt. Um einen Teil einer Tabelle zu geokodieren, exportieren Sie den entsprechenden Tabellenteil, und führen Sie das Werkzeug bei der neuen, kleineren Tabelle aus.

Beschriftung	Erläuterung	Datentyp
Eingabetabelle	Die Tabelle oder `.csv`-Datei mit den Adressen oder Orten, die geokodiert werden sollen.	Table View
Eingabe-Batch-Service	Der Geokodierungsservice im Portal mit Unterstützung für die Batch-Geokodierung, der zum Geokodieren der Tabelle mit den Adressen und Orten verwendet wird. Hinweis: Wenn es sich bei dem Service um einen benutzerdefinierten Locator oder einen ArcGIS StreetMap Premium-Locator handelt, muss er in ArcGIS Enterprise on Kubernetes 11.5 oder höher mit aktivierter Funktion "Batch-Geokodierung" veröffentlicht werden.	String
Adressfeldzuordnung	Die Zuordnung der vom Locator verwendeten Adressenfelder zu den Feldern in der Eingabe-Adressentabelle oder -datei. Geben Sie Einzelnes Feld an, wenn die vollständige Adresse in einem Feld der Eingabetabelle oder -datei 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 und das Land in separate Felder unterteilt sind, z. B. `Address` (303 Peachtree St NE, Atlanta, GA 30308) und `Country` (USA). Einige Locators unterstützen mehrere Eingabe-Adressfelder 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 kein optionales, vom Adressen-Locator verwendetes Eingabeadressenfeld zu einem Feld in der Eingabe-Adressentabelle oder -datei zuordnen möchten, wählen Sie wie im unten stehenden Beispiel gezeigt <None> anstelle des Feldnamens aus.	Field Info
Ausgabe-Feature-Class	Die geokodierte Ausgabe-Feature-Class. Hinweis: Das Speichern der Ausgabe im Shapefile-Format wird aufgrund der Shapefile-Beschränkungen nicht unterstützt.	Feature Class
Land bzw. Region	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 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. Alle—Bezieht alle verfügbaren Locator-Ausgabefelder in die Geokodierungsergebnisse ein. Dies ist die Standardeinstellung. Nur Position—Speichert das `Shape`-Feld in den Geokodierungsergebnissen. 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
Abgleichnarrativ (Optional)	Gibt an, wie das Abgleichnarrativ in die Ausgabe der geokodierten Feature-Class zurückgegeben werden soll. Wenn kein Parameterwert angegeben ist, wird die Locator-Eigenschaftseinstellung "Abgleichnarrativ einbeziehen" verwendet. Dieser Parameter kann dabei helfen, besser zu verstehen, wie Adressen in der geokodierten Feature-Class abgeglichen wurden. Abgleichnarrativ zur Ausgabe hinzufügen—Der geokodierten Feature-Class wird ein Feld namens `MatchNarrative` hinzugefügt. Dieses Feld enthält den Text des Abgleichnarrativs für jede abgeglichene Adresse. Abgleichnarrativ in Felder aufteilen—Der Text des Abgleichnarrativs für ein einzelnes Feld wird aus dem JSON-Objekt abgerufen. Der Text des Abgleichnarrativs wird geparst, in einzelne Felder aufgeteilt und an die geokodierte Feature-Class angehängt.	String

arcpy.geocoding.BatchGeocode(in_table, in_batch_service, address_fields, out_feature_class, country, {location_type}, {category}, {output_fields}, {match_narrative})

Name	Erläuterung	Datentyp
in_table	Die Tabelle oder `.csv`-Datei mit den Adressen oder Orten, die geokodiert werden sollen.	Table View
in_batch_service	Der Geokodierungsservice im Portal mit Unterstützung für die Batch-Geokodierung, der zum Geokodieren der Tabelle mit den Adressen und Orten verwendet wird. Hinweis: Wenn es sich bei dem Service um einen benutzerdefinierten Locator oder einen ArcGIS StreetMap Premium-Locator handelt, muss er in ArcGIS Enterprise on Kubernetes 11.5 oder höher mit aktivierter Funktion "Batch-Geokodierung" veröffentlicht werden.	String
address_fields	Jede Feldzuordnung dieses Parameters weist das Format `input_address_field, table_field_name` auf. Hierbei ist `input_address_field` der Name des vom Locator verwendeten Eingabe-Adressfeldes und `table_field_name` der Name des entsprechenden Feldes oder Datei in der Adresstabelle, die Sie geokodieren möchten. Geben Sie ein einzelnes Eingabefeld an, wenn die vollständige Adresse in einem Feld im Wert `in_table` gespeichert ist (z. B. 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 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 Adressen-Locator verwendetes Eingabe-Adressenfeld keinem Feld in der Eingabe-Adressentabelle oder -Datei zuordnen möchten, wählen Sie wie im unten stehenden Beispiel gezeigt `<None>` anstelle eines Feldnamens.	Field Info
out_feature_class	Die geokodierte Ausgabe-Feature-Class. Hinweis: Das Speichern der Ausgabe im Shapefile-Format wird aufgrund der Shapefile-Beschränkungen nicht unterstützt.	Feature Class
country [country,...]	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 unter Verwendung aller 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. `ALL`—Bezieht alle verfügbaren Locator-Ausgabefelder in die Geokodierungsergebnisse ein. Dies ist die Standardeinstellung. `LOCATION_ONLY`—Speichert das `Shape`-Feld in den Geokodierungsergebnissen. `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
match_narrative [match_narrative,...] (Optional)	Gibt an, wie das Abgleichnarrativ in die Ausgabe der geokodierten Feature-Class zurückgegeben werden soll. Wenn kein Parameterwert angegeben ist, wird die Locator-Eigenschaftseinstellung "Abgleichnarrativ einbeziehen" verwendet. Dieser Parameter kann dabei helfen, besser zu verstehen, wie Adressen in der geokodierten Feature-Class abgeglichen wurden. `ADD_MATCH_NARRATIVE`—Der geokodierten Feature-Class wird ein Feld namens `MatchNarrative` hinzugefügt. Dieses Feld enthält den Text des Abgleichnarrativs für jede abgeglichene Adresse. `SPLIT_MATCH_NARRATIVE`—Der Text des Abgleichnarrativs für ein einzelnes Feld wird aus dem JSON-Objekt abgerufen. Der Text des Abgleichnarrativs wird geparst, in einzelne Felder aufgeteilt und an die geokodierte Feature-Class angehängt.	String

Codebeispiel

BatchGeocode: Beispiel 1 (eigenständiges Skript)

Das folgende Skript veranschaulicht, wie Sie die Funktion BatchGeocode zum Geokodieren einer .csv-Datei mit dem ArcGIS World Geocoding Service verwenden und MINIMAL output_fields im Geokodierungsergebnis zurückgeben.

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.

Hinweis:

Bei Verwendung mit ArcGIS World Geocoding Service kann dieser Vorgang Credits verbrauchen.

import arcpy

# Set local variables

# Input is a local file
in_table = r"C:\data\customers.csv"

# Sign in to Portal
#arcpy.SignInToPortal("https://www.arcgis.com.", "MyUsername", "MyPassword")

in_batch_service = "https://geocode.arcgis.com/arcgis/rest/services/World/GPServer/BatchGeocode/"

# One way to generate the value for the field mapping parameter is to first run the tool in ArcGIS
# Pro and right-click the green success ribbon and click "Copy Python command"
# The table_field_name fields must be in the same case as the input_address_field fields.

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

geocode_result = r"C:\Mydata\results.gdb\geocode_results"

# Optional geocoding parameters. Only some are supported depending on the in_batch_service that you use.
country = USA
location_type = "ADDRESS_LOCATION"
category = "'Point Address'"
output_fields = "MINIMAL"

arcpy.geocoding.BatchGeocode(in_table, in_batch_service, address_fields, geocode_result,
                             country, location_type, category, output_fields)

BatchGeocode: Beispiel 2 (eigenständiges Skript)

Das folgende Skript veranschaulicht, wie Sie die Funktion BatchGeocode zum Geokodieren einer Tabelle mit einem Portal-Batch-Service und den standardmäßigen output_fields im Geokodierungsergebnis verwenden.

Hinweis:

import arcpy

# Set local variables

# Input is a local file
in_table = r"C:\data\mytables.gdb\restaurants"

in_batch_service = "https://machinename.domain.com/server/rest/services/service_name/GPServer/"

# One way to generate the value for the field mapping parameter is to first run the tool in ArcGIS
# Pro and right-click the green success ribbon and click "Copy Python command"
# The table_field_name fields must be in the same case as the input_address_field fields.

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

geocode_result = r"C:\My_Output.gdb\geocode_result"

# Optional geocoding parameters. Only some are supported depending on the in_batch_service that you use.
country = USA
location_type = "ROUTING_LOCATION"
category = "'Point Address'"
output_fields = "ALL"

arcpy.geocoding.BatchGeocode(in_table, in_batch_service, address_fields, geocode_result,
                             country, location_type, category, output_fields)

Umgebungen

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

Batch-Geokodierung (Geocoding Tools)

Zusammenfassung

Hinweis:

Verwendung

Hinweis:

Hinweis:

Parameter

Hinweis:

Hinweis:

Umgebungen

Lizenzierungsinformationen

Verwandte Themen