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 o intersección más cercana para la ubicación de puntos basado en la distancia de búsqueda que se especificó. Al utilizar el ArcGIS World Geocoding Service, esta operación puede consumir créditos.

La realización de operaciones de geocodificación mediante el ArcGIS World Geocoding Service requiere una suscripción de organización a ArcGIS Online 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 las direcciones 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 resultantes. Los nombres de los campos tienen el prefijo REV_. Si no se puede buscar una dirección, los campos contendrán valores vacíos.

  • Si la referencia espacial de la clase de entidad de entrada es diferente del localizador de direcciones, el localizador de direcciones 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 una dirección, significa que no hay entidades en el localizador de direcciones que se puedan asociar con el punto de entrada. Las causas más comunes por las que los puntos no concuerdan son las siguientes:

    • La distancia de búsqueda es demasiado pequeña, por lo que el punto no puede encontrar ninguna entidad más cercana.
    • 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 de direcciones.
    • El localizador de direcciones no contiene entidades de referencia en el área que se puedan asociar con el punto.

    Puede aumentar la distancia de búsqueda de modo que la probabilidad de encontrar la dirección más cercana sea mayor, o puede utilizar otro localizador de direcciones que contenga más entidades o cubra un área más grande para hacer coincidir los puntos de entrada.

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

Sintaxis

arcpy.geocoding.ReverseGeocode(in_features, in_address_locator, out_feature_class, {address_type}, search_distance, {feature_type}, {location_type})
ParámetroExplicaciónTipo de datos
in_features

Una clase de entidad de puntos o capa desde la que se devuelven las direcciones según la ubicación de puntos de las entidades.

Feature Layer
in_address_locator

El localizador de direcciones que va a 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.

  • ADDRESSLas direcciones se devuelven en forma de direcciones de calles o en el formato definido por el localizador de direcciones de entrada. Esta es la opción predeterminada.
  • INTERSECTIONLas direcciones se devuelven como direcciones de intersección. Esta opción está disponible si el localizador de direcciones admite la concordancia de direcciones de intersecciones.
String
search_distance

La distancia utilizada para la buscar la dirección o intersección más cercana para la ubicación de puntos. Algunos localizadores utilizan valores de distancia optimizados que no admiten la invalidación del parámetro de distancia de búsqueda. Los localizadores creados con la herramienta Crear un localizador de direcciones tienen una distancia de búsqueda predeterminada de 100 metros.

Linear Unit
feature_type
[feature_type,...]
(Opcional)

Especifica los tipos de concordancia posibles que se devuelven. 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 aplican 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.

  • POINT_ADDRESSLa coincidencia está limitada a una dirección postal basada en puntos que representan las ubicaciones de casas y edificios.
  • PARCELLa coincidencia está 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 está limitada a una dirección postal que se diferencia de POINT_ADDRESS porque el número de casa se interpola desde un rango de números. STREET_ADDRESS incluyen el rango de número de casa para el segmento postal coincidente, en lugar del valor numérico de casa interpolado.
  • STREET_INTERSECTIONLa coincidencia está limitada a una dirección postal 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 está limitada a una dirección 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 está limitada a un nombre de lugar que representa un lugar poblado.
  • POSTALLa coincidencia está 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 está limitada a un punto de interés. Los datos de referencia constan de nombres de lugar de división administrativa, negocios, hitos y entidades geográficas, por ejemplo, Starbucks.
  • DISTANCE_MARKER La coincidencia está 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 para las coincidencias POINT_ADDRESS. Las opciones para este parámetro son ROUTING_LOCATION, un lado de la ubicación de la calle, que puede usarse para generación de 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 volverá a 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.

  • ADDRESS_LOCATIONSe devuelve 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 devuelve 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

de ReverseGeocode (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función ReverseGeocode en 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"
result_feature_class = "customers_with_address"
arcpy.ReverseGeocode_geocoding(input_feature_class, address_locator, 
                               result_feature_class, "ADDRESS", "100 Meters")
Ejemplo de ReverseGeocode (script independiente)

El siguiente script de Python muestra 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"
search_distance = "0 Unknown"
feature_type = "STREET_INTERSECTION;STREET_ADDRESS"
location_type = "ROUTING_LOCATION"
# Execuste ReverseGeocode
arcpy.geocoding.ReverseGeocode(input_features, locator, reverse_output, 
                               addr_type, search_distance, feature_type, 
                               location_type)

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados