| Etiqueta | Explicación | Tipo de datos |
Mapa de entrada | El mapa, escena o mapa base que se convertirá a KML. | Map |
Archivo de salida (KMZ) | El archivo KML de salida, que está comprimido y tiene una extensión .kmz. | File |
Escala del mapa de salida (Opcional) |
La escala a la que se exportará cada capa del mapa. Este parámetro es importante con cualquier dependencia de la escala, como la visibilidad de la capa o la representación en pantalla dependiente de la escala. Si la capa no está visible en la escala de salida, no se incluirá en el KML de salida. Se puede usar cualquier valor, como 1, si no hay dependencias de escala. En el caso de las capas ráster, se puede utilizar el valor 0 para crear una imagen de salida sin teselas. Si se utiliza un valor mayor o igual que 1, determina la resolución de salida del ráster. Este parámetro no afecta a las capas que no son capas ráster. Solo se admiten caracteres numéricos; por ejemplo, introduzca 20.000 como escala, no 1:20.000. En los idiomas que utilizan las comas como el punto decimal, también es aceptable 20,000. Si desea exportar una capa que se va a mostrar como vectores 3D y el parámetro Devolver una única imagen compuesta está activado, puede definir este parámetro con cualquier valor, siempre que las entidades no tengan ninguna representación dependiente de la escala. | Double |
Devolver una única imagen compuesta (Opcional) | Especifica si el KML de salida contendrá una sola imagen compuesta o capas separadas.
| Boolean |
Convertir entidades en imágenes (Opcional) | Especifica si cada capa de entidades del mapa se convertirá en una imagen ráster independiente o se conservará como entidades. Este parámetro no se utiliza si el parámetro Devolver una única imagen compuesta está activado.
| Boolean |
Extensión (Opcional) | La extensión geográfica de la capa que se va a convertir. Solo las entidades o celdas ráster de esta extensión se incluirán en el KML de salida.
| Extent |
Tamaño de la imagen devuelta (píxeles) (Opcional) | El tamaño de las teselas correspondientes a las capas ráster si el valor del parámetro Escala del mapa de salida es mayor o igual que 1. Este parámetro no afecta a las capas que no son capas ráster. | Long |
DPI de la imagen de salida (Opcional) | La resolución del dispositivo para los rásteres en el documento KML de salida. La resolución normal de la pantalla es 96dpi. Si los datos del mapa admiten alta resolución y el KML lo requiere, considere aumentar el valor. Use este parámetro con el parámetro Tamaño de la imagen devuelta (píxeles) para controlar la resolución de la imagen de salida. El valor predeterminado es 96. | Long |
Fijar entidades al suelo (Opcional) | Especifica si los valores z de las entidades de entrada se ignorarán y todas las entidades se situarán, o se fijarán, a la elevación del suelo.
| Boolean |
Origen del diseño de leyenda (Opcional) | El nombre del diseño que contiene elementos de leyenda que se incluirán en la salida KML como superposiciones de pantalla. | String |
Resumen
Convierte un mapa que contiene capas de entidades o ráster a formato KML (archivo .kmz). El KML de salida contendrá una traslación de las geometrías de la entidad, las celdas ráster, la simbología de la capa y otras propiedades de Esri.
Obtenga más información sobre la compatibilidad KML en ArcGIS
Uso
El archivo .kmz de salida es un archivo o un archivo .zip que contiene un archivo .kml y otros archivos complementarios. El archivo .kmz se puede leer con muchas aplicaciones, incluidas ArcGIS Earth y Google Earth.
Puede controlar la apariencia de KML de las dos formas siguientes:
- De manera predeterminada, la visualización emergente está compuesta por todos los campos visibles de la capa. Las ventanas emergentes también se pueden definir usando las ventanas emergentes personalizadas. Si las ventanas emergentes de la capa no se han personalizado, los valores del campo PopupInfo de la capa de entidades se muestran en la ventana emergente cuando se hace clic en una entidad KML. Estos valores pueden ser numéricos o atributos de texto, además de código HTML almacenado en un campo de texto.
- Si las propiedades de la capa no están definidas y la clase de entidad contiene determinados atributos (campos), las propiedades del campo se utilizan para crear las capas KML creadas originalmente con la herramienta De KML a capa y que incluyen atributos que definen cómo se crea el KML. Consulte Conversión de KML para obtener más información sobre la creación de un KLM a partir de los atributos.
-
Si la entrada tiene propiedades de visualización dependientes de la escala, reduzca el tamaño del archivo .kmz de salida indicando un valor del parámetro Escala del mapa de salida adecuado.
Las capas del mapa de entrada se proyectarán a WGS84, ya que todos los archivos .kmz deben utilizar ese sistema de coordenadas. Para asegurarse de que la proyección localice con exactitud las entidades y las celdas ráster, es posible que tenga que especificar el entorno de transformación geográfica. Como alternativa, utilice la herramienta Proyectar para volver a proyectar las capas del mapa a WGS84 con una transformación válida antes de convertirla a KML.
Los parámetros Escala del mapa de salida y Tamaño de la imagen devuelta (píxeles) se utilizan juntos para crear la salida en teselas. Por ejemplo, para una imagen con un tamaño de 7000 x 5000 píxeles, y un valor del parámetro Tamaño de la imagen devuelta (píxeles) de 1000 píxeles, la imagen de salida estará formada por 7 x 5, o 35, subimágenes. Si el valor del parámetro Escala del mapa de salida es 1, cada subimagen tendrá 1000 por 1000 píxeles. Si el valor del parámetro Escala del mapa de salida es 10, cada subimagen tendrá 100 por 100 píxeles.
Para incluir una leyenda en el KML de salida como superposición de pantalla, especifique un valor para el parámetro Origen del diseño de leyenda. Debe tener un elemento de leyenda en un diseño del mapa.
Solo los elementos de leyenda se convertirán en superposiciones de pantalla en KML. Cada leyenda se convertirá en una subcarpeta dentro de la carpeta KML principal al visualizar los datos KML.
Parámetros
: la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo.
: la extensión se basará en una capa de mapa activa. Use la lista desplegable para seleccionar una capa disponible o use la opción 
: extensión de todas las entidades en una capa.
: extensión de las entidades seleccionadas en la capa.
: la extensión se basará en un dataset existente.
: la extensión puede copiarse y pegarse desde el portapapeles.
: copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles.
: la extensión se restablecerá al valor predeterminado.arcpy.conversion.MapToKML(in_map, out_kmz_file, {map_output_scale}, {is_composite}, {is_vector_to_raster}, {extent_to_export}, {image_size}, {dpi_of_client}, {ignore_zvalue}, {layout})| Nombre | Explicación | Tipo de datos |
in_map | El mapa, escena o mapa base que se convertirá a KML. | Map |
out_kmz_file | El archivo KML de salida, que está comprimido y tiene una extensión .kmz. | File |
map_output_scale (Opcional) |
La escala a la que se exportará cada capa del mapa. Este parámetro es importante con cualquier dependencia de la escala, como la visibilidad de la capa o la representación en pantalla dependiente de la escala. Si la capa no está visible en la escala de salida, no se incluirá en el KML de salida. Se puede usar cualquier valor, como 1, si no hay dependencias de escala. En el caso de las capas ráster, se puede utilizar el valor 0 para crear una imagen de salida sin teselas. Si se utiliza un valor mayor o igual que 1, determina la resolución de salida del ráster. Este parámetro no afecta a las capas que no son capas ráster. Solo se admiten caracteres numéricos; por ejemplo, introduzca 20.000 como escala, no 1:20.000. En los idiomas que utilizan las comas como el punto decimal, también es aceptable 20,000. Si desea exportar una capa que se va a mostrar como vectores 3D y el parámetro is_composite está definido como NO_COMPOSITE, puede definir este parámetro con cualquier valor, siempre que las entidades no tengan ninguna representación dependiente de la escala. | Double |
is_composite (Opcional) | Especifica si el KML de salida contendrá una sola imagen compuesta o capas separadas.
| Boolean |
is_vector_to_raster (Opcional) | Especifica si cada capa de entidades del mapa se convertirá en una imagen ráster independiente o se conservará como entidades. Este parámetro no se utiliza si el parámetro is_composite se establece en COMPOSITE.
| Boolean |
extent_to_export (Opcional) | La extensión geográfica de la capa que se va a convertir. Solo las entidades o celdas ráster de esta extensión se incluirán en el KML de salida. La extensión se puede especificar mediante las siguientes opciones:
| Extent |
image_size (Opcional) | El tamaño de las teselas de las capas ráster si el valor del parámetro map_output_scale es mayor o igual que 1. Este parámetro no afecta a las capas que no son capas ráster. | Long |
dpi_of_client (Opcional) | La resolución del dispositivo para los rásteres en el documento KML de salida. La resolución normal de la pantalla es 96dpi. Si los datos del mapa admiten alta resolución y el KML lo requiere, considere aumentar el valor. Use este parámetro con el parámetro image_size para controlar la resolución de la imagen de salida. El valor predeterminado es 96. | Long |
ignore_zvalue (Opcional) | Especifica si los valores z de las entidades de entrada se ignorarán y todas las entidades se situarán, o se fijarán, a la elevación del suelo.
| Boolean |
layout (Opcional) | El nombre del diseño que contiene elementos de leyenda que se incluirán en la salida KML como superposiciones de pantalla. | String |
Muestra de código
La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función MapToKML de modo inmediato.
import arcpy
arcpy.conversion.MapToKML("C:/Maps/Cities.mapx", "C:/OutputMaps/Cities.kmz")La siguiente secuencia de comandos Pythonindependiente muestra cómo utilizar la función MapToKML en una secuencia de comandos independiente.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Use ListFiles to identify all map files in workspace
files = arcpy.ListFiles('*.mapx')
if len(files) > 0:
for map_file in files:
# Set Local Variables
composite = 'NO_COMPOSITE'
vector = 'VECTOR_TO_VECTOR'
pixels = 2048
dpi = 96
clamped = 'ABSOLUTE'
for scale in range(10000, 20000, 30000):
# Strips the '.mapx' part of the name and appends '.kmz'
outKML = map_file[:-5]+'.kmz'
# Run MapToKML
arcpy.conversion.MapToKML(map_file, outKML, scale, composite,
vector, '', pixels, dpi, clamped)
else:
arcpy.AddMessage('There are no map files (*.mapx) in {}.'.format(arcpy.env.workspace))