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.
Verwendung
Die Eingabe-Feature-Class muss Punkt-Shapes mit gültigen XY-Koordinaten enthalten. Für Punkte mit NULL-Koordinaten werden keine Adressen 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 hinzugefügt. Die Namen dieser Felder erhalten das Präfix REV_. Wenn eine Adresse nicht gefunden werden kann, enthalten die Felder leere Werte.
Wenn der Raumbezug der Eingabe-Feature-Class nicht dem Adressen-Locator entspricht, wandelt der Adressen-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. Sie können den Raumbezug der Ausgabe-Feature-Class ändern, indem Sie in den Umgebungseinstellungen des Werkzeugs ein anderes Ausgabe-Koordinatensystem festlegen.
Wenn für einen Punkt in der Eingabe-Feature-Class keine Adresse zurückgegeben wird, bedeutet dies, dass der Adressen-Locator keine Features enthält, die dem Eingabepunkt zugeordnet werden können. Nachfolgend finden Sie einige häufige Ursachen für Punkte ohne Übereinstimmung:
- Die Suchentfernung ist so klein, dass für den Punkt keine nahegelegenen Features gefunden werden können.
- Der Punkt enthält NULL-Koordinaten.
- Die Koordinaten des Punktes sind fehlerhaft und können nicht in den Raumbezug umgewandelt werden, der im Adressen-Locator verwendet wird.
- Der Adressen-Locator enthält keine Referenz-Features in dem Bereich, die dem Punkt zugeordnet werden können.
Sie können die Suchentfernung vergrößern, um die Chancen zu erhöhen, die nächstgelegene Adresse zu finden. Alternativ können Sie einen anderen Adressen-Locator verwenden, der mehr Features enthält oder eine größere Fläche abdeckt, um Übereinstimmungen mit den Eingabepunkten zu finden.
Für die Rückwärts-Geokodierung einer Feature-Class mit dem ArcGIS Online for organizations ist eine ArcGIS World Geocoding Service-Subskription erforderlich. Weitere Informationen finden Sie unter Arbeiten mit ArcGIS Online World Geocoding Service.
Syntax
arcpy.geocoding.ReverseGeocode(in_features, in_address_locator, out_feature_class, {address_type}, {search_distance}, {feature_type}, {location_type})
Parameter | Erklärung | Datentyp |
in_features | Eine Point-Feature-Class oder ein Layer, aus der bzw. dem Adressen anhand der Punktposition des Features zurückgegeben werden. | Feature Class |
in_address_locator | Der Adressen-Locator für die Rückwärts-Geokodierung der Eingabe-Feature-Class. | 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 Adressen-Locator den Abgleich von Kreuzungsadressen unterstützt.
| String |
search_distance (optional) | Die Entfernung, innerhalb der nach der nächstgelegenen Adresse oder Kreuzung für die Punktposition gesucht wird. Einige Locators verwenden optimierte Entfernungswerte, die das Überschreiben des Parameters "Suchentfernung" nicht unterstützen. Die standardmäßige Suchentfernung für Adressen-Locators, die mit dem Werkzeug Adressen-Locator erstellen erstellt wurden, beträgt 100 Meter. | Linear Unit |
feature_type [feature_type,...] (optional) | Beschränkt die Typen der zurückgegebenen Übereinstimmungen. 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.
| String |
location_type (optional) | Dieser Parameter ist für Locators verfügbar, die den Parameter locationType unterstützen. Er gibt die bevorzugte Ausgabegeometrie für PointAddress-Ü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. 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.
| String |
Codebeispiel
ReverseGeocode – Beispiel 1 (Python-Fenster)
Das folgende Skript im Python-Fenster veranschaulicht, wie die Funktion ReverseGeocode im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/atlanta.gdb"
# Set local variables:
input_feature_class = "geocode_result"
address_locator = "C:/ArcTutor/Geocoding/Atlanta.loc"
result_feature_class = "customers_with_address"
arcpy.ReverseGeocode_geocoding(input_feature_class, address_locator,
result_feature_class, "ADDRESS", "100 Meters")
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 the ArcGIS World Geocoding Service using SignInToPortal and
# Ready-To-Use-Services that returns multiple feature types and preferred location.
import arcpy
import os
arcpy.SignInToPortal_server("<Username>","<Password>", "https://geocode.arcgis.com/arcgis")
# Set workspace
arcpy.env.workspace = r"C:\arcgis\ArcTutor\Geocoding\atlanta.gdb"
# Set local variables
in_feature_class = "customers_ParcelBlk"
address_locator = "Ready-To-Use Services/Geocoding/ArcGIS World Geocoding Service.GeocodeServer"
out_feature_class = "customers_with_streets"
addr_type = "ADDRESS"
search_distance = "0 Meters"
feature_type = "STREET_ADDRESS;STREET_INTERSECTION"
location_type = "ROUTING_LOCATION"
# Perform Reverse Geocoding
arcpy.ReverseGeocode_geocoding(in_feature_class, address_locator, out_feature_class,
addr_type, search_distance, feature_type, location_type)
ReverseGeocode – Beispiel 3 (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 the ArcGIS World Geocoding Service using an ArcGIS Server connection file
# that returns multiple feature types and preferred location.
# Import system modules import arcpy import os
# Set workspace arcpy.env.workspace = r"C:\arcgis\ArcTutor\Geocoding\atlanta.gdb"
# Set local variables in_feature_class = "customers_ParcelBlk"
# Create this ags connection file in ArcMap address_locator = r"C:/connection_files/arcgis on geocode.arcgis.com (user)/World.GeocodeServer"
out_feature_class = "customers_with_streets"
addr_type = "ADDRESS"
search_distance = "0 Meters"
feature_type = "STREET_ADDRESS;STREET_INTERSECTION"
location_type = "ROUTING_LOCATION"
# Perform Reverse Geocoding arcpy.ReverseGeocode_geocoding(in_feature_class, address_locator, out_feature_class, addr_type, search_distance, feature_type, location_type)
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja