Si el valor de Datos de entrada es una carpeta, se buscará de forma recursiva para obtener archivos KML (.kml) y 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 de las carpetas.
Los rásteres o las superposiciones terrestres que se encuentren en un archivo .kml o .kmz se convierten en un dataset de mosaico en el parámetro 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 del valor de Geodatabase de destino y se incorporan con _Rasters. Por ejemplo, si el valor de 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 especifique 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 una ubicación de latitud y longitud válida en el 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 puntos, multipuntos, polilíneas y polígonos, las clases de entidad se llamarán World Airports_Puntos, World Airports_Multipuntos, World Airports_Polilíneas y World Airports_Polígonos.
Los sistemas de coordenadas tienen en cuenta lo siguiente al ejecutar esta herramienta:
- En el caso de shapefiles y archivos .kml, .kmz, .geojson y .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, el sistema de coordenadas de la salida será GCS WGS1984.
Si alguna de las coordenadas de entrada de una entidad no es válida (notación de coordenadas nula o no válida), la entidad correspondiente tendrá una geometría nula. La herramienta Verificar geometría se puede utilizar para identificar geometrías nulas en la salida.
Las coordenadas admitidas para los archivos de texto tabular (.csv, .txt y .tab) y las hojas de cálculo de Excel son latitud y longitud en grados decimales, Sistema de Referencia de Cuadrícula Militar (MGRS) y Cuadrícula Cartográfica Nacional de EE. UU. (USNG). En el origen se buscan columnas de coordenadas en el siguiente orden: latitud y longitud en columnas independientes, latitud y longitud en una sola columna, MGRS y, por último, USNG.
Para los valores de latitud y longitud en una sola columna, el valor de latitud debe estar primero y, a continuación, la longitud separada por un espacio, una coma o una barra diagonal.
Los siguientes son nombres de columna válidos:
- Latitud: latitude, lat, y_coordinate, y_coord y y
- Longitud: longitude, long, lon, x_coordinate, x_coord y x
- Latitud/longitud: latitude_longitude, lat_long, lat_lon, xy_coordinate, xy_coordinates, xy_coord, xy_coords y xy
- Coordenada MGRS: mgrs, mgrs_coordinate, mgrs_coordinates, mgrs_coord y mgrs_coords
- Coordenada USNG: usng, usng_coordinate, usng_coordinates, usng_coord y usng_coords
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:
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.