De mapa a KML (Conversión)
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.
Esta herramienta estaba disponible previamente en la caja de herramientas de análisis 3D.
Uso
-
El archivo KMZ de salida no puede existir previamente.
-
Puede reducir el tamaño del documento KMZ de salida si el mapa posee renderizadores dependientes de la escala y selecciona una escala de mapa de salida apropiada.
-
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
Parámetro | Explicación | Tipo de datos |
in_map_document |
El documento de mapa que se va a convertir a KML. | Feature layer |
data_frame |
El marco de datos del documento de mapa que se va a convertir a KML. | Data frame |
out_kmz_file |
El archivo KML a escribir. Este archivo está comprimido y tiene una extensión .kmz. Lo puede leer cualquier cliente KML entre los que se encuentran ArcGIS Explorer, ArcGlobe y Google Earth. | KML file |
map_output_scale |
La escala a la que se va a exportar el documento de mapa. Se observa cualquier representación en pantalla dependiente de la escala, por lo que si las capas no son visibles en la escala de exportación, no se incluirán en el archivo KML creado. La simbología para el mapa se basa en esta escala, por lo que si el mapa tiene una escala de referencia definida, se debe tener en cuenta al establecer este parámetro. Sólo se pueden introducir caracteres numéricos. Por ejemplo, introduzca "20000" como escala, no 1:20.000 ó 20.000. Además, si va a exportar un mapa que contiene sólo capas que se van a mostrar como vectores 3D y no hay representación en pantalla que dependa de la escala definida para la capa, este parámetro no será obligatorio para el proceso de exportación y se podrá establecer cualquier valor numérico, como por ejemplo 1. | 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". | Extent |
image_size (Opcional) |
Tamaño de la imagen devuelta en píxeles (opcional): Define la resolución vertical y horizontal de los rásteres en el documento KML de salida. | Long |
dpi_of_client (Opcional) |
Define la resolución del dispositivo de los rásteres en el documento KML de salida. | Long |
Ejemplo de código
La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función De mapa a KML en el modo inmediato.
import arcpy from arcpy import env env.workspace = "C:/data" arcpy.MapToKML_3d("city.mxd", "Layers", "city.kmz", "1")
La siguiente secuencia de comandos de Python muestra cómo utilizar la función De mapa a KML 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)