De mapa a KML (Conversión)

Resumen

Convierte un mapa en un archivo KML que contiene geometrías y simbología. El archivo de salida está comprimido mediante compresión ZIP, tiene una extensión .kmz y lo puede leer cualquier cliente de KML, incluidos ArcGIS Earth y Google Earth.

Obtenga más información sobre la compatibilidad KML en ArcGIS

Uso

  • 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.

  • Puede reducir el tamaño del documento KMZ de salida si el mapa posee propiedades de visualización de capa dependientes de la escala y selecciona una escala de salida de mapa apropiada.

  • Todos los archivos .kml y .kmz se crean en el sistema de coordenadas WGS84. Asegúrese de que sus capas se proyectarán correctamente si no están en WGS84. Puede usar la herramienta Proyectar para volver a proyectar los datos antes de la conversión KML si la proyección requiere una transformación.

  • Para conseguir una sola imagen ráster desplegada sobre topografía, utilice el parámetro Devolver imagen compuesta individual.

  • Para conseguir que cada capa sea una imagen ráster por separado, utilice el parámetro Convertir vector a ráster.

  • 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 se establece en 1, cada subimagen será de 1000 x 1000 píxeles. Si el valor del parámetro Escala del mapa de salida se establece en 10, cada subimagen será de 100 x 100 píxeles.

  • Para incluir una leyenda en el KML de salida, 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.

    El KML de salida incluirá la leyenda como una superposición de pantalla. 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. Configure la posición de la superposición de pantalla activando la posición en el árbol de carpetas KML.

Parámetros

EtiquetaExplicaciónTipo de datos
Mapa de entrada

El mapa, la escena o el mapa base que se convertirá a KML.

Map
Archivo de salida

El archivo KML de salida. Este archivo está comprimido y tiene una extensión .kmz. El archivo lo puede leer cualquier cliente de KML, incluidos ArcGIS Earth y Google Earth.

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 un GroundOverlay KML. 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 parámetro Convertir vector a ráster determina si las capas se devuelven como rásteres o como una combinación de vectores y rásteres.
Boolean
Convertir vector a ráster
(Opcional)

Especifica si cada capa vectorial del mapa se convertirá en una imagen ráster independiente o se conservará como capas vectoriales.

Este parámetro está inactivo si el parámetro Devolver una única imagen compuesta está activado.

  • Activado: las capas vectoriales 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 determinados clientes KML.
  • Desactivado: las capas vectoriales se conservarán como vectores KML. Esta es la opción predeterminada.
Boolean
Extensión a exportar
(Opcional)

La extensión geográfica del área a exportar. Especifique los límites del rectángulo de extensión como una cadena de coordenadas geográficas WGS84 delimitada por espacios siguiendo la forma izquierda abajo derecha arriba (x-mín., y-mín., x-máx., y-máx.).

  • Valor predeterminado: la extensión se basará en la extensión máxima de todas las entradas participantes. Esta es la opción predeterminada.
  • Extensión de visualización actual: la extensión es igual al marco de datos o visualización actual. La opción no está disponible cuando no hay ningún mapa activo.
  • Como se especifica en la parte inferior: la extensión se basará en los valores mínimo y máximo de extensión que se especifiquen.
  • Examinar: la extensión se basará en un dataset existente.
Extent
Tamaño de la imagen devuelta (píxeles)
(Opcional)

El tamaño de las teselas de las capas ráster si el valor del parámetro Escala del mapa de salida está establecido en un valor mayor o igual que 1. Este parámetro solo tiene efecto en las capas ráster.

Long
Puntos por pulgada (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 se utiliza 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
Entidades sujetas al suelo
(Opcional)

Especifica si las entidades se fijarán al suelo.

  • Activado: los valores z de las entidades de entrada se ignorarán y se creará la salida KML con las entidades fijadas al suelo. Las entidades se desplegarán sobre el terreno. Utilice esta opción cuando las entidades no tengan valores z. Esta es la opción predeterminada.
  • Desactivado: se utilizarán los valores z de las entidades de entrada al crear la salida KML. 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 de un 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, la escena o el mapa base que se convertirá a KML.

Map
out_kmz_file

El archivo KML de salida. Este archivo está comprimido y tiene una extensión .kmz. El archivo lo puede leer cualquier cliente de KML, incluidos ArcGIS Earth y Google Earth.

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 un GroundOverlay KML. Esta opción reduce el tamaño del KML de salida. Las entidades y capas individuales del KML no son seleccionables.
  • NO_COMPOSITEEl KML contiene capas individuales separadas. Esta es la opción predeterminada. El 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 vectorial del mapa se convertirá en una imagen ráster independiente o se conservará como capas vectoriales.

Este parámetro está deshabilitado si el parámetro is_composite está establecido en COMPOSITE.

  • VECTOR_TO_IMAGELas capas vectoriales 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 determinados clientes KML.
  • VECTOR_TO_VECTORLas capas vectoriales se conservarán como vectores KML. Esta es la opción predeterminada.
Boolean
extent_to_export
(Opcional)

La extensión geográfica del área a exportar. Especifique los límites del rectángulo de extensión como una cadena de coordenadas geográficas WGS84 delimitada por espacios siguiendo la forma izquierda abajo derecha arriba (x-mín., y-mín., x-máx., y-máx.).

  • MAXOF: se utilizará la extensión máxima de todas las entradas.
  • MINOF: se utilizará el área mínima en común de todas las entradas.
  • DISPLAY: la extensión es igual a la visualización actual.
  • Nombre de capa: se utilizará la extensión de la capa especificada.
  • Objeto de Extent: se utilizará la extensión del objeto especificado.
  • Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como 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 está establecido en un valor mayor o igual que 1. Este parámetro solo tiene efecto en las 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 las entidades se fijarán al suelo.

  • CLAMPED_TO_GROUNDLos valores z de las entidades de entrada se ignorarán y se creará la salida KML con las entidades fijadas al suelo. Las entidades se desplegarán sobre el terreno. Utilice esta opción cuando las entidades no tengan valores z. Esta es la opción predeterminada.
  • ABSOLUTESe utilizarán los valores z de las entidades al crear la salida KML. Las entidades se dibujarán en los clientes KML en relación con el nivel del mar.
Boolean
layout
(Opcional)

El nombre de un 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)

El siguiente script de la ventana de Python demuestra cómo utilizar la función MapToKML de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.MapToKML("cities.mapx", "cities.kmz")
Ejemplo 2 de MapToKML (secuencia de comandos independiente)

El siguiente script de Python demuestra cómo utilizar la función MapToKML en un script 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))

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados