| Etiqueta | Explicación | Tipo 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.
| 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.
| 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.
| Boolean |
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
arcpy.conversion.LayerToKML(layer, out_kmz_file, {layer_output_scale}, {is_composite}, {boundary_box_extent}, {image_size}, {dpi_of_client}, {ignore_zvalue})| Nombre | Explicación | Tipo 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.
| 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.).
| 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.
| Boolean |
Muestra de código
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")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))