Rückwärts-Geokodierung (Geocoding)—ArcGIS Pro

Zusammenfassung

Mit diesem Werkzeug werden Adressen aus Punktpositionen in einer Feature-Class erstellt. Bei der Rückwärts-Geokodierung wird anhand der angegebenen Suchentfernung die nächstgelegene Adresse oder Kreuzung für die Punktposition gesucht. 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

Die Eingabe-Feature-Class muss Punkt-Shapes mit gültigen XY-Koordinaten enthalten. Für Punkte mit NULL-Koordinaten werden keine Ergebnisse zurückgegeben.
Die Ausgabe-Feature-Class enthält dieselbe Anzahl von Datensätzen wie die Eingabe-Feature-Class. Der Feature-Class werden weitere Felder mit den Ergebnisadressen oder -orte hinzugefügt. Die Namen dieser Felder erhalten das Präfix REV_. Wenn kein übereinstimmender Ort oder keine übereinstimmende Adresse gefunden werden kann, enthalten die Felder leere Werte.
Wenn der Raumbezug der Eingabe-Feature-Class nicht dem Raumbezug des Locators entspricht, wandelt der Locator die Koordinaten bei der Verarbeitung um und versucht eine Übereinstimmung zu finden. Die Ausgabe-Feature-Class wird im gleichen Raumbezug wie die Eingabe-Feature-Class gespeichert. Um den Raumbezug der Ausgabe-Feature-Class zu ändern, legen Sie in den Umgebungseinstellungen des Werkzeugs ein anderes Ausgabe-Koordinatensystem fest.
Wenn für einen Punkt in der Eingabe-Feature-Class kein übereinstimender Ort oder keine übereinstimmende Adresse zurückgegeben wird, bedeutet dies, dass der Locator keine Features enthält, die dem Eingabepunkt zugeordnet werden können. Nachfolgend finden Sie häufige Ursachen für Punkte ohne Übereinstimmung:
- Der Punkt enthält NULL-Koordinaten.
- Die Koordinaten des Punktes sind fehlerhaft und können nicht in den Raumbezug umgewandelt werden, der im Locator verwendet wird.
- Der Locator enthält keine Referenz-Features in dem Bereich, die dem Punkt zugeordnet werden können.
- Es wurde ein Feature-Typ angegeben, für den es in angemessener Entfernung keine guten Übereinstimmungen gibt.
Für die Rückwärts-Geokodierung einer Feature-Class mit dem ArcGIS Online for organizations ist eine ArcGIS World Geocoding Service-Subskription erforderlich.

Parameter

