Resumen
Importa directorios de KML, KMZ, shapefiles, hojas de cálculo de Excel, archivos de texto tabular, GeoJSON y archivos GPX a clases de entidad almacenadas en una única geodatabase.
Uso
La ubicación Datos de entrada se buscará de forma recursiva, de manera predeterminada, para KML (.kml), KMZ (.kmz), shapefiles (.shp), libros de trabajo de Excel (.xlsx y .xls), archivos de texto tabular (.csv, .txt y .tab), archivos GeoJSON (.geojson) y archivos GPX (.gpx). El parámetro Filtro se puede utilizar para limitar los archivos que se importan.
Los rásteres o las superposiciones terrestres que se encuentren en un archivo KML o KMZ se convierten en un dataset de mosaico dentro de la Geodatabase de destino. Los rásteres de origen a los que hace referencia el dataset de mosaico se almacenan en su formato nativo en una subcarpeta con el nombre del dataset de mosaico. Se ubica en la misma ubicación que la geodatabase de destino. Estos archivos llevan el nombre de la Geodatabase de destino y se incorporan con _Rasters. Por ejemplo, si su Geodatabase de destino es C:\Data\OperationalData.gdb, se crea una carpeta llamada OperationalData_Rasters en C:\Data.
Si importa archivos a una geodatabase corporativa, asegúrese de que el archivo de conexión de base de datos (.sde) se especifica como ruta UNC en el parámetro Geodatabase de destino y que la geodatabase corporativa pueda acceder a la ruta.
Por lo general, se admiten entradas KML y KMZ hasta la versión 2.2 de KMZ del estándar KML del Consorcio Geoespacial abierto. Las ubicaciones de puntos que utilizan la pestaña de dirección (a modo de geocodificación) no se admiten. Se requiere de valores válidos de latitud y longitud de la ubicación dentro del KML de origen.
El delimitador estándar para los archivos de texto tabular con extensiones .csv y .txt es una coma; para los archivos con extensión .tab, es una tabulación. Para usar una tabla de entrada con un delimitador no estándar, dicho delimitador se debe especificar con un archivo schema.ini. Consulte el archivo Schema.ini (controlador de archivo de texto) en la documentación de Microsoft para obtener más información.
En el caso de las hojas de cálculo de Excel de entrada y archivos de texto tabular, tan solo se admite la geometría de punto.
La especificación GeoJSON admite varios tipos de geometría. Se creará una clase de entidad distinta por cada tipo de geometría del archivo GeoJSON de entrada con el formato de nombre ArchivoGeoJSONdeOrigen_TipoDeGeometría. Por ejemplo, si el archivo GeoJSON se llama World Airports.geojson y contiene tipos de geometría de punto, multipunto, polilínea y polígono, las clases de entidad se llamarán World Airports_Points, World Airports_Multipoint, World Airports_Polylines y World Airports_Polygons.
Los sistemas de coordenadas tienen en cuenta lo siguiente al ejecutar esta herramienta:
- En el caso de shapefiles, KML, KMZ, GeoJSON, y archivos GPX, el sistema de coordenadas del dataset de salida será el mismo que el dataset de entrada. Las especificaciones KML y GPX exigen que el sistema de coordenadas del dataset de entrada sea GCS WGS1984.
- En el caso de los libros de trabajo de Excel y archivos de texto tabular, se asume que el sistema de coordenadas de la entrada es GCS WGS1984 y que los valores de las coordenadas de longitud y latitud están en grados decimales.
Si alguna de las coordenadas de longitud o latitud de entrada de una entidad no es válida (valores nulos o no numéricos), la entidad correspondiente tendrá una geometría nula. La herramienta Verificar geometría se puede utilizar para comprobar la existencia de geometrías nulas en la salida.
Los archivos de texto tabular (.csv, .txt y .tab) y las hojas de cálculo de Excel deben tener una columna de longitud y latitud. Las columnas de longitud válidas son longitude, long, lon, x_coordinate, x_coord y x. Las columnas de latitud válidas son latitude, lat, y_coordinate, y_coord y y. Si el origen tiene varias columnas de longitud y latitud válidas, se utiliza la primera columna válida.
Se importarán todas las hojas de cálculo de un libro de trabajo de Excel.
Se aplica simbología a las capas de salida agregadas al mapa en función de la simbología de los archivos de datos de origen de esta manera:
Nota:
Debe existir un mapa activo en el proyecto ArcGIS Pro en el momento de la ejecución de la herramienta para mantener la simbología. Si la herramienta se ejecuta fuera de un proyecto ArcGIS Pro (es decir, desde un script independiente de Python), la simbología no se conservará.- En el caso de capas de salida creadas desde archivos KML o KMZ, la simbología se extrae desde el archivo KML o KMZ de origen que se aplica a las capas de salida. Dicha simbología se puede invalidar si se proporciona un archivo de capa (.lyrx o .lyr) en la misma carpeta donde está el archivo KML o KMZ de origen. El archivo de capa debe tener el mismo nombre base que el archivo de datos de origen, incorporado con un guion bajo (_), así como el tipo de geometría (puntos, polilíneas o polígonos) de la capa a invalidar. Por ejemplo, si el archivo KML se llama World Airports.kml y contiene entidades poligonales, de punto o de línea, y desea invalidar la simbología de todos los tipos de geometría, los archivos de capa se llamarían World Airports_Points.lyrx, World Airports_Polylines.lyrx y World Airports_Polygons.lyrx. En los valores del tipo de geometría se distingue entre mayúsculas y minúsculas. Si no existe ningún archivo de capa para un tipo de geometría determinado, se aplica la simbología del archivo KML o KMZ de origen a la capa de salida.
- En el caso de capas de salida creadas a partir de orígenes que no son archivos KML ni KMZ, se aplica una simbología a la capa de salida si existe un archivo de capa (.lyrx o .lyr) en la misma carpeta que el archivo de datos de origen. El archivo de capa debe tener el mismo nombre base que el archivo de datos de origen, salvo las hojas de cálculo de Excel y archivos GeoJSON. En el caso de las hojas de cálculo de Excel, el archivo de capa debe tener el mismo nombre que el nombre base del archivo de datos de origen, incorporado con un guion bajo (_) más el nombre de la hoja de cálculo. Por ejemplo, si el archivo de Excel se llama World.xlsx y contiene una hoja de cálculo llamada Cities (2018), el archivo de capa se debe llamar World_Cities (2018).lyrx o World_Cities (2018).lyr. En el caso de los archivos GeoJSON, el archivo de capa debe tener el mismo nombre que el nombre base del archivo de datos de origen, incorporado con un guion bajo (_) más el tipo de geometría de salida: puntos, multipunto, polilíneas y polígonos. Si no existe ningún archivo de capa, se aplica un símbolo predeterminado a la capa de salida.
Sintaxis
arcpy.intelligence.BatchImportData(in_data, target_gdb, {filter}, {include_sub_folders}, {include_groundoverlay})| Parámetro | Explicación | Tipo de datos |
in_data [in_data,...] | Los directorios con los archivos de datos que desea convertir a clases de entidad de geodatabase. | Folder |
target_gdb | La geodatabase de destino donde se almacenarán las clases de entidad de salida. | Workspace |
filter (Opcional) | Un filtro para los datos que se agregan a la geodatabase. Los caracteres comodín del filtro trabajan en la ruta completa de los datos de entrada y se enuncian a continuación:
Estos son algunos ejemplos de filtro:
| String |
include_sub_folders (Opcional) | Especifica si las subcarpetas se explorarán de forma recursiva.
| Boolean |
include_groundoverlay (Opcional) | Especifica si la superposición terrestre KML o KMZ (ráster, fotos aéreas, etc.) se incluye en la salida. Tenga precaución si el KMZ apunta a un servicio de imágenes ráster. La herramienta intentará traducir las imágenes ráster en todas las escalas disponibles. Este proceso podría ser prolongado y posiblemente desbordar el servicio.
| Boolean |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| out_geodatabase | La geodatabase de destino actualizada. | Espacio de trabajo |
Muestra de código
El siguiente script de la ventana de Python demuestra cómo utilizar la función BatchImportData en el modo inmediato:
import arcpy
arcpy.BatchImportData_intelligence("c:/data/sourcedata", "c:/data/output.gdb", "", "SUBFOLDERS", "NO_GROUNDOVERLAY")El siguiente script de Python muestra cómo utilizar la función BatchImportData en un script independiente:
# Name: BatchImportData_Example2.py
# Description: Imports all shapefiles with 'airport' in the file name or file
# path within a directory to feature classes in a single geodatabase.
# Requirements: Standard or Advanced license
# Import system modules
import arcpy
# Set local variables
in_data = ["c:/data/sourcedata"]
target_gdb = r"\\data\operationaldata.sde"
filter = "*airports*.shp"
include_sub_folders = "NO_SUBFOLDERS"
# Execute BatchImportData
arcpy.BatchImportData_intelligence(in_data, target_gdb, filter, include_sub_folders)Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí