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
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 los Estados Unidos.
Algunos localizadores admiten varios campos de direcciones de entrada tales como Address, Address2 y Address3. En este caso, el componente de dirección se puede separar en varios campos y los campos de dirección se concatenarán en el momento de la geocodificación. Por ejemplo, 100, Main St y Apt 140 en tres campos, o 100 Main St y Apt 140 en dos campos, ambos se convertirían en 100 Main st Apt 140 al geocodificar.
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
arcpy.geocoding.GeocodeAddresses(in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type})| Parámetro | Explicación | Tipo 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 único campo de entrada que almacena la dirección completa; por ejemplo, 303 Peachtree St NE, Atlanta GA 30308. 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. Algunos localizadores admiten varios campos de direcciones de entrada tales como Address, Address2 y Address3. En este caso, el componente de dirección se puede separar en varios campos y los campos de dirección se concatenarán en el momento de la geocodificación. Por ejemplo, 100, Main St y Apt 140 en tres campos, o 100 Main St y Apt 140 en dos campos, ambos se convertirían en 100 Main st Apt 140 al geocodificar. 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.
| 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. El valor de entrada se debería especificar siguiendo los códigos de países 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. Consulte la página web de la Ayuda de la API REST para obtener más información sobre el parámetro locationType para geocodeAddresses. Este parámetro no es compatible con todos los localizadores.
| 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 de licenciamiento
- Basic: Limitado
- Standard: Sí
- Advanced: Sí