Beschriftung	Erläuterung	Datentyp
Eingabe-Feature-Class oder Layer	Eine Point-Feature-Class oder ein Layer, aus der bzw. dem übereinstimmende Orte oder Adressen anhand der Punktposition des Features zurückgegeben werden.	Feature Layer
Eingabe-Adressen-Locator	Der Locator, der für die Rückwärts-Geokodierung der Eingabe-Feature-Class oder des Layers verwendet wird.	Address Locator
Ausgabe-Feature-Class	Die Ausgabe-Feature-Class.	Feature Class
Ausgabe-Adressentyp (optional)	Gibt an, ob Adressen für die Punkte als Straßenadressen oder Kreuzungsadressen zurückgegeben werden sollen, sofern der Locator den Abgleich von Kreuzungsadressen unterstützt. Adresse—Adressen werden als Straßenadressen im vom Eingabe-Adressen-Locator definierten Format zurückgegeben. Dies ist die Standardeinstellung. Kreuzung—Adressen werden als Kreuzungsadressen zurückgegeben. Diese Option ist verfügbar, wenn der Adressen-Locator den Abgleich von Kreuzungsadressen unterstützt. Vorversion: Dieser Parameter trifft nur auf Locators zu, die mit dem Werkzeug Adressen-Locator erstellen erstellt wurden, oder auf kombinierte Locators, die mit dem Werkzeug Adressen-Locator erstellen erstellte Locators enthalten.	String
Suchentfernung	Die Entfernung, die verwendet wird, um nach der nächstgelegenen Adresse oder Kreuzung für die Punktposition zu suchen. Einige Locators verwenden optimierte Entfernungswerte, die das Überschreiben des Parameters "Suchentfernung" nicht unterstützen. Vorversion: Dieser Parameter trifft nur auf Locators zu, die mit dem Werkzeug Adressen-Locator erstellen erstellt wurden, oder auf kombinierte Locators, die mit dem Werkzeug Adressen-Locator erstellen erstellte Locators enthalten.	Linear Unit
Feature-Typ (optional)	Gibt die möglichen Übereinstimmungstypen an, die zurückgegeben werden. Es können ein einzelner Wert oder mehrere Werte ausgewählt werden. Wird ein einzelner Wert ausgewählt, beträgt die Suchtoleranz für den Eingabe-Feature-Typ 500 Meter. Bei mehreren Werten werden die standardmäßigen Suchentfernungen angewendet, die in der Hierarchietabelle für Feature-Typen festgelegt sind. Dieser Parameter wird nicht für alle Locators unterstützt. Unteradresse—Die Übereinstimmung ist begrenzt auf eine Straßenadresse auf der Grundlage von Punkten, die Haus- oder Gebäudepositionen darstellen. Punktadresse—Die Übereinstimmung ist begrenzt auf eine Straßenadresse auf der Grundlage von Punkten, die Haus- oder Gebäudepositionen darstellen. Flurstück—Die Übereinstimmung ist begrenzt auf ein Stück Land, das als Grundstück gilt und ein oder mehrere Häuser oder andere Bauwerke umfasst. Diesem Übereinstimmungstyp ist in der Regel eine Adresse und eine Flurstücks-Identifikationsnummer zugewiesen. Straße—Die Übereinstimmung ist begrenzt auf eine Straßenadresse, die nicht mit Punktadresse übereinstimmt, da die Hausnummer aus einem Nummernbereich interpoliert wird. Übereinstimmungen für Hausanschrift enthalten den Bereich der Hausnummer für den übereinstimmenden Straßenabschnitt und nicht für den interpolierten Wert der Hausnummer. Straßenkreuzung—Die Übereinstimmung ist begrenzt auf eine Straßenadresse, die aus einer Straßenkreuzung sowie Informationen zur Stadt und optional zum Bundesstaat und zur Postleitzahl besteht. Diese wird von Referenzdaten für Hausanschrift abgeleitet, z. B. Redlands Blvd & New York St, Redlands, CA, 92373. Straßenname—Die Übereinstimmung ist begrenzt auf eine Straßenadresse wie Straßenadresse, aber ohne Hausnummern, mit administrativen Gebieten und optionaler Postleitzahl, z. B. W Olive Ave, Redlands, CA, 92373. Lokalität—Die Übereinstimmung ist begrenzt auf einen Ortsnamen, der einen besiedelten Ort darstellt. Postalisch—Die Übereinstimmung ist auf eine Postleitzahl begrenzt. Die Referenzdaten umfassen Postleitzahlpunkte, z. B. 90210 USA. Point of Interest—Die Übereinstimmung ist auf einen Point of Interest begrenzt. Die Referenzdaten enthalten Ortsnamen auf Ebene des Verwaltungsgebiets, Unternehmen, Landmarks und geographische Features, z. B. Starbucks. Entfernungsmarker—Die Übereinstimmung ist begrenzt auf eine Straßenadresse, die die lineare Entfernung entlang einer Straße, üblicherweise in Kilometern oder Meilen, von einem bestimmten Ausgangsort angibt, z. B. Mile 25 I-5 N, San Diego, CA.	String
Bevorzugter Standorttyp (optional)	Gibt die bevorzugte Ausgabegeometrie für Punktadress-Übereinstimmungen an. Die Optionen für diesen Parameter sind eine Straßenseitenposition, die für das Routing verwendet werden kann, oder 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. Adressposition—Für Geokodierungsergebnisse wird eine Geometrie zurückgegeben, die eine Adressenposition, wie zum Beispiel ein Dach, einen Gebäudeschwerpunkt oder einen Hauseingang, darstellt. 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. Dies ist die Standardeinstellung.	String

arcpy.geocoding.ReverseGeocode(in_features, in_address_locator, out_feature_class, {address_type}, search_distance, {feature_type}, {location_type})

