| Etiqueta | Explicación | Tipo de datos |
Capa o clase de entidad de entrada | Una capa o clase de entidad de punto desde la que se devolverán lugares o direcciones coincidentes según la ubicación de los puntos de las entidades. | Feature Layer |
Localizador de direcciones de entrada | El localizador que se utilizará para hacer una geocodificación inversa de la capa o clase de entidad de entrada. | Address Locator |
Clase de entidad de salida | La clase de entidad de salida. | Feature Class |
Tipo de direcciones de salida (Opcional) | Especifica si se devolverán direcciones para los puntos como direcciones de calles o direcciones de intersección en caso de que el localizador admita la concordancia de intersecciones.
Heredado:Este parámetro solo se aplica a los localizadores creados con la herramienta Crear un localizador de direcciones o a localizadores compuestos que contengan localizadores creados con la herramienta Crear un localizador de direcciones. | String |
Distancia de búsqueda | La distancia que se utilizará para buscar la dirección o intersección más cercana para la ubicación del punto. Algunos localizadores utilizan valores de distancia optimizados que no admiten la invalidación del parámetro de distancia de búsqueda. Heredado:Este parámetro solo se aplica a los localizadores creados con la herramienta Crear un localizador de direcciones o a localizadores compuestos que contengan localizadores creados con la herramienta Crear un localizador de direcciones. | Linear Unit |
Tipo de entidad (Opcional) | Especifica los tipos de concordancia posibles que se devolverán. Es posible seleccionar un valor único o varios valores. Si se selecciona un valor único, la tolerancia de búsqueda para el tipo de entidad de entrada es de 500 metros. Si se incluyen varios valores, se aplicarán las distancias de búsqueda predeterminadas especificadas en el tipo de entidad tabla de jerarquía. Este parámetro no es compatible con todos los localizadores.
| String |
Tipo de ubicación preferida (Opcional) | Especifica la geometría de salida preferida para las coincidencias Dirección de punto. Las opciones para este parámetro son un lado de la ubicación de la calle, que puede usarse para encaminar, o la ubicación que representa el tejado o el centroide de parcela que corresponde a la dirección. Si la ubicación deseada no existe en los datos, se volverá a la ubicación predeterminada. En los resultados de geocodificación con Addr_type=PointAddress, los valores del atributo x,y describen las coordenadas de la dirección a lo largo de la calle, mientras que los valores de DisplayX y DisplayY describen las coordenadas de tejado o centroide de edificio. Este parámetro no es compatible con todos los localizadores.
| String |
Resumen
Crea direcciones a partir de ubicaciones de puntos en una clase de entidad. El proceso de geocodificación inversa busca la dirección, el lugar o la intersección más cercanos para la ubicación de puntos en función de los valores de distancia optimizados para los localizadores creados con la herramienta Crear localizador.
Nota:
Los localizadores creados con herramientas heredadas no están optimizados del mismo modo y utilizan un valor predeterminado de 100 para la distancia. Para obtener los mejores resultados, actualice los localizadores creados con herramientas heredadas y créelos con la herramienta Crear localizador.
La realización de operaciones de geocodificación mediante ArcGIS World Geocoding Service requiere una cuenta de organización de ArcGIS y consume créditos. La cuenta de organización debe tener suficientes créditos para completar toda la solicitud de geocodificación.
Uso
La clase de entidad de entrada debe contener formas de puntos con coordenadas x,y válidas. No se devuelven resultados en los puntos con coordenadas nulas.
La clase de entidad de salida contiene el mismo número de registros que la clase de entidad de entrada. Se agregan a la clase de entidad campos adicionales que contienen las direcciones o lugares resultantes. Los nombres de los campos tienen el prefijo REV_. Si no se encuentra ningún lugar o dirección coincidente, los campos contendrán valores vacíos.
Si la referencia espacial de la clase de entidad de entrada es diferente de la del localizador, el localizador transformará las coordenadas al vuelo y tratará de encontrar la concordancia. La clase de entidad de salida se guardará en la misma referencia espacial que la clase de entidad de entrada. Para cambiar la referencia espacial de la clase de entidad de salida, establezca un sistema de coordenadas de salida diferente en la configuración del entorno de la herramienta.
Si un punto de la clase de entidad de entrada no puede devolver un lugar o dirección coincidente, significa que no hay entidades en el localizador que se puedan asociar con el punto de entrada. Las causas más comunes por las que los puntos no concuerdan son las siguientes:
- El punto contiene coordenadas nulas.
- Las coordenadas del punto son incorrectas y no se pueden transformar en la referencia espacial que se utilizó en el localizador.
- El localizador no contiene entidades de referencia en el área que se puedan asociar con el punto.
- Se especificó un tipo de entidad para el que no hay buenas concordancias en una distancia razonable.
Se necesita una suscripción a ArcGIS Online for organizations para utilizar la geocodificación inversa de una clase de entidad con el ArcGIS World Geocoding Service.
Parámetros
arcpy.geocoding.ReverseGeocode(in_features, in_address_locator, out_feature_class, {address_type}, search_distance, {feature_type}, {location_type})| Nombre | Explicación | Tipo de datos |
in_features | Una capa o clase de entidad de punto desde la que se devolverán lugares o direcciones coincidentes según la ubicación de los puntos de las entidades. | Feature Layer |
in_address_locator | El localizador que se utilizará para hacer una geocodificación inversa de la capa o clase de entidad de entrada. | Address Locator |
out_feature_class | La clase de entidad de salida. | Feature Class |
address_type (Opcional) | Especifica si se devolverán direcciones para los puntos como direcciones de calles o direcciones de intersección en caso de que el localizador admita la concordancia de intersecciones. Heredado:Este parámetro solo se aplica a los localizadores creados con la herramienta Crear un localizador de direcciones o a localizadores compuestos que contengan localizadores creados con la herramienta Crear un localizador de direcciones.
| String |
search_distance | La distancia que se utilizará para buscar la dirección o intersección más cercana para la ubicación del punto. Algunos localizadores utilizan valores de distancia optimizados que no admiten la invalidación del parámetro de distancia de búsqueda. Heredado:Este parámetro solo se aplica a los localizadores creados con la herramienta Crear un localizador de direcciones o a localizadores compuestos que contengan localizadores creados con la herramienta Crear un localizador de direcciones. | Linear Unit |
feature_type [feature_type,...] (Opcional) | Especifica los tipos de concordancia posibles que se devolverán. Es posible seleccionar un valor único o varios valores. Si se selecciona un valor único, la tolerancia de búsqueda para el tipo de entidad de entrada es de 500 metros. Si se incluyen varios valores, se aplicarán las distancias de búsqueda predeterminadas especificadas en el tipo de entidad tabla de jerarquía. Consulte la página web de ayuda de la API REST para obtener más información sobre el parámetro featureTypes para reverseGeocode. Este parámetro no es compatible con todos los localizadores.
| String |
location_type (Opcional) | Especifica la geometría de salida preferida para las coincidencias de POINT_ADDRESS. Las opciones para este parámetro son ROUTING_LOCATION, un lado de la ubicación de la calle, que puede usarse para generar las rutas, o ADDRESS_LOCATION, la ubicación que representa el tejado o el centroide de parcela que corresponde a la dirección o una entrada principal. Si la ubicación deseada no existe en los datos, se devolverá la ubicación predeterminada de ROUTING_LOCATION. En los resultados de geocodificación con Addr_type = "PointAddress", los valores del atributo x,y describen las coordenadas de la dirección a lo largo de la calle, mientras que los valores de DisplayX y DisplayY describen las coordenadas de tejado o centroide de edificio. Consulte la página web de la ayuda de la API REST para más información sobre el parámetro locationType para reverseGeocode. Este parámetro no es compatible con todos los localizadores.
| String |
Muestra de código
El siguiente script de la ventana de Python demuestra cómo utilizar la función ReverseGeocode de modo inmediato.
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.ReverseGeocode_geocoding(input_feature_class, address_locator,
result_feature_class, "ADDRESS")El siguiente script de Python demuestra cómo utilizar la función ReverseGeocode en un script independiente.
# 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)El siguiente script de Python muestra cómo utilizar la función ReverseGeocode con ArcGIS World Geocoding Service en un script independiente.
Nota:
Si está trabajando con localizadores en un portal, asegúrese de haber iniciado sesión y haber definido el portal como el portal activo en ArcGIS Pro. Para acceder a un localizador que está en un portal distinto de su portal activo, autentíquelo con la función SignInToPortal.
# 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"
# Execute ReverseGeocode
arcpy.geocoding.ReverseGeocode(input_features, locator, reverse_output,
addr_type, None, feature_type, location_type)Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí