Mapa a KML (Conversión)

Nivel de licencia:BasicStandardAdvanced

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

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ámetroExplicaciónTipo 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)
  • COMPOSITEDirige el archivo KML de salida para que contenga sólo una única imagen que combine todas las entidades del mapa en una sola imagen de ráster. El ráster se despliega sobre el terreno como un GroundOverlay KML. Seleccione esta opción para reducir el tamaño del archivo KMZ de salida. Cuando se marque esta casilla, no será posible seleccionar entidades y capas individuales en el archivo KML. Además, se ignora el siguiente parámetro is_vector_to_raster.
  • NO_COMPOSITELas capas serán devueltas por separado en el archivo KML. El siguiente parámetro is_vector_to_raster determina si las capas se devuelven como rásteres o como una mezcla de vectores y rásteres.
Boolean
is_vector_to_raster
(Opcional)
  • VECTOR_TO_RASTERConvierte cada capa de vector del mapa en una imagen ráster independiente en la salida KML. También se agregan capas ráster normales a la salida KML. Cada capa ráster KLM de salida es seleccionable y su transparencia se puede ajustar en determinados clientes KML.
  • VECTOR_TO_VECTORConserva las capas de vector del mapa como vectores KML.
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)
  • ABSOLUTEUtilice 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_GROUNDInvalide 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

Ejemplo de código

Ejemplo 1 de MapToKML (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función MapToKML en el 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 muestra 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

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: Sí
ArcGIS for Desktop Standard: Sí
ArcGIS for Desktop Advanced: Sí
9/11/2013