De mapa a KML (Conversión)

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

EtiquetaExplicaciónTipo 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.

  • Activado: el KML de salida contendrá una sola imagen que combina todas las entidades del mapa en una sola imagen ráster. El ráster se despliega sobre el terreno como GroundOverlay de KLM. Esta opción reduce el tamaño del KML de salida. Las entidades y capas individuales del KML no son seleccionables.
  • Desactivado: el KML de salida contendrá capas individuales separadas. Esta es la opción predeterminada. El valor del parámetro Convertir entidades en imágenes determina si las capas se devuelven como rásteres o como una combinación de vectores y rásteres.
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.

  • Activado: las capas de entidades se convertirán en una imagen ráster separada en la salida KML. También se agregan capas ráster normales a la salida KML. Cada capa ráster KLM de salida es seleccionable y su transparencia se puede ajustar en determinadas aplicaciones de visor KML.
  • Desactivado: las entidades se conservarán en el KML de salida como geometrías de entidades. Esta es la opción predeterminada.
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.

  • Extensión de visualización actual Vista de mapa: la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo.
  • Extensión de mapa Capa: 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 datos en todas las capas para obtener la extensión combinada de todas las capas de mapas activos, excepto el mapa base. Esta opción solo está disponible cuando haya un mapa activo con capas.
  • Examinar Examinar: la extensión se basará en un dataset existente.
  • Restablecer extensión Restablecer: la extensión se restablecerá al valor predeterminado.
  • Coordenadas introducidas de forma manual: las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo.

    Puede que el mapa esté utilizando unidades de visualización diferentes

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.

  • Activado: 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. Si las entidades de entrada no tienen valores z, siempre se fijarán al suelo. Esta es la opción predeterminada.
  • Desactivado: los valores z de las entidades se mantendrán en el KML de salida. Las entidades se dibujarán en los clientes KML en relación con el nivel del mar.
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

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})
NombreExplicaciónTipo 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.

  • COMPOSITEEl KML de salida contendrá una sola imagen que combina todas las entidades del mapa en una sola imagen ráster. El ráster se despliega sobre el terreno como GroundOverlay de KLM. Esta opción reduce el tamaño del KML de salida. Las entidades y capas individuales del KML no son seleccionables.
  • NO_COMPOSITEEl KML de salida contendrá capas individuales separadas. Esta es la opción predeterminada. El valor del parámetro is_vector_to_raster determina si las capas se devuelven como rásteres o como una combinación de vectores y rásteres.
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.

  • VECTOR_TO_IMAGELas capas de entidades se convertirán en una imagen ráster separada en la salida KML. También se agregan capas ráster normales a la salida KML. Cada capa ráster KLM de salida es seleccionable y su transparencia se puede ajustar en determinadas aplicaciones de visor KML.
  • VECTOR_TO_VECTORLas entidades se conservarán en el KML de salida como geometrías de entidades. Esta es la opción predeterminada.
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:

  • MAXOF: se usará la extensión máxima de todas las entradas.
  • MINOF: se usará el área mínima común a todas las entradas.
  • DISPLAY: la extensión es igual a la visualización visible.
  • Nombre de capa: se usará la extensión de la capa especificada.
  • Objeto Extent: se usará la extensión del objeto especificado.
  • Cadena de caracteres con las coordenadas delimitadas por espacios: se usará la extensión de la cadena especificada. Las coordenadas se expresan en el orden x-min, y-min, x-max, y-max.
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.

  • ABSOLUTELos valores z de las entidades se mantendrán en el KML de salida. Las entidades se dibujarán en los clientes KML en relación con el nivel del mar.
  • CLAMPED_TO_GROUNDLos 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. Si las entidades de entrada no tienen valores z, siempre se fijarán al suelo. Esta es la opción predeterminada.
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

Ejemplo 1 de MapToKML (ventana de Python)

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")
Ejemplo 2 de MapToKML (secuencia de comandos independiente)

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))