Disponible con una licencia de 3D Analyst.
Resumen
Esta herramienta convierte un documento de mapa en un archivo KML que contiene una traducción de las geometrías y la simbología de Esri. Este archivo está comprimido mediante compresión ZIP, tiene una extensión .kmz y lo puede leer cualquier cliente KML entre los que se encuentran ArcGIS Explorer, 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.
- Si se utilizan propiedades de capa, como el parámetro HTML emergente, la expresión de visualización y el alias de KMLSnippet, se usarán en la creación del KML.
- Cuando no se establecen las propiedades de la capa y la clase de entidad contiene ciertos atributos (campos), las propiedades de campo se utilizarán al crear el KML. Las capas que se crearon originalmente con la herramienta KML a capa tienen atributos que definen cómo se creará KML.
Puede reducir el tamaño del documento KMZ de salida si el mapa posee propiedades de visualización de capa dependientes de la escala y selecciona una escala de mapa de salida apropiada.
Todos los archivos KML/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.
Para conseguir que cada capa sea una imagen ráster por separado, utilice la opción Convertir vector a ráster.
Sintaxis
MapToKML_conversion (in_map_document, data_frame, out_kmz_file, {map_output_scale}, {is_composite}, {is_vector_to_raster}, {extent_to_export}, {image_size}, {dpi_of_client}, {ignore_zvalue})| Parámetro | Explicación | Tipo de datos |
in_map_document | El documento de mapa que se va a convertir a KML. | ArcMap Document |
data_frame | El marco de datos del documento de mapa que se va a convertir a KML. | String |
out_kmz_file | El archivo KML a escribir. Este archivo está comprimido y tendrá una extensión .kmz. Lo puede leer cualquier cliente KML entre los que se encuentran ArcGIS Explorer, ArcGlobe y Google Earth. | File |
map_output_scale (Opcional) | La escala a la que se va a exportar cada capa del mapa. Este parámetro es importante con cualquier dependencia de la escala, como la visibilidad de la capa o la representación en pantalla dependiente de la escala. Si la capa no está visible en la escala de exportación, no se incluirá en el archivo KML que se creó. Se puede usar cualquier valor, como 1, si no hay dependencias de escala. Si desea exportar una capa que se va a mostrar como vectores 3D y el parámetro is_composite se establece en NO_COMPOSITE, puede establecer este parámetro para cualquier valor, siempre que las entidades no tengan ninguna representación en pantalla dependiente de la escala. Solo se deben introducir caracteres numéricos; por ejemplo, introduzca 20000 como escala, no 1:20000 o 20.000. | Double |
is_composite (Opcional) |
| Boolean |
is_vector_to_raster (Opcional) |
| Boolean |
extent_to_export (Opcional) | La extensión geográfica del área a exportar. Los límites del rectángulo de extensión se deben especificar como una cadena de caracteres delimitada por espacios de coordenadas geográficas WGS84 con la forma “abajo izquierda arriba derecha” (xmin, ymin, xmax, ymax). | Extent |
image_size (Opcional) | Tamaño de la imagen devuelta en píxeles. Define la resolución vertical y horizontal de los rásteres en el documento KML de salida. Use este parámetro con el parámetro DPI para controlar la resolución de la imagen de salida. | Long |
dpi_of_client (Opcional) | Define la resolución del dispositivo de los rásteres en el documento KML de salida. La resolución normal de la pantalla es 96dpi. Si los datos dentro de su mapa admiten una alta resolución y su KML lo requiere, considere aumentar el valor. Use este parámetro con el parámetro Tamaño de imagen para controlar la resolución de la imagen de salida. | Long |
ignore_zvalue (Opcional) |
| Boolean |
Ejemplo de código
Ejemplo 1 de MapToKML (ventana de Python)
La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función MapToKML en modo inmediato.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.MapToKML_3d("city.mxd", "Layers", "city.kmz", "1")
Ejemplo 2 de MapToKML (secuencia de comandos independiente)
La siguiente secuencia de comandos de Python demuestra cómo utilizar la función MapToKML en una secuencia de comandos independiente.
'''*********************************************************************
Name: MapToKML Example
Description: This script demonstrates how to find
all map documents 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 MapToKML tool.
'''
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Use the ListFiles method to identify all layer files in workspace
if len(arcpy.ListFiles('*.mxd')) > 0:
for mxd in arcpy.ListFiles('*.mxd'):
# Set Local Variables
dataFrame = 'Layers'
composite = 'NO_COMPOSITE'
vector = 'VECTOR_TO_VECTOR'
pixels = 2048
dpi = 96
clamped = 'ABSOLUTE'
for scale in range(10000, 30001, 10000):
# Strips the '.mxd' part of the name and appends '.kmz'
outKML = mxd[:-4]+'.kmz'
#Execute MapToKML
arcpy.MapToKML_conversion(mxd, dataFrame, outKML, scale,
composite, vector, '', pixels, dpi, clamped)
else:
arcpy.AddMessage('There are no map documents (*.mxd) in '+env.workspace)
Entornos
Información sobre licencias
- ArcGIS for Desktop Basic: Sí
- ArcGIS for Desktop Standard: Sí
- ArcGIS for Desktop Advanced: Sí