Name	Erläuterung	Datentyp
in_features	Eine Point-Feature-Class oder ein Layer, aus der bzw. dem übereinstimmende Orte oder Adressen anhand der Punktposition des Features zurückgegeben werden.	Feature Layer
in_address_locator	Der Locator, der für die Rückwärts-Geokodierung der Eingabe-Feature-Class oder des Layers verwendet wird.	Address Locator
out_feature_class	Die Ausgabe-Feature-Class.	Feature Class
address_type (optional)	Gibt an, ob Adressen für die Punkte als Straßenadressen oder Kreuzungsadressen zurückgegeben werden sollen, sofern der Locator den Abgleich von Kreuzungsadressen unterstützt. Vorversion: Dieser Parameter trifft nur auf Locators zu, die mit dem Werkzeug Adressen-Locator erstellen erstellt wurden, oder auf kombinierte Locators, die mit dem Werkzeug Adressen-Locator erstellen erstellte Locators enthalten. ADDRESS—Adressen werden als Straßenadressen im vom Eingabe-Adressen-Locator definierten Format zurückgegeben. Dies ist die Standardeinstellung. INTERSECTION—Adressen werden als Kreuzungsadressen zurückgegeben. Diese Option ist verfügbar, wenn der Adressen-Locator den Abgleich von Kreuzungsadressen unterstützt.	String
search_distance	Die Entfernung, die verwendet wird, um nach der nächstgelegenen Adresse oder Kreuzung für die Punktposition zu suchen. Einige Locators verwenden optimierte Entfernungswerte, die das Überschreiben des Parameters "Suchentfernung" nicht unterstützen. Vorversion: Dieser Parameter trifft nur auf Locators zu, die mit dem Werkzeug Adressen-Locator erstellen erstellt wurden, oder auf kombinierte Locators, die mit dem Werkzeug Adressen-Locator erstellen erstellte Locators enthalten.	Linear Unit
feature_type [feature_type,...] (optional)	Gibt die möglichen Übereinstimmungstypen an, die zurückgegeben werden. Es können ein einzelner Wert oder mehrere Werte ausgewählt werden. Wird ein einzelner Wert ausgewählt, beträgt die Suchtoleranz für den Eingabe-Feature-Typ 500 Meter. Bei mehreren Werten werden die standardmäßigen Suchentfernungen angewendet, die in der Hierarchietabelle für Feature-Typen festgelegt sind. In der REST-API-Webhilfe finden Sie weitere Informationen zum Parameter "featureTypes" für "reverseGeocode". Dieser Parameter wird nicht für alle Locators unterstützt. SUBADDRESS—Die Übereinstimmung ist begrenzt auf eine Straßenadresse auf der Grundlage von Punkten, die Haus- oder Gebäudepositionen darstellen. POINT_ADDRESS—Die Übereinstimmung ist begrenzt auf eine Straßenadresse auf der Grundlage von Punkten, die Haus- oder Gebäudepositionen darstellen. PARCEL—Die Übereinstimmung ist begrenzt auf ein Stück Land, das als Grundstück gilt und ein oder mehrere Häuser oder andere Bauwerke umfasst. Diesem Übereinstimmungstyp ist in der Regel eine Adresse und eine Flurstücks-Identifikationsnummer zugewiesen. STREET_ADDRESS—Die Übereinstimmung ist begrenzt auf eine Straßenadresse, die nicht mit POINT_ADDRESS übereinstimmt, da die Hausnummer aus einem Nummernbereich interpoliert wird. STREET_ADDRESS enthalten den Bereich der Hausnummer für den übereinstimmenden Straßenabschnitt und nicht für den interpolierten Wert der Hausnummer. STREET_INTERSECTION—Die Übereinstimmung ist begrenzt auf eine Straßenadresse, die aus einer Straßenkreuzung sowie Informationen zur Stadt und optional zum Bundesstaat und zur Postleitzahl besteht. Diese wird von Referenzdaten für STREET_ADDRESS abgeleitet, z. B. Redlands Blvd & New York St, Redlands, CA, 92373. STREET_NAME—Die Übereinstimmung ist begrenzt auf eine Straßenadresse wie STREET_ADDRESS, aber ohne Hausnummern, mit administrativen Gebieten und optionaler Postleitzahl, z. B. W Olive Ave, Redlands, CA, 92373. LOCALITY—Die Übereinstimmung ist begrenzt auf einen Ortsnamen, der einen besiedelten Ort darstellt. POSTAL—Die Übereinstimmung ist auf eine Postleitzahl begrenzt. Die Referenzdaten umfassen Postleitzahlpunkte, z. B. 90210 USA. POINT_OF_INTEREST—Die Übereinstimmung ist auf einen Point of Interest begrenzt. Die Referenzdaten enthalten Ortsnamen auf Ebene des Verwaltungsgebiets, Unternehmen, Landmarks und geographische Features, z. B. Starbucks. DISTANCE_MARKER—Die Übereinstimmung ist begrenzt auf eine Straßenadresse, die die lineare Entfernung entlang einer Straße, üblicherweise in Kilometern oder Meilen, von einem bestimmten Ausgangsort angibt, z. B. Mile 25 I-5 N, San Diego, CA.	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. ADDRESS_LOCATION—Für Geokodierungsergebnisse wird eine Geometrie zurückgegeben, die eine Adressenposition, wie zum Beispiel ein Dach, einen Gebäudeschwerpunkt oder einen Hauseingang, darstellt. 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. Dies ist die Standardeinstellung.	String

Codebeispiel

ReverseGeocode – Beispiel (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion ReverseGeocode im unmittelbaren Modus verwendet wird.

import arcpy

arcpy.env.workspace = "C:/data/locations.gdb"

# Set local variables:
input_feature_class = "customers"
address_locator = "e:/StreetMap/data/Street_Addresses_US"
result_feature_class = "customers_with_address"

arcpy.ReverseGeocode_geocoding(input_feature_class, address_locator, 
                               result_feature_class, "ADDRESS")

ReverseGeocode – Beispiel (eigenständiges Skript)

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

# Description: 
# Reverse Geocode customer point locations using a locator created with
# the Create Locator tool.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "c:/data/Atlanta.gdb"

# Set local variables
input_features = "MyCustomers"
locator = "c:/data/Atlanta/Atlanta_StreetAddress.loc"
reverse_output = "MyCustomers_Reverse_Streets"
addr_type = "ADDRESS"
feature_type = "STREET_INTERSECTION;STREET_ADDRESS"
location_type = "ROUTING_LOCATION"

# Execute ReverseGeocode
arcpy.geocoding.ReverseGeocode(input_features, locator, reverse_output, 
                               addr_type, None, feature_type, location_type)

Zusammenfassung

Verwendung

Parameter

Vorversion:

Vorversion:

Vorversion:

Vorversion:

Codebeispiel

Umgebungen

Sonderfälle

Lizenzinformationen

Verwandte Themen

In diesem Thema