Rückwärts-Geokodierung (Geocoding Tools)

Zusammenfassung

Mit diesem Werkzeug werden Adressen aus Punktpositionen in einer Feature-Class erstellt. Bei der Rückwärts-Geokodierung wird für die Punktposition nach der nächstgelegenen Adresse, dem nächstgelegenen Ort oder der nächstgelegenen Kreuzung gesucht. Der Vorgang basiert dabei auf optimierten Entfernungswerten für Locators, die mit dem Werkzeug Locator erstellen erstellt wurden.

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.

Hinweis:

Eine Credit-Schätzung ist oben im Werkzeug verfügbar, wenn das aktive Portal ArcGIS Online und der Eingabe-Locator der ArcGIS World Geocoding Service ist.

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 NULL-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 die Umgebung Ausgabe-Koordinatensystem fest.
Wenn für einen Punkt in der Eingabe-Feature-Class kein übereinstimmender 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. Weitere Informationen finden Sie unter Feature-Typ - Übereinstimmungsbedingungen.
Wenn in den Eigenschaften des Locators eine umgekehrte Entfernung angegeben ist, hat diese Vorrang vor den optimierten hierarchischen Entfernungswerten, die auf der Grundlage der vom Locator unterstützten Rollen verwendet werden.
Um eine Feature-Class mithilfe des ArcGIS World Geocoding Service rückwärts geokodieren zu können, ist eine Subskription für ArcGIS Online für Organisationen erforderlich.
Wird ein Eingabe-Locator verwendet, der aus Daten mit Z-Wert-Unterstützung erstellt wurde, verfügt die Ausgabe des Werkzeugs nicht über Z-Wert-Unterstützung. In diesem Werkzeug werden nur 2D-Ausgaben unterstützt.

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. Hinweis: Das Speichern der Ausgabe im Shapefile-Format wird aufgrund der Shapefile-Beschränkungen nicht unterstützt.	Feature Class
Ausgabe-Adressentyp (Optional)	Legacy: Dieser Parameter wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten. Standardmäßig werden die vom Locator unterstützten Feature-Typen verwendet.	String
Suchentfernung (Optional)	Legacy: Dieser Parameter wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten. Standardmäßig werden basierend auf den vom Locator unterstützten Rollen optimierte hierarchische Entfernungswerte verwendet, die nicht überschrieben werden können.	Linear Unit
Feature-Typ (Optional)	Gibt die möglichen Übereinstimmungstypen an, die zurückgegeben werden. Es können ein einzelner Wert oder mehrere Werte angegeben werden. Wird ein einzelner Wert angegeben, 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. Informationen zur Verwendung dieses Parameters für die Rückwärts-Geokodierung finden Sie unter Feature-Typen. 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 Unteradressen von Haus- oder Gebäudepositionen darstellen. Für diese Option ist ein Locator erforderlich, der in ArcGIS Pro 2.8 oder höher erstellt wurde. Wenn der Locator als Service veröffentlicht wurde, ist die Erstellung in ArcGIS Enterprise 10.9 oder höher erforderlich. 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. Dieser Option ist in der Regel eine Adresse und eine Flurstücks-Identifikationsnummer zugewiesen. Diese Option wird nur von benutzerdefinierten Locators unterstützt, die mit der Rolle "Flurstück" erstellt wurden. Von ArcGIS World Geocoding Service- oder ArcGIS StreetMap Premium-Locators wird sie nicht unterstützt. 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 Straßenadresse 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 Straßenadresse 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. Ortschaft—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 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 der Adressposition 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

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. Hinweis: Das Speichern der Ausgabe im Shapefile-Format wird aufgrund der Shapefile-Beschränkungen nicht unterstützt.	Feature Class
address_type (Optional)	Legacy: Dieser Parameter wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten. Standardmäßig werden die vom Locator unterstützten Feature-Typen verwendet.	String
search_distance (Optional)	Legacy: Dieser Parameter wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten. Standardmäßig werden basierend auf den vom Locator unterstützten Rollen optimierte hierarchische Entfernungswerte verwendet, die nicht überschrieben werden können.	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 angegeben werden. Wird ein einzelner Wert angegeben, 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. Informationen zur Verwendung dieses Parameters für die Rückwärts-Geokodierung finden Sie unter Feature-Typen. 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 Unteradressen von Haus- oder Gebäudepositionen darstellen. Für diese Option ist ein Locator erforderlich, der in ArcGIS Pro 2.8 oder höher erstellt wurde. Wenn der Locator als Service veröffentlicht wurde, ist die Erstellung in ArcGIS Enterprise 10.9 oder höher erforderlich. `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. Dieser Option ist in der Regel eine Adresse und eine Flurstücks-Identifikationsnummer zugewiesen. Diese Option wird nur von benutzerdefinierten Locators unterstützt, die mit der Rolle "Flurstück" erstellt wurden. Von ArcGIS World Geocoding Service- oder ArcGIS StreetMap Premium-Locators wird sie nicht unterstützt. `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 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

Codebeispiel

ReverseGeocode: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion ReverseGeocode im Direkt-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.loc"
result_feature_class = "customers_with_address"

arcpy.geocoding.ReverseGeocode(input_feature_class, address_locator,
                               result_feature_class, "ADDRESS")

ReverseGeocode: Beispiel 2 (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"

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

ReverseGeocode: Beispiel 3 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion ReverseGeocode mit dem ArcGIS World Geocoding Service in einem eigenständigen Skript verwendet wird.

Hinweis:

Wenn Sie mit Locators in einem 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, führen Sie die Authentifizierung mithilfe der Funktion SignInToPortal durch.

# Description:
# Reverse Geocode customer point locations using the ArcGIS World Geocoding Service.

# Import system modules
import arcpy

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

# Set local variables
input_features = "MyCustomers"
locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"
reverse_output = "MyCustomers_Reverse_Streets"
addr_type = "ADDRESS"
feature_type = "STREET_INTERSECTION;STREET_ADDRESS"
location_type = "ROUTING_LOCATION"

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

Umgebungen

Ausgabe-Koordinatensystem

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Rückwärts-Geokodierung (Geocoding Tools)

Zusammenfassung

Hinweis:

Verwendung

Parameter

Hinweis:

Legacy:

Legacy:

Umgebungen

Lizenzierungsinformationen

Verwandte Themen