ArcMap

Geocodificar direcciones

Resumen

Geocodifica una tabla de direcciones. Este proceso requiere una tabla que almacene las direcciones que desea geocodificar y un localizador de direcciones o un localizador de direcciones compuesto. Esta herramienta hace concordar las direcciones contra el localizador de direcciones y guarda el resultado para cada registro de entrada en una nueva clase de entidad de punto. Al utilizar el ArcGIS World Geocoding Service, esta operación puede consumir créditos.

Ilustración

Geocodificar una tabla de direcciones

Uso

  • Puede geocodificar direcciones almacenadas en un único campo o divididas en varios campos. Un campo de entrada almacena la dirección completa; por ejemplo, 303 Peachtree St NE, Atlanta GA 30308. Se admiten varios campos si las direcciones de entrada están divididas en varios campos, como Address, City, State y ZIP para una dirección general de Estados Unidos.

  • La clase de entidad de salida se guarda en la misma referencia espacial que el localizador de direcciones. Es posible cambiar la referencia espacial de la clase de entidad de salida al establecer un sistema de coordenadas de salida diferente en la configuración del entorno de la herramienta.

  • La clase de entidad de salida, por defecto, almacena una copia de la dirección de entrada e información adicional, por ejemplo, puntuación, estado y dirección coincidente de cada registro. Las direcciones se pueden volver a geocodificar mediante el uso de la herramienta Repetir geocodificación de direcciones o el cuadro de diálogo Recodificación interactiva en ArcMap. Editar las direcciones en la tabla de direcciones de entrada no cambiará el resultado en la clase de entidad de salida una vez que termina el proceso de concordancia y se crea la clase de entidad.

  • Establezca el parámetro Clase de entidad de salida dinámica en verdadero (activado) si desea que se actualice automáticamente el resultado con concordancia en la clase de entidad de salida cuando se actualice la tabla de direcciones de entrada. Se crea una clase de relación para la tabla de entrada y la clase de entidad de salida. Cuando se cambia una dirección en la tabla de entrada durante una sesión de edición en ArcMap, la dirección se geocodificará otra vez inmediatamente, actualizándose el registro relacionado en la clase de entidad de salida con el nuevo resultado de geocodificación. La actualización automática también se admite para agregar un nuevo registro o eliminar un registro existente en la tabla de entrada.

  • Se requiere suscripción a ArcGIS Online for organizations para geocodificar una tabla de direcciones con el ArcGIS World Geocoding Service. Consulte Trabajar con el servicio de geocodificación de ArcGIS Online World para obtener más información.

Sintaxis

GeocodeAddresses_geocoding (in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type})
ParámetroExplicaciónTipo de datos
in_table

La tabla de direcciones que se va a geocodificar.

Table View
address_locator

El localizador de direcciones que se va a utilizar para geocodificar la tabla de direcciones.

Address Locator
in_address_fields
[input_address_field, table_field_name]

Cada asignación de campos en este parámetro está en el formato input_address_field, table_field_name, donde input_address_field es el nombre del campo de dirección de entrada especificado por el localizador de direcciones y table_field_name es el nombre del campo correspondiente en la tabla de direcciones que se desea geocodificar.

Puede especificar un solo campo de entrada simple que guarde la dirección completa. Otra alternativa es especificar también varios campos si las direcciones de entrada están divididas en diferentes campos, como Address, City, State y ZIP para una dirección general de Estados Unidos.

Si decide no asignar un campo de dirección de entrada opcional empleado por el localizador de direcciones a un campo de la tabla de entrada de direcciones, especifique que no hay asignación utilizando <Ninguno> en lugar de un nombre de campo.

Field Info
out_feature_class

La clase de entidad geocodificada o shapefile de salida.

Feature Class
out_relationship_type
(Opcional)

Indica si debe crear una copia estática de la tabla de direcciones dentro de la clase de entidad geocodificada o si debe crear una clase de entidad geocodificada y actualizada dinámicamente.

  • STATIC —Crea una copia estática de la tabla de direcciones de entrada de campos en la clase de entidad de salida. Esta es la opción predeterminada.
  • DYNAMIC —Crea una clase de relación entre la tabla de direcciones de entrada y la clase de entidad de salida de modo que las modificaciones a las direcciones en la tabla de direcciones de entrada se actualizan automáticamente en la clase de entidad de salida. Esta opción está admitida solo si la tabla de direcciones de entrada y la clase de entidad de salida están en el mismo espacio de trabajo de geodatabase.
Boolean
country
[country,...]
(Opcional)

La geocodificación se limita a los países seleccionados. Cuando no se utiliza ningún país, la geocodificación se ejecuta con todos los países compatibles. Si realiza una selección de países, mejorará la precisión de la geocodificación en la mayoría de los casos.

Si un campo que representa a países está en la Tabla de entrada y se asigna al Campo de dirección de entrada de CountryCode, el valor del país de la Tabla de entrada invalidará el parámetro País.

Se deben especificar códigos de país de 3 caracteres de la norma ISO 3166-1.

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

String
location_type
(Opcional)

Especifica la geometría de salida preferida para las coincidencias PointAddress. Las opciones son el lado de la ubicación de la calle, que puede usarse para encaminar, o 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 para 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.

  • ADDRESS_LOCATION —Devuelve la geometría para los resultados de geocodificación que podrían representar una ubicación de dirección, por ejemplo, una ubicación de tejado, de centroide de parcela o de entrada principal.
  • ROUTING_LOCATION —Devuelve la geometría para los resultados de geocodificación que representan una ubicación cercana al lado de la calle. Esta es la opción predeterminada.
String

Muestra de código

Ejemplo de GeocodeAddresses (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función GeocodeAddress en el modo inmediato con la geocodificación multilínea. 

import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/Atlanta.gdb" 
# Set local variables:
address_table = "customers"
address_locator = "C:/ArcTutor/Geocoding/Atlanta"
address_fields = "Street Address;City City;State State;ZIP Zip"
geocode_result = "geocode_result"
arcpy.GeocodeAddresses_geocoding(address_table, address_locator, address_fields, 
                                 geocode_result, 'STATIC')
Ejemplo de GeocodeAddresses (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función GeocodeAddress en el modo inmediato con la geocodificación de una línea.

import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/Atlanta.gdb" 
# Set local variables:
address_table = "customers"
address_locator = "C:/ArcTutor/Geocoding/Atlanta"
address_fields = "'Single Line Input' SINGLELINE"
geocode_result = "singleline_geocode_result"
arcpy.GeocodeAddresses_geocoding(address_table, address_locator, address_fields, 
                                 geocode_result, 'STATIC')

Entornos

Información sobre licencias

  • ArcGIS Desktop Basic: Limitado
  • ArcGIS Desktop Standard: Sí
  • ArcGIS Desktop Advanced: Sí

Temas relacionados