| Etiqueta | Explicación | Tipo 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 la extensión .kmz para generar un archivo o archivo comprimido, o bien la 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; Workspace; KML Layer |
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 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.
| Boolean |
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.
| 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.
| Boolean |
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 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.
Las descripciones de dominio se transferirán a la salida cuando se active el entorno Transferir descripciones de dominio de campo.
Parámetros
: la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo.
: 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 todas las entidades en una capa.
: extensión de las entidades seleccionadas en la capa.
: la extensión se basará en un dataset existente.
: la extensión puede copiarse y pegarse desde el portapapeles.
: copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles.
: la extensión se restablecerá al valor predeterminado.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 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 la extensión .kmz para generar un archivo o archivo comprimido, o bien la 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; Workspace; KML Layer |
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.
| 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:
| 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.
| Boolean |
Muestra de código
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")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))