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) |
Vorversion: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) |
Vorversion: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 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. Informationen zum Parameter Feature-Typen für die Rückwärts-Geokodierung finden Sie unter Feature-Typen. Dieser Parameter wird nicht für alle Locators unterstützt.
| String |
Bevorzugter Positionstyp (optional) | Gibt die bevorzugte Ausgabegeometrie an, die für Übereinstimmungen der Punktadresse verwendet werden. Mögliche Optionen für diesen Parameter sind die Straßenseitenposition, die für das Routing verwendet werden kann, und die 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 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.
| String |
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 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.
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 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 ü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.
Für die Rückwärts-Geokodierung einer Feature-Class mit dem ArcGIS World Geocoding Service ist eine ArcGIS Online for organizations-Subskription 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.
Parameter
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) |
Vorversion: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) |
Vorversion: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 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. Informationen zum Parameter feature_type für die Rückwärts-Geokodierung finden Sie unter Feature-Typen. Dieser Parameter wird nicht für alle Locators unterstützt.
| String |
location_type (optional) | Gibt die bevorzugte Ausgabegeometrie an, die für POINT_ADDRESS-Übereinstimmungen zurückgegeben wird. Die Optionen für diesen Parameter lauten ROUTING_LOCATION, d. h. die Straßenseitenposition, die für das Routing verwendet werden kann, und 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 die Standardposition von 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 Informationen zum Parameter locationType für reverseGeocode. Dieser Parameter wird nicht für alle Locators unterstützt.
| String |
Codebeispiel
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.loc"
result_feature_class = "customers_with_address"
arcpy.geocoding.ReverseGeocode(input_feature_class, address_locator,
result_feature_class, "ADDRESS")
Das folgende Python-Skript veranschaulicht, wie die Funktion ReverseGeocode in einem eigenständigen Skript verwendet wird.
# 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)
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 AllSource 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)