Zusammenfassung
Mit diesem Werkzeug wird eine Adressentabelle geokodiert. Für diesen Vorgang sind eine Tabelle, in der die zu geokodierenden Adressen gespeichert sind, und ein Adressen-Locator oder ein kombinierter Adressen-Locator erforderlich. Mit diesem Werkzeug werden die Adressen mit dem Locator abgeglichen. Die Ergebnisse werden für jeden Eingabedatensatz in einer neuen Punkt-Feature-Class gespeichert. Für diesen Vorgang werden bei Verwendung des ArcGIS World Geocoding Service möglicherweise Credits verbraucht.
Für das Ausführen von Geokodierungsvorgängen mit dem ArcGIS World Geocoding Service ist eine ArcGIS Online-Organisationssubskription erforderlich. Weiterhin werden dabei Credits verbraucht. Das Organisationskonto muss über ein ausreichendes Credit-Guthaben verfügen, um die gesamte Geokodierungsanforderung durchzuführen.
Verwendung
Sie können Adressen geokodieren, die in einem einzelnen Feld gespeichert oder in mehrere Felder unterteilt sind. Ein einzelnes Eingabefeld speichert die vollständige Adresse, 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.
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.
Die Ausgabe-Feature-Class wird im gleichen Raumbezug wie der Adressen-Locator gespeichert. Um den Raumbezug der Ausgabe-Feature-Class zu ändern, legen Sie in den Umgebungseinstellungen des Werkzeugs ein anderes Ausgabekoordinatensystem fest.
In der Ausgabe-Feature-Class werden standardmäßig eine Kopie der Eingabeadresse und weitere Informationen gespeichert, z. B. Punktzahl, Status und abgeglichene Adresse jedes Datensatzes. Die Adressen können mithilfe des Werkzeugs Adressen erneut abgleichen oder der Option Adressen erneut abgleichen, mit der der Bereich Adressen erneut abgleichen aufgerufen wird, erneut abgeglichen werden. Nachdem der Abgleich abgeschlossen ist und die Feature-Class erstellt wurde, wird das Ergebnis in der Ausgabe-Feature-Class nicht geändert, wenn die Adressen in der Eingabe-Adressentabelle bearbeitet werden.
Weitere Informationen zum erneuten Abgleichen von Geokodierungsergebnissen.
Eine ArcGIS Online for organizations-Subskription ist erforderlich, um eine Adressentabelle mit dem ArcGIS World Geocoding Service abzugleichen.
Syntax
GeocodeAddresses(in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type}, {category})| Parameter | Erklärung | Datentyp |
in_table | Die zu geokodierende Adresstabelle. | Table View |
address_locator | Der für die Geokodierung der Adressentabelle zu verwendende Adressen-Locator. Hinweis:Optional können Sie die Erweiterung .loc nach dem Locator-Namen am Ende des Locator-Pfades einbeziehen. | Address Locator |
in_address_fields [input_address_field, table_field_name] | Jede Feldzuordnung dieses Parameters weist das Format input_address_field, table_field_name auf. Hierbei ist input_address_field der Name des vom Adressen-Locator verwendeten Eingabe-Adressenfeldes und table_field_name der Name des entsprechenden Feldes in der Adressentabelle, die Sie geokodieren möchten. Sie können ein einzelnes Eingabefeld angeben, in dem die vollständige Adresse gespeichert wird, 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. 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 kein optionales, vom Adressen-Locator verwendetes Eingabeadressenfeld zu einem Feld in der Eingabe-Adressentabelle zuordnen möchten, wählen Sie wie im unten stehenden Beispiel gezeigt <Keine> anstelle des Feldnamens. | Field Info |
out_feature_class | Die bzw. das geokodierte Ausgabe-Feature-Class bzw. -Shapefile. | Feature Class |
out_relationship_type (optional) | Ältere Versionen:Dieser Parameter hat in ArcGIS Pro keine Auswirkungen. Er wird aus Gründen der Abwärtskompatibilität mit ArcGIS Desktop beibehalten. In ArcGIS Pro ist nur der Wert STATIC zulässig.
| Boolean |
country [country,...] (optional) | Dieser Parameter ist für Locators verfügbar, die das Land als Parameter unterstützen. Damit wird die Geokodierung auf die ausgewählten Länder beschränkt. Durch die Auswahl von Ländern wird in den meisten Fällen die Genauigkeit der Geokodierung verbessert. Wenn in der Eingabetabelle ein Feld für Länder unter Eingabeadressenfelder dem Feld Country zugeordnet wird, wird mit dem Landeswert in der Eingabetabelle der Parameter Land überschrieben. Dies gilt nur für das ausgewählte Land bzw. die ausgewählten Länder. Wenn kein Land angegeben wird, erfolgt die Geokodierung für alle unterstützten Länder des Locators. Der Eingabewert sollte als dreistelliger Ländercode gemäß ISO 3166-1 angegeben werden. Land wird nicht für alle Locators unterstützt. | String |
location_type (optional) | Gibt die bevorzugte Ausgabegeometrie für POINT_ADDRESS-Übereinstimmungen an. Die Optionen für diesen Parameter lauten ROUTING_LOCATION, d. h. die Straßenseitenposition, die für das Routing verwendet werden kann, oder ADDRESS_LOCATION, d. h. die Position, die den Dach- oder Flurstücksschwerpunkt für die Adresse oder den Hauseingang darstellt. Wenn die bevorzugte Position in den Daten nicht vorhanden ist, wird stattdessen die Standardposition ROUTING_LOCATION zurückgegeben. Bei Geokodierungsergebnissen mit Addr_type = PointAddress beschreiben die XY-Attributwerte die Koordinaten der Adresse entlang der Straße, während die DisplayX- und DisplayY-Werte die Koordinaten für den Dach- bzw. den Gebäudeschwerpunkt beschreiben. In der REST-API-Webhilfe finden Sie weitere Informationen zum Parameter "locationType" für "reverseGeocode". Dieser Parameter wird nicht für alle Locators unterstützt.
| String |
category [category,...] (optional) | Begrenzt die Typen der Orte, nach denen der Locator sucht. Dadurch werden falsche positive Übereinstimmungen verhindert und der Suchvorgang potenziell beschleunigt. Wenn keine Kategorie verwendet wird, wird die Geokodierung für alle unterstützten Kategorien ausgeführt. Nicht alle Kategoriewerte werden für alle Positionen und Länder unterstützt. Generell kann der Parameter für Folgendes verwendet werden:
Dieser Parameter wird nicht für alle Locators unterstützt. In der REST-API-Webhilfe finden Sie weitere Informationen zum Filtern von Kategorien. | String |
Codebeispiel
Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion GeocodeAddresses zum Geokodieren einer Adressentabelle mit einem lokalen Locator verwenden.
import arcpy
arcpy.env.workspace = "C:\ArcTutor\Geocoding\atlanta"
# Set local variables
address_table = "customers.dbf"
address_locator = "Atlanta_AddressLocator"
address_fields = "Street Address;City City;State State;ZIP Zip"
geocode_result = "geocode_result.shp"
arcpy.GeocodeAddresses_geocoding(address_table, address_locator,
address_fields, geocode_result,
'STATIC')Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion GeocodeAddresses zum Geokodieren einer Adressentabelle mit einem Server-Locator über eine AGS-Verbindung verwenden.
import arcpy
# Set local variables:
address_table = r"C:\data\Atlanta.gdb\customers"
address_locator = r"C:\ags_connections\server_name.ags\Atlanta.GeocodeServer"
address_fields = "Street Address;City City;State State;ZIP Zip"
geocode_result = r"C:\outputs\geocode_result.shp"
arcpy.GeocodeAddresses_geocoding(address_table, address_locator,
address_fields, geocode_result,
'STATIC')Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion GeocodeAddresses zum Geokodieren einer Adressentabelle mit einem Portal-Locator verwenden.
import arcpy
arcpy.SignInToPortal("https://machinename.domain.com/portal", "username", "password")
# Set local variables
address_table = r"C:\data\Atlanta.gdb\customers"
address_locator = "https://machinename.domain.com/server/rest/services/service_name/GeocodeServer/service_name"
address_fields = "Street Address;City City;State State;ZIP Zip"
geocode_result = r"C:\outputs\geocode_result.shp"
arcpy.GeocodeAddresses_geocoding(address_table, address_locator,
address_fields, geocode_result,
'STATIC')Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja