De capa a KML (Conversión)

Resumen

Convierte una entidad o una capa ráster en un archivo KML que contiene una traslación de las geometrías y la simbología de Esri. Este archivo se comprime mediante compresión ZIP, tiene una extensión .kmz y lo puede leer cualquier cliente de KML, incluidos ArcGIS Earth, ArcGlobe y Google Earth.

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

Uso

• Puede controlar la apariencia de KML de dos formas:

  • De manera predeterminada, la visualización emergente estará integrada 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 mostrarán en la visualización emergente cuando se haga clic en una entidad KML. Estos valores pueden ser numéricos o atributos de texto, además de código con formato HTML almacenado en un campo de texto.
  • Cuando no se establecen las propiedades de la capa y la clase de entidad contiene ciertos atributos (campos), las propiedades de campo se utilizan en la creación de capas KML que originalmente se crearon con la herramienta De KML a capa e incluyen atributos que definen cómo se creará KML. Consulte Convertir en KLM y desde él 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 la capa posee propiedades de visualización dependientes de la escala y selecciona una escala de mapa de salida apropiada.

• Todos los archivos KML y KMZ se crean en el sistema de coordenadas WGS84. Es necesario asegurarse de que sus capas proyectarán correctamente si no están ya en WGS84. Puede usar la herramienta Proyectar para volver a proyectar sus datos antes de la conversión KML si su proyección requiere una transformación.

• Para conseguir una sola imagen ráster desplegada sobre topografía, utilice la opción Devolver imagen compuesta individual.

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

  • Los adjuntos pueden incrementar considerablemente el tamaño del archivo de salida.
  • Cuando el archivo de KML se utiliza en un cliente de KML, los adjuntos están disponibles mediante 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 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 tamaño de 7000 por 5000 píxeles y un valor de parámetro Tamaño de la imagen devuelta (píxeles) de 1000 píxeles, la imagen resultante constará de 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.

Sintaxis

LayerToKML(layer, out_kmz_file, {layer_output_scale}, {is_composite}, {boundary_box_extent}, {image_size}, {dpi_of_client}, {ignore_zvalue})

Parámetro	Explicación	Tipo de datos
layer	La entidad o la capa ráster o el archivo de capa (.lyrx) que se va a convertir a KML.	Layer
out_kmz_file	El archivo KML a escribir. Este archivo está comprimido y tiene una extensión .kmz. Lo puede leer cualquier cliente de KML, incluidos ArcGIS Earth, ArcGlobe y Google Earth.	File
layer_output_scale (Opcional)	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. COMPOSITE —El archivo de salida KML será una sola imagen compuesta que representa las entidades de ráster o vector de la capa de origen. El ráster se despliega sobre el terreno como GroundOverlay de KLM. Seleccione esta opción para reducir el tamaño del archivo KMZ de salida. Cuando se utilice COMPOSITE, no será posible seleccionar entidades y capas individuales en el archivo KML. NO_COMPOSITE —Si la capa posee entidades vectoriales, se conservarán como vectores KML. Si la capa es un ráster, puede elegir cualquiera de las opciones para este parámetro, sin ninguna diferencia visual.	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 caracteres delimitada por espacios de coordenadas geográficas WGS84 con la forma “abajo izquierda y arriba derecha” (xmin, ymin, xmax, ymax).	Extent
image_size (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
dpi_of_client (Opcional)	Resolución del dispositivo correspondiente a la salida de KML cuando se activa el parámetro Devolver imagen compuesta individual (is_composite = "COMPOSITE" en Python). Este parámetro se utiliza con el parámetro Tamaño de la imagen devuelta (píxeles) (image_size en Python) para controlar la resolución de la imagen de salida. Nota: Este parámetro no proporciona la capacidad de remuestrear rásteres de origen. Para todos los rásteres de entrada se tomará una instantánea que se incluirá en la salida de KML como una imagen .png simple.	Long
ignore_zvalue (Opcional)	ABSOLUTE —Utilice los valores Z de las entidades al crear KML. Las entidades se dibujarán dentro de los clientes KML en relación al nivel del mar. CLAMPED_TO_GROUND —Invalide los valores Z en sus entidades y cree KML con las entidades fijadas al suelo. Las entidades 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 en modo inmediato.

import arcpy
# "buildings" represents a layer in your Table of Contents
arcpy.LayerToKML_conversion("buildings", "c:/outputKMZs/bldg.kmz")

Ejemplo 2 de LayerToKML (secuencia de comandos independiente)

El siguiente script de Python muestra 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):
            # Execute LayerToKML            arcpy.LayerToKML_conversion(layer, outKML, scale, composite,                                         '', pixels, dpi, clamped)
else:
    arcpy.AddMessage('There are no layer files in {}'.format(arcpy.env.workspace))

Entornos

Espacio de trabajo actual, Extensión, Espacio de trabajo temporal, Mantener adjuntos

Información de licenciamiento

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