Adressen geokodieren (Geocoding)

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 diesen Werkzeug werden die gespeicherten Adressen mit dem 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.

Für das Ausführen von Geokodierungsvorgängen mit dem ArcGIS World Geocoding Service ist eine ArcGIS-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, in mehrere Felder unterteilt oder in ein einzelnes Feld und ein Länderfeld aufgeteilt 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 ein einzelnes Feld, in dem die vollständige Adresse 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.

  • 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, die im 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.

Parameter

BeschriftungErläuterungDatentyp
Eingabetabelle

Die zu geokodierende Adresstabelle.

Table View
Eingabe-Adressen-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
Eingabe-Adressfelder

Die Zuordnung der vom Adressen-Locator verwendeten Adressenfelder zu den Feldern in der Eingabe-Adressentabelle. Wählen Sie Einzelnes Feld, wenn die vollständige Adresse in einem Feld der Eingabetabelle gespeichert ist, z. B. 303 Peachtree St NE, Atlanta, GA 30308. Wählen Sie Mehrere Felder aus, wenn die Eingabeadressen in mehrere Felder wie Address, City, State und ZIP für eine allgemeine US-amerikanische Adresse unterteilt sind. Wählen Sie Ein Feld und Länderfeld aus, wenn die vollständige Adresse und das zugehörige Land in verschiedene Felder aufgeteilt sind, z. B. Address (303 Peachtree St NE, Atlanta, GA 30308) und Country (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 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
Ausgabe-Feature-Class

Die bzw. das geokodierte Ausgabe-Feature-Class bzw. -Shapefile.

Feature Class
Dynamische Ausgabe-Feature-Class
(optional)

Dieser Parameter ist in ArcGIS Pro nicht aktiv. Er wird aus Gründen der Abwärtskompatibilität mit ArcGIS Desktop beibehalten.

Boolean
Land
(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 eines Landes wird in den meisten Fällen die Geokodierungsgenauigkeit verbessert. Wenn Sie für den Parameter Eingabe-Adressfelder die Option Ein Feld und Länderfeld auswählen und im Parameter Eingabetabelle ein Feld, das Länder darstellt, dem Feld Country des Parameters Eingabe-Adressfelder zuordnen, wird mit dem Landeswert aus dem Parameter 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 unter Verwendung aller unterstützten Länder des Locators.

Der Parameter Land wird nicht für alle Locators unterstützt.

String
Bevorzugter Standorttyp
(optional)

Gibt die bevorzugte Ausgabegeometrie für PointAddress-Übereinstimmungen an. Die Optionen für diesen Parameter lauten Routenposition, d. h. die Straßenseitenposition, die für das Routing verwendet werden kann, oder Adressenposition, d. h. die Position, die den Dach- oder Flurstücksschwerpunkt für die Adresse darstellt. 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 den Dach- bzw. den Gebäudeschwerpunkt beschreiben.

Dieser Parameter wird nicht für alle Locators unterstützt.

  • AdresspositionFür Geokodierungsergebnisse wird eine Geometrie zurückgegeben, die eine Adressenposition, wie z. B. eine Dachposition, einen Flurstücksschwerpunkt oder einen Hauseingang, darstellt.
  • RoutenpositionGibt 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. Dies ist die Standardeinstellung.
String
Kategorie
(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 unter Verwendung aller 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:

  • Begrenzen von Übereinstimmungen auf bestimmte Ortstypen oder Adressebenen
  • Vermeiden eines Sicherungsabgleichs für unerwünschte Adressebenen
  • Eindeutige Koordinatensuchvorgänge

Dieser Parameter wird nicht für alle Locators unterstützt.

In der ArcGIS REST API-Webhilfe finden Sie weitere Informationen zum Filtern von Kategorien.

String
Ausgabefelder
(optional)

Gibt an, welche Locator-Ausgabefelder in den Geokodierungsergebnissen zurückgegeben werden.

  • AlleBezieht alle verfügbaren Locator-Ausgabefelder in die Geokodierungsergebnisse ein. Dies ist die Standardeinstellung.
  • Nur PositionSpeichert das Shape-Feld in den Geokodierungsergebnissen. Die ursprünglichen Felder aus dem Parameter Eingabetabelle werden mit ihren ursprünglichen Feldnamen beibehalten.
  • MinimalFü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. Die ursprünglichen Feldnamen aus dem Parameter Eingabetabelle werden beibehalten.
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 auf der Festplatte gespeichert ist oder 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.

String

arcpy.geocoding.GeocodeAddresses(in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type}, {category}, {output_fields})
NameErläuterungDatentyp
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-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 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)
Vorversion:

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.

  • STATICEs wird eine statische Kopie der Eingabe-Adressenfelder in der Ausgabe-Feature-Class erstellt. Dies ist der einzige zulässige Wert.
  • DYNAMICDiese Option ist in ArcGIS Pro nicht von Belang. Weitere Informationen zu diesem Werkzeug finden Sie unter ArcGIS Desktop.
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 eines Landes wird in den meisten Fällen die Geokodierungsgenauigkeit verbessert. Wenn im Parameter in_table ein Feld, das Länder darstellt, dem Feld Country im Parameter input_address_field zugeordnet wird, wird mit dem Landeswert aus dem Parameter in_table der Parameter country überschrieben.

Dies gilt nur für das angegebene Land bzw. die angegebenen Länder. Wenn kein Land angegeben wird, erfolgt die Geokodierung unter Verwendung aller unterstützten Länder des Locators.

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".

Der Parameter Country 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 ArcGIS REST API-Webhilfe finden Sie Informationen zum Parameter locationType für geocodeAddresses.

Dieser Parameter wird nicht für alle Locators unterstützt.

  • ADDRESS_LOCATIONFür Geokodierungsergebnisse wird eine Geometrie zurückgegeben, die eine Adressenposition, wie z. B. eine Dachposition, einen Flurstücksschwerpunkt oder einen Hauseingang, darstellt.
  • ROUTING_LOCATIONGibt 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. Dies ist die Standardeinstellung.
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 unter Verwendung aller 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:

  • Begrenzen von Übereinstimmungen auf bestimmte Ortstypen oder Adressebenen
  • Vermeiden eines Sicherungsabgleichs für unerwünschte Adressebenen
  • Eindeutige Koordinatensuchvorgänge

Dieser Parameter wird nicht für alle Locators unterstützt.

In der ArcGIS REST API-Webhilfe finden Sie weitere Informationen zum Filtern von Kategorien.

String
output_fields
(optional)

Gibt an, welche Locator-Ausgabefelder in den Geokodierungsergebnissen zurückgegeben werden.

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 auf der Festplatte gespeichert ist oder 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.

  • ALLBezieht alle verfügbaren Locator-Ausgabefelder in die Geokodierungsergebnisse ein. Dies ist die Standardeinstellung.
  • LOCATION_ONLYSpeichert das Shape-Feld in den Geokodierungsergebnissen. Die ursprünglichen Felder aus dem Parameter in_table werden mit ihren ursprünglichen Feldnamen beibehalten.
  • MINIMALFü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. Die ursprünglichen Feldnamen aus dem Parameter in_table werden beibehalten.
String

Codebeispiel

GeocodeAddresses – Beispiel (eigenständiges Skript)

Das folgende Skript veranschaulicht, wie Sie die Funktion GeocodeAddresses zum Geokodieren einer Adressentabelle mit einem lokalen Locator verwenden.

import arcpy

arcpy.env.workspace = "C:\Geocoding\atlanta"

# Set local variables
table = "customers.dbf"
locator = "Atlanta_AddressLocator.loc"
field_map = ("\'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 <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
                  "Country <None> VISIBLE NONE")
geocode_result = "geocode_result.shp"

arcpy.GeocodeAddresses_geocoding(table, locator, 
                                 field_map, geocode_result)
GeocodeAddresses – Beispiel 2 (eigenständiges Skript)

Das folgende Skript veranschaulicht, wie Sie die Funktion GeocodeAddresses zum Geokodieren einer Adressentabelle mit einem Server-Locator über eine AGS-Verbindung verwenden.

import arcpy

# Set local variables:
table = r"C:\data\Atlanta.gdb\customers"
locator = r"C:\ags_connections\server_name.ags\Atlanta.GeocodeServer"
field_map = "'Single Line Input' SingleLine VISIBLE NONE"
geocode_result = r"C:\outputs\geocode_result.shp"

arcpy.GeocodeAddresses_geocoding(table, locator,
                                 field_map, geocode_result)
GeocodeAddresses – Beispiel 3 (eigenständiges Skript)

Das folgende Skript veranschaulicht, wie Sie die Funktion GeocodeAddresses zum Geokodieren einer Adressentabelle mit einem Portal-Locator verwenden.

Hinweis:

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

import arcpy

# Set local variables
table = r"C:\data\Atlanta.gdb\customers"
locator = "https://machinename.domain.com/server/rest/services/service_name/GeocodeServer/portal_item_name"
field_map = ("\'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 <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
                  "Country <None> VISIBLE NONE")
geocode_result = r"C:\outputs\geocode_result.shp"

arcpy.GeocodeAddresses_geocoding(table, locator, field_map, geocode_result)
GeocodeAddresses – Beispiel 4 (eigenständiges Skript)

Das folgende Skript veranschaulicht, wie Sie die Funktion GeocodeAddresses zum Geokodieren einer Adressentabelle mit dem ArcGIS World Geocoding Service verwenden.

Hinweis:

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

Hinweis:

Für diesen Vorgang werden bei Verwendung des ArcGIS World Geocoding Service möglicherweise Credits verbraucht.

import arcpy

# Set local variables
table = r"C:\data\Addresses.csv"

locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"

field_map = ("\'Address or Place\' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;" +
             "Neighborhood <None> VISIBLE NONE;City <None> VISIBLE NONE;Subregion <None> VISIBLE NONE;" +
             "Region <None> VISIBLE NONE;ZIP ZIP <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
             "Country <None> VISIBLE NONE")

geocode_result = r"C:\outputs\geocode_result.shp"

arcpy.GeocodeAddresses_geocoding(table, locator, field_map, geocode_result)
GeocodeAddresses – Beispiel 5 (eigenständiges Skript)

Das folgende Skript veranschaulicht, wie Sie die Funktion GeocodeAddresses zum Geokodieren einer Adressentabelle mit dem ArcGIS World Geocoding Service verwenden, wenn sich alle Adressendaten in demselben Feld und die Landesdaten in einem weiteren Feld befinden.

Hinweis:

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

Hinweis:

Für diesen Vorgang werden bei Verwendung des ArcGIS World Geocoding Service möglicherweise Credits verbraucht.

import arcpy

# Set local variables
table = r"C:\Data\MyDatabase.gdb\DistributionCenters"

locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"

field_map = "'Single Line Input' SingleLine VISIBLE NONE;Country Country VISIBLE NONE"

geocode_result = r"C:\Data\MyDatabase.gdb\DistributionCenters_Geocoded"

arcpy.geocoding.GeocodeAddresses(table, locator, field_map, geocode_result)

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen