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 Adressen-Locator abgeglichen. Die Ergebnisse werden für jeden Eingabedatensatz in einer neuen Point-Feature-Class gespeichert. Für diesen Vorgang werden bei Verwendung des ArcGIS World Geocoding Service möglicherweise Credits verbraucht.
Abbildung
Verwendung
Sie können Adressen geokodieren, die in einem einzelnen Feld gespeichert oder in mehrere Felder unterteilt sind. Die vollständige Adresse ist in einem einzelnem 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.
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 miteinander verkettet. Beispielsweise werden sowohl 100, Main St und Apt 140 in drei Feldern als auch 100 Main St und Apt 140 in zwei Feldern bei der Geokodierung zu 100 Main St Apt 140.
Die Ausgabe-Feature-Class wird im gleichen Raumbezug wie der Adressen-Locator gespeichert. Sie können den Raumbezug der Ausgabe-Feature-Class ändern, indem Sie in den Umgebungseinstellungen des Werkzeugs ein anderes Ausgabe-Koordinatensystem festlegen.
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 des Dialogfeldes Interaktiv neu abgleichen in ArcMap 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.
Setzen Sie den Parameter Dynamische Ausgabe-Feature-Class auf "True" (aktiviert), wenn das entsprechende Ergebnis in der Ausgabe-Feature-Class automatisch aktualisiert werden soll, sobald die Eingabe-Adressentabelle aktualisiert wird. Für die Eingabetabelle und die Ausgabe-Feature-Class wird eine Beziehungsklasse erstellt. Wenn eine Adresse in der Eingabetabelle in einer Editiersitzung in ArcMap geändert wird, wird die Adresse unmittelbar neu geokodiert, und der in Beziehung stehende Datensatz in der Ausgabe-Feature-Class wird mit dem neuen Geokodierungsergebnis aktualisiert. Die automatische Aktualisierung wird auch beim Hinzufügen eines neuen Datensatzes oder Löschen eines vorhandenen Datensatzes in der Eingabetabelle unterstützt.
Eine ArcGIS Online for organizations-Subskription ist erforderlich, um eine Adressentabelle mit dem ArcGIS World Geocoding Service abzugleichen. Weitere Informationen finden Sie unter Arbeiten mit dem ArcGIS Online World Geocoding Service.
Syntax
arcpy.geocoding.GeocodeAddresses(in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type})| 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. | 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 verschiedene 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 miteinander verkettet. Beispielsweise werden sowohl 100, Main St und Apt 140 in drei Feldern als auch 100 Main St und Apt 140 in zwei Feldern bei der Geokodierung zu 100 Main St Apt 140. Wenn Sie ein optionales, vom Adressen-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 |
out_feature_class | Die bzw. das geokodierte Ausgabe-Feature-Class bzw. -Shapefile. | Feature Class |
out_relationship_type (optional) | Gibt an, ob in der geokodierten Feature-Class eine statische Kopie der Adressentabelle erstellt werden soll oder ob eine dynamische Feature-Class erstellt werden soll, die automatisch aktualisiert wird.
| Boolean |
country [country,...] (optional) | Die Geokodierung wird auf die ausgewählten Länder beschränkt. Wenn kein Land verwendet wird, wird die Geokodierung für alle unterstützten Länder ausgeführt. Durch die Auswahl von Ländern wird in den meisten Fällen die Genauigkeit der Geokodierung verbessert. Wenn ein Feld für Länder in der Eingabetabelle vorhanden und dem Eingabeadressenfeld CountryCode zugeordnet wird, wird mit dem Landeswert in der Eingabetabelle der Parameter Land überschrieben. Der Eingabewert sollte als dreistelliger Ländercode gemäß ISO 3166-1 angegeben werden. Dieser Parameter wird nicht für alle Locators unterstützt. | String |
location_type (optional) | Gibt die bevorzugte Ausgabegeometrie für PointAddress-Übereinstimmungen an. Die verfügbaren Optionen sind die Straßenseitenposition, die für das Routing verwendet werden kann, oder der Dach- bzw. Flurstücksschwerpunkt für die Adresse. Wenn die bevorzugte Position in den Daten nicht vorhanden ist, wird stattdessen die Standardposition 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 das Dach bzw. den Gebäudeschwerpunkt beschreiben. In der REST-API-Webhilfe finden Sie weitere Informationen zum Parameter locationType für GeocodeAddresses. Dieser Parameter wird nicht für alle Locators unterstützt.
| String |
Codebeispiel
GeocodeAddresses – Beispiel (Python-Fenster)
Das folgende Skript im Python-Fenster veranschaulicht, wie die Funktion GeocodeAddress im unmittelbaren Modus mit mehrzeiliger Geokodierung verwendet wird.
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/Atlanta.gdb"
# Set local variables:
address_table = "customers"
address_locator = "C:/ArcTutor/Geocoding/Atlanta"
address_fields = "Street Address;City City;State State;ZIP Zip"
geocode_result = "geocode_result"
arcpy.GeocodeAddresses_geocoding(address_table, address_locator, address_fields,
geocode_result, 'STATIC')
GeocodeAddresses – Beispiel (Python-Fenster)
Das folgende Skript im Python-Fenster veranschaulicht, wie die Funktion GeocodeAddress im unmittelbaren Modus mit einzeiliger Geokodierung verwendet wird.
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/Atlanta.gdb"
# Set local variables:
address_table = "customers"
address_locator = "C:/ArcTutor/Geocoding/Atlanta"
address_fields = "'Single Line Input' SINGLELINE"
geocode_result = "singleline_geocode_result"
arcpy.GeocodeAddresses_geocoding(address_table, address_locator, address_fields,
geocode_result, 'STATIC')
Umgebungen
Lizenzinformationen
- Basic: Eingeschränkt
- Standard: Ja
- Advanced: Ja