Resumen
Convierte grandes tablas locales de direcciones o lugares en puntos en una clase de entidad o como tablas .csv o .xls independientes. Esta herramienta utiliza localizadores alojados en un portal de ArcGIS Enterprise.
Nota:
Esta herramienta funciona en ArcGIS Pro 2.4 o versiones posteriores junto con un portal de ArcGIS Enterprise 10.7 o versiones posteriores.
Uso
Esta herramienta soporta los siguientes formatos de tabla como entrada:
- Archivo de valores separados por comas (.csv)
- Tablas de geodatabase de archivos
- Hojas de cálculo de Microsoft Excel (archivos .xls y .xlsx)
En el caso de tablas .csv de entrada, la primera fila del archivo de entrada se utiliza como los nombres de campo para la tabla de salida, además de los campos incorporados desde el localizador. Los nombres de campo no pueden contener espacios ni caracteres especiales, como $ o *.
Más información sobre cómo trabajar con archivos de Microsoft Excel en ArcGIS Pro
Nota:
La manera más rápida de devolver los resultados de geocodificación con una tabla de entrada en forma de geodatabase de archivos es limitar el contenido de la geodatabase de archivos o proporcionar una geodatabase de archivos que contenga una única tabla.
Puede geocodificar direcciones almacenadas en un único campo o en varios campos. Un único 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 Dirección, Ciudad, Estado y CP 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.
Esta herramienta requiere un portal de ArcGIS Enterprise 10.7 o versiones posteriores.
Si algún localizador del portal no está disponible como servicio de utilidades en el portal, pida a su administrador del portal que lo agregue como servicio de utilidades del portal y configure el localizador para la geocodificación por lotes.
Use un localizador del portal de ArcGIS Enterprise configurado para utilizar varios subprocesos para mejorar el rendimiento de geocodificación.
Los resultados de geocodificación se guardan en la misma referencia espacial que el localizador. Puede cambiar la referencia espacial de la salida estableciendo un sistema de coordenadas de salida diferente en la configuración del entorno de la herramienta.
Los resultados de geocodificación contendrán toda la información de geocodificación relevante, por ejemplo, puntuación, estado y dirección coincidente de cada registro, además de los valores de la tabla de entrada original. Los resultados de geocodificación de esta herramienta contienen una instantánea estática de la tabla de entrada original, por lo que al agregar o actualizar los valores en la tabla original no se actualizarán los resultados del archivo de salida. Vuelva a ejecutar la herramienta para crear un archivo de salida que contenga dichos cambios.
Cuando los resultados de geocodificación se devuelven como clase de entidad, las direcciones se pueden volver a geocodificar con la herramienta Repetir geocodificación de direcciones o la opción Repetir geocodificación de direcciones que abre el panel Repetir geocodificación de direcciones.
Nota:
La tabla se debe geocodificar con un localizador en un portal de ArcGIS Enterprise 10.8 que tenga más de un subproceso para la geocodificación por lotes.
Obtenga más información sobre cómo repetir la geocodificación de los resultados de geocodificación.
Sintaxis
arcpy.geocoding.GeocodeFile(in_table, locator, address_fields, output_type, output_location, output_name, {country}, {location_type}, {category}, {output_fields})| Parámetro | Explicación | Tipo de datos |
in_table | La tabla de entrada que contiene direcciones o lugares para geocodificar en formato CSV, XLS o XLSX, o en una tabla de geodatabase de archivos. | Record Set |
locator | El localizador del portal que se utilizará para geocodificar la tabla. Puede seleccionar un localizador de la lista rellenada de localizadores en el portal activo o buscar otros localizadores disponibles en el portal activo. Los localizadores que hayan sido definidos como servicios de utilidad en el portal activo estarán disponibles de forma predeterminada. Nota:La opción ArcGIS World Geocoding Service está deshabilitada para esta herramienta. Use la herramienta Geocodificar direcciones si desea utilizar ArcGIS World Geocoding Service. | Address Locator |
address_fields | Cada asignación de campos en este parámetro está en el formato input_locator_field, table_field_name, donde input_locator_field es el nombre del campo de dirección de entrada especificado por el localizador 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 almacene la dirección completa; por ejemplo, 303 Peachtree St NE, Atlanta GA 30308. Otra alternativa es especificar varios campos si las direcciones de entrada están divididas en diferentes campos, como Dirección, Ciudad, Estado y CP 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 se convierten en 100 Main St Apt 140 al geocodificar. Si decide no asignar un campo de dirección de entrada opcional empleado por el localizador a un campo de la tabla de entrada de direcciones, especifique que no hay asignación utilizando <None> en lugar de un nombre de campo. | Field Info |
output_type | Especifica el tipo de archivo en el que se escribirán los resultados de la geocodificación.
| String |
output_location | La carpeta en la que se escribirán los resultados de la geocodificación de salida. Si la salida es un archivo .csv o .xls, se colocará un archivo de salida en la carpeta especificada. Si la salida es una clase de entidad, se creará una geodatabase de archivos de salida y se colocará en la carpeta especificada, y la nueva geodatabase de archivos contendrá la clase de entidad geocodificada. La geodatabase de archivos de salida y la clase de entidad de la geodatabase de archivos tendrán el mismo nombre. | Workspace |
output_name | El nombre de los resultados geocodificados de salida. | String |
country [country,...] (Opcional) | El país o países en los que se buscarán las direcciones geocodificadas. Este parámetro está disponible para localizadores compatibles con un parámetro de país y limita la geocodificación a los países seleccionados. 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 países en el parámetro Tabla de entrada se asigna al Rol: Nombre de campo de Country, el valor del país del parámetro Tabla de entrada invalidará el parámetro País. Cuando no se especifica ningún país, la geocodificación se realiza en todos los países compatibles del localizador. Especifique el valor de entrada como un código de país de 3 caracteres de la norma ISO 3166-1. El parámetro País no es compatible con todos los localizadores. | 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, 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 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 obtener más información sobre el parámetro locationType para reverseGeocode. Este parámetro no es compatible con todos los localizadores.
| String |
category [category,...] (Opcional) | Limita los tipos de lugares que busca el localizador, eliminando así las coincidencias de falsos positivos y aumentando potencialmente el proceso de búsqueda. Cuando no se utiliza ninguna categoría, la geocodificación se realiza en todas las categorías compatibles. No todos los valores de categoría son compatibles con todas las ubicaciones y países. En general, el parámetro Categoría se puede utilizar para:
Este parámetro no es compatible con todos los localizadores. Consulte la página web de Ayuda de la API REST para obtener más información sobre el filtrado por categoría. | String |
output_fields (Opcional) | Especifica qué campos de salida del localizador se devuelven en los resultados de geocodificación. Nota:Este parámetro se puede utilizar con localizadores de entrada creados con la herramienta Crear localizador o la herramienta Crear localizador de entidades publicados en Enterprise 10.9 o posterior. Los localizadores compuestos que contienen al menos un localizador creado con la herramienta Crear localizador de direcciones no admiten este parámetro.
| String |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| out_feature_class | La clase de entidad de salida. | Clase de entidad |
| out_table | La tabla de salida en formato CSV o XLS, en función del valor de Tipo de salida. | Tabla |
Muestra de código
El siguiente script de Python muestra cómo utilizar la función GeocodeFile en un script independiente.
import arcpy
arcpy.SignInToPortal("https://<machine_name>/<portal_web_adaptor_name>",
'<username>', '<password>')
# Input is a local table
input_table = r"C:\data\customers.csv"
# This tool works with locators on your portal
in_locator = "https://<machine_name>/server/rest/services/<service_name>/GeocodeServer/<service_name>"
# The easiest way to generate a field mapping is to run the tool in ArcGIS
# Pro and right-click the green success ribbon and click "Copy Python command"
field_mapping = "'Address or Place' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;Neighborhood <None> VISIBLE NONE;
City <None> VISIBLE NONE;County <None> VISIBLE NONE;State <None> VISIBLE NONE;ZIP ZIP VISIBLE NONE;ZIP4 <None> VISIBLE NONE;Country <None> VISIBLE NONE"
output_type = "FEATURE_CLASS"
# Output folder for the output CSV, Excel, or GDB table. If user selects
# FEATURE_CLASS output_type, a new GDB will be created in the
# output_folder with the geocoding results
output_folder = r"C:\data\outputs"
output_name = "Geocoding_output"
# Optional geocoding parameters. Only some are supported depending on the
# in_locator that you use.
country = None
location_type = "ROUTING_LOCATION"
category = "'Street Address'"
arcpy.geocoding.GeocodeFile(input_table, in_locator, field_mapping, output_type,
output_folder, output_name, country, location_type,
category)Información de licenciamiento
- Basic: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis
- Standard: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis
- Advanced: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis