De capa a KML (Conversión)

Resumen

Convierte una entidad o una capa ráster a formato KML (archivo .kmz o .kml) que contiene una traslación de simbología y geometrías de Esri.

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

Uso

  • La salida predeterminada de la herramienta tiene la extensión .kmz, que 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 seleccionando un valor del parámetro Escala de salida de la capa adecuado.

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

  • Las entidades de entrada con adjuntos se incluirán en el archivo .kmz de salida. Tenga en cuenta las condiciones siguientes para los adjuntos en los archivos .kmz:

    • Los adjuntos pueden incrementar considerablemente el tamaño del archivo de salida.
    • Cuando el archivo .kml se utiliza en un cliente KML, los adjuntos están disponibles en los elementos emergentes de KML.
    • Los adjuntos se pueden excluir desactivando la configuración del entorno Mantener adjuntos antes de ejecutar la herramienta.
    • No todos los clientes de KML admiten la visualización de adjuntos de la misma forma. Algunas aplicaciones cliente de KML son más compatibles con adjuntos como imágenes y documentos PDF.

    Los adjuntos no se incluirán si la salida es un archivo .kml.

  • Los parámetros Escala de la capa de Salida y Tamaño de la imagen devuelta (píxeles) se utilizan juntos para crear una salida de 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 de la Capa de Salida se configura en 1, cada subimagen tendrá 1000 por 1000 píxeles. Si el valor del parámetro Escala de la Capa de Salida se configura en 10, cada subimagen tendrá 100 por 100 píxeles.

Parámetros

EtiquetaExplicaciónTipo de datos
Capa de entrada

La entidad, la capa ráster o el archivo de capa (.lyrx) que se va a convertir a formato KML.

Feature Layer; Raster Layer; Mosaic Layer; Group Layer; Layer File
Archivo de salida (.kmz o .kml)

El archivo .kmz o .kml de salida. El archivo de salida puede utilizar una extensión .kmz para generar un archivo o archivo comprimido, o bien una extensión .kml para generar un archivo en formato KML básico.

Los archivos .kmz de salida admiten capas ráster, simbología y otras propiedades de capas, adjuntos y otras entidades avanzadas. Los archivos .kml de salida utilizarán propiedades y símbolos KML básicos.

File
Escala de la capa de salida
(Opcional)

La escala del archivo de salida. En el caso de las capas ráster, se puede utilizar el valor 0 para crear una imagen de salida sin teselas. El uso de un valor mayor o igual que 1 determinará la resolución de salida del ráster. Este parámetro no afecta a las capas que no son capas ráster.

Double
Devolver una única imagen compuesta
(Opcional)

Especifica si la salida será una sola imagen compuesta. Este parámetro solo se aplica si especifica el archivo con formato KML de salida con una extensión .kmz, ya que los archivos .kml de salida no admiten imágenes ni rásteres de superposición de terrenos.

  • Activado: la salida será una única imagen compuesta que representa las entidades ráster o vectoriales de la capa de origen. El ráster se despliega sobre el terreno como un GroundOverlay. Utilice esta opción para reducir el tamaño del archivo de salida. Si se utiliza esta opción, las entidades y capas individuales del archivo .kml no se pueden seleccionar. Solo los archivos .kmz de salida admiten imágenes.
  • Desactivado: si la capa de entrada posee entidades vectoriales, se conservarán como vectores KML.
Boolean
Extensión a exportar
(Opcional)

La extensión geográfica del área a exportar. Defina el cuadro de extensión (en el sistema de coordenadas WGS84) o elija una capa o dataset que defina una extensión.

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

Tamaño de las teselas correspondientes a las capas ráster cuando el parámetro Escala de la Capa de Salida se configura en un valor mayor o igual que 1. Este parámetro no afecta a las capas que no son capas ráster.

Long
Puntos por pulgada (DPI) de la imagen de salida
(Opcional)

La resolución del dispositivo para la salida de KML cuando se activa el parámetro Devolver imagen compuesta individual. 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.

Este parámetro no remuestrea rásteres de origen. Para los rásteres de entrada se tomará una instantánea que se incluirá en la salida KML como una imagen .png sencilla.

Long
Entidades sujetas al suelo
(Opcional)

Especifica si los valores z de las entidades de entrada se invalidarán.

  • Activado: los valores z de las entidades se invalidarán y se desplegarán sobre el terreno. Esta configuración se utiliza para las entidades que no tienen valores z. Esta es la opción predeterminada.
  • Desactivado: los valores z de las entidades se respetarán. Las entidades se dibujarán en los clientes KML en relación con el nivel del mar.
Boolean

arcpy.conversion.LayerToKML(layer, out_kmz_file, {layer_output_scale}, {is_composite}, {boundary_box_extent}, {image_size}, {dpi_of_client}, {ignore_zvalue})
NombreExplicaciónTipo de datos
layer

La entidad, la capa ráster o el archivo de capa (.lyrx) que se va a convertir a formato KML.

Feature Layer; Raster Layer; Mosaic Layer; Group Layer; Layer File
out_kmz_file

El archivo .kmz o .kml de salida. El archivo de salida puede utilizar una extensión .kmz para generar un archivo o archivo comprimido, o bien una extensión .kml para generar un archivo en formato KML básico.

Los archivos .kmz de salida admiten capas ráster, simbología y otras propiedades de capas, adjuntos y otras entidades avanzadas. Los archivos .kml de salida utilizarán propiedades y símbolos KML básicos.

File
layer_output_scale
(Opcional)

La escala del archivo de salida. En el caso de las capas ráster, se puede utilizar el valor 0 para crear una imagen de salida sin teselas. El uso de un valor mayor o igual que 1 determinará la resolución de salida del ráster. Este parámetro no afecta a las capas que no son capas ráster.

Double
is_composite
(Opcional)

Especifica si la salida será una sola imagen compuesta. Este parámetro solo se aplica si especifica el archivo con formato KML de salida con una extensión .kmz, ya que los archivos .kml de salida no admiten imágenes ni rásteres de superposición de terrenos.

  • COMPOSITELa salida será una única imagen compuesta que representa las entidades ráster o vectoriales de la capa de origen. El ráster se despliega sobre el terreno como un GroundOverlay. Utilice esta opción para reducir el tamaño del archivo de salida. Si se utiliza esta opción, las entidades y capas individuales del archivo .kml no se pueden seleccionar. Solo los archivos .kmz de salida admiten imágenes.
  • NO_COMPOSITESi la entrada posee entidades vectoriales, se conservarán como vectores KML.
Boolean
boundary_box_extent
(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 abajo izquierda y arriba derecha (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 layer_output_scale está establecido en un valor 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 la salida de KML cuando el parámetro is_composite está establecido en COMPOSITE. Este parámetro se utiliza con el parámetro image_size para controlar la resolución de la imagen de salida.

Este parámetro no remuestrea rásteres de origen. Para los rásteres de entrada se tomará una instantánea que se incluirá en la salida KML como una imagen .png sencilla.

Long
ignore_zvalue
(Opcional)

Especifica si los valores z de las entidades de entrada se invalidarán.

  • ABSOLUTELos valores z de las entidades se respetarán. 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 se invalidarán y se desplegarán sobre el terreno. Esta configuración se utiliza para las entidades que no tienen valores z. Esta es la opción predeterminada.
Boolean

Muestra de código

Ejemplo 1 de LayerToKML (ventana de Python)

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

import arcpy
arcpy.conversion.LayerToKML("buildings", "c:/outputKMZs/bldg.kmz")
Ejemplo 2 de LayerToKML (secuencia de comandos independiente)

El siguiente script de Python demuestra cómo utilizar la función LayerToKML en un script independiente.


# Description: The following stand-alone script demonstrates how to find 
#              all layer files in a given workspace and export each to 
#              a KML at the 1:10,000, 1:20,000, and 1:30,000 scale using
#              the LayerToKML tool.
import arcpy

arcpy.env.workspace = "C:/data"

# Set Local Variables
composite = 'NO_COMPOSITE'
pixels = 2048
dpi = 96
clamped = 'CLAMPED_TO_GROUND'

# Use the ListFiles method to identify all lyr and lyrx files in workspace
layers = arcpy.ListFiles("*.lyr*") 

if len(layers) > 0:
    for layer in layers:        
        # Strips the '.lyr(x)' part of the name and appends '.kmz'
        outKML = os.path.join(os.path.splitext(layer), ".kmz")
        for scale in range(10000, 30001, 10000):
            # Run LayerToKML
            arcpy.conversion.LayerToKML(layer, outKML, scale, composite, 
                                        '', pixels, dpi, clamped)
else:
    arcpy.AddMessage('There are no layer files in {}'.format(arcpy.env.workspace))