De capa a KML (Conversión)

Resumen

Convierte una entidad o una capa ráster a formato KML (archivo .kmz o .kml). 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

  • 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 indicando un valor del parámetro Escala de salida de la capa adecuado.

  • La capa de entrada se proyectará a WGS84, ya que todos los archivos .kml y .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 la capa de entrada a WGS84 con una transformación válida antes de convertirla a KML.

  • 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 es 1, cada subimagen tendrá 1000 por 1000 píxeles. Si el valor del parámetro Escala de la capa de salida es 10, cada subimagen tendrá 100 por 100 píxeles.

Parámetros

EtiquetaExplicaciónTipo de datos
Capa de entrada

La entidad o capa ráster, o la capa de grupo, que se convertirá al formato KML.

Feature Layer; Raster Layer; Mosaic Layer; Group Layer; Layer File
Archivo de salida (KML o KMZ)

El archivo .kml o .kmz 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. El archivo .kmz de salida es el predeterminado.

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 la salida como un archivo .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
(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 de la capa 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 la salida de KML cuando se activa el parámetro Devolver imagen compuesta individual. 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.

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

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 o capa ráster, o la capa de grupo, que se convertirá al formato KML.

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

El archivo .kml o .kmz 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. El archivo .kmz de salida es el predeterminado.

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 KML de salida como un archivo .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 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 layer_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 la salida de KML cuando el parámetro is_composite está establecido en COMPOSITE. Use este parámetro 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 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

Muestra de código

Ejemplo 1 de LayerToKML (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra 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)

La siguiente secuencia de comandos Pythonindependiente muestra cómo utilizar la función LayerToKML en una secuencia de comandos 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))