Geocodificación inversa (Geocodificación)

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.

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.

Nota:

La estimación de créditos está disponible en la parte superior de la herramienta cuando el portal activo es ArcGIS Online y el localizador de entrada es ArcGIS World Geocoding Service.

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. Consulte Condiciones de coincidencia de tipo de entidad para obtener más información.

  • 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.

  • Cuando se utiliza un localizador de entrada creado con datos sensible a valores z, la herramienta devolverá resultados no sensible a valores z. Esta herramienta solo admite salidas 2D.

Parámetros

EtiquetaExplicaciónTipo 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.

Nota:

No se admite guardar la salida en formato shapefile debido a las limitaciones del shapefile.

Feature Class
Tipo de direcciones de salida
(Opcional)
Heredado:

Este parámetro está obsoleto y solo se mantiene para ofrecer compatibilidad con versiones anteriores. Se utilizarán los tipos de entidades admitidos por el localizador de forma predeterminada.

String
Distancia de búsqueda
(Opcional)
Heredado:

Este parámetro está obsoleto y solo se mantiene para ofrecer compatibilidad con versiones anteriores. De forma predeterminada, se utilizarán los valores de distancia jerárquica en función de los roles admitidos por el localizador y no se puede anular.

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. Consulte Tipos de entidades para obtener información detallada sobre el parámetro Tipo de entidad para la geocodificación inversa.

Este parámetro no es compatible con todos los localizadores.

  • SubdirecciónLa coincidencia estará limitada a una dirección de calle basada en puntos que representan ubicaciones de subdirecciones de casas y edificios. Esta opción requiere un localizador creado en ArcGIS Pro 2.8 o posteriores y ArcGIS Enterprise 10.9 o posteriores si se publica como un servicio.
  • Dirección de puntoLa coincidencia estará limitada a una dirección de calle basada en puntos que representan ubicaciones de casas y edificios.
  • ParcelaLa coincidencia estará limitada a una parcela de tierra que sea un bien inmueble y puede incluir una o varias viviendas u otras estructuras. Este tipo de coincidencia tiene generalmente una dirección y un número de identificación de parcela asignados.
  • Dirección de calleLa coincidencia estará limitada a una dirección de calle que se diferencia de Dirección de punto porque el número de casa se interpola desde un rango de números. Las coincidencias de Dirección de calle incluyen el rango de número de casa para el segmento postal coincidente, en lugar del valor numérico de casa interpolado.
  • Intersección de callesLa coincidencia estará limitada a una dirección de calle que consta de una intersección de calle junto con la ciudad e información opcional del estado y del código postal. Se deriva de los datos de referencia de Dirección de calle, por ejemplo, Redlands Blvd & New York St, Redlands, CA, 92373.
  • Nombre de calleLa coincidencia estará limitada a una dirección de calle similar a Dirección de calle, pero sin los números de la casa, junto con las divisiones administrativas y el código postal opcional, por ejemplo, W Olive Ave, Redlands, CA, 92373.
  • LocalidadLa coincidencia estará limitada a un nombre de lugar que representa un lugar poblado.
  • PostalLa coincidencia estará limitada a un código postal. Los datos de referencia son los puntos de códigos postales, por ejemplo 90210 EE. UU.
  • Punto de interésLa coincidencia estará limitada a un punto de interés. Los datos de referencia constan de nombres de lugar de división administrativa, negocios, puntos de referencia y entidades geográficas, por ejemplo, Starbucks.
  • Marcador de distanciaLa coincidencia estará limitada a una dirección de calle que representa la distancia lineal a lo largo de una calle, normalmente en kilómetros o millas, desde una ubicación de origen designada, por ejemplo, Mile 25 I-5 N, San Diego, CA.
String
Tipo de ubicación preferida
(Opcional)

Especifica la geometría de salida preferida que se devolverá para las coincidencias de 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 devolverá 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, y 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.

  • Ubicación de direcciónSe devolverá la geometría para los resultados de geocodificación que representan una ubicación de dirección, por ejemplo, un tejado, un centroide de edificio o una entrada principal.
  • Ubicación de generación de rutasSe devolverá la geometría para los resultados de geocodificación que representan una ubicación cercana al lado de la calle, que se puede utilizar para la generación de rutas para vehículos. Esta es la opción predeterminada.
String

arcpy.geocoding.ReverseGeocode(in_features, in_address_locator, out_feature_class, {address_type}, {search_distance}, {feature_type}, {location_type})
NombreExplicaciónTipo 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.

Nota:

No se admite guardar la salida en formato shapefile debido a las limitaciones del shapefile.

Feature Class
address_type
(Opcional)
Heredado:

Este parámetro está obsoleto y solo se mantiene para ofrecer compatibilidad con versiones anteriores. Se utilizarán los tipos de entidades admitidos por el localizador de forma predeterminada.

String
search_distance
(Opcional)
Heredado:

Este parámetro está obsoleto y solo se mantiene para ofrecer compatibilidad con versiones anteriores. De forma predeterminada, se utilizarán los valores de distancia jerárquica en función de los roles admitidos por el localizador y no se puede anular.

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 Tipos de entidades para obtener información detallada sobre el parámetro feature_type para la geocodificación inversa.

Este parámetro no es compatible con todos los localizadores.

  • SUBADDRESSLa coincidencia estará limitada a una dirección de calle basada en puntos que representan ubicaciones de subdirecciones de casas y edificios. Esta opción requiere un localizador creado en ArcGIS Pro 2.8 o posteriores y ArcGIS Enterprise 10.9 o posteriores si se publica como un servicio.
  • POINT_ADDRESSLa coincidencia estará limitada a una dirección de calle basada en puntos que representan ubicaciones de casas y edificios.
  • PARCELLa coincidencia estará limitada a una parcela de tierra que sea un bien inmueble y puede incluir una o varias viviendas u otras estructuras. Este tipo de coincidencia tiene generalmente una dirección y un número de identificación de parcela asignados.
  • STREET_ADDRESSLa coincidencia estará limitada a una dirección de calle que se diferencia de POINT_ADDRESS porque el número de casa se interpola desde un rango de números. Las coincidencias de STREET_ADDRESS incluyen el rango de números de casa para el segmento de calle coincidente, en lugar del valor de número de casa interpolado.
  • STREET_INTERSECTIONLa coincidencia estará limitada a una dirección de calle que consta de una intersección de calle junto con la ciudad e información opcional del estado y del código postal. Esto se deriva de los datos de referencia de STREET_ADDRESS, por ejemplo, Redlands Blvd & New York St, Redlands, CA, 92373.
  • STREET_NAMELa coincidencia estará limitada a una dirección de calle similar a STREET_ADDRESS, pero sin los números de la casa, junto con las divisiones administrativas y el código postal opcional, por ejemplo, W Olive Ave, Redlands, CA, 92373.
  • LOCALITYLa coincidencia estará limitada a un nombre de lugar que representa un lugar poblado.
  • POSTALLa coincidencia estará limitada a un código postal. Los datos de referencia son los puntos de códigos postales, por ejemplo 90210 EE. UU.
  • POINT_OF_INTERESTLa coincidencia estará limitada a un punto de interés. Los datos de referencia constan de nombres de lugar de división administrativa, negocios, puntos de referencia y entidades geográficas, por ejemplo, Starbucks.
  • DISTANCE_MARKERLa coincidencia estará limitada a una dirección de calle que representa la distancia lineal a lo largo de una calle, normalmente en kilómetros o millas, desde una ubicación de origen designada, por ejemplo, Mile 25 I-5 N, San Diego, CA.
String
location_type
(Opcional)

Especifica la geometría de salida preferida que se devolverá para las coincidencias de POINT_ADDRESS. Las opciones para este parámetro son ROUTING_LOCATION, que es la ubicación del lado de la calle, que puede usarse para la generación de rutas, y ADDRESS_LOCATION, que es la ubicación que representa el tejado, 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, y 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 obtener más información sobre el parámetro locationType para reverseGeocode.

Este parámetro no es compatible con todos los localizadores.

  • ADDRESS_LOCATIONSe devolverá la geometría para los resultados de geocodificación que representan una ubicación de dirección, por ejemplo, un tejado, un centroide de edificio o una entrada principal.
  • ROUTING_LOCATIONSe devolverá la geometría para los resultados de geocodificación que representan una ubicación cercana al lado de la calle, que se puede utilizar para la generación de rutas para vehículos. Esta es la opción predeterminada.
String

Muestra de código

Ejemplo 1 de ReverseGeocode (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra 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.geocoding.ReverseGeocode(input_feature_class, address_locator, 
                               result_feature_class, "ADDRESS")
Ejemplo 2 de ReverseGeocode (script independiente)

La siguiente secuencia de comandos Pythonindependiente muestra cómo utilizar la función ReverseGeocode en una secuencia de comandos 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"

# Run ReverseGeocode
arcpy.geocoding.ReverseGeocode(input_features, locator, reverse_output, 
                               addr_type, None, feature_type, location_type)
Ejemplo 3 de ReverseGeocode (script independiente)

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 AllSource. 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"

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