Desktop Help 10.0 - Carte vers KML (Conversion)

Récapitulatif

Cet outil convertit une carte en fichier KML contenant une traduction des géométries et de la symbologie ESRI. Ce fichier zippé porte l'extension .kmz et peut être lu par n'importe quel client KML, dont ArcGIS Explorer, ArcGlobe et Google Earth.

Héritage :

Cet outil était auparavant disponible dans la boîte à outils 3D Analyst.

Utilisation

Le fichier KMZ en sortie ne peut pas déjà exister.
Vous pouvez réduire la taille du document KMZ en sortie si les représentations de la carte dépendent de l'échelle et si vous sélectionnez une échelle en sortie appropriée pour la carte.
Pour générer une seule image raster drapée sur la topographie, utilisez l'option Renvoyer une image composite unique.
Pour générer toutes les couches sous forme d'image raster séparée, utilisez l'option Conversion vecteur/raster.

Syntaxe

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})

Paramètre	Explication	Type de données
in_map_document	La carte à convertir au format KML.	Feature layer
data_frame	Le bloc de données de la carte à convertir au format KML..	Data frame
out_kmz_file	Le fichier KML à écrire. Ce fichier est compressé et doté d'une extension .kmz. Il peut être lu par n'importe quel client KML, dont ArcGIS Explorer, ArcGlobe et Google Earth.	KML file
map_output_scale	L'échelle à laquelle exporter la carte. Tout rendu dépendant de l'échelle sera observé. Par conséquent, les couches qui ne sont pas visibles à l'échelle d'exportation ne seront pas incluses dans le fichier KML créé. La symbologie de la carte sera induite par cette échelle. Ainsi, si une échelle de référence est définie pour la carte, elle doit être prise en compte lors de la définition de ce paramètre. Seuls les caractères numériques sont acceptés. Par exemple, entrez l'échelle sous la forme "20000", et non pas "1:20000" ou "20 000". En outre, si vous exportez une carte qui contient uniquement des couches qui seront affichées sous la forme de vecteurs 3D et qu'aucun rendu dépendant de l'échelle n'est défini, ce paramètre n'est pas nécessaire pour le processus d'exportation et peut être défini avec n'importe quelle valeur numérique, telle que "1".	Double
is_composite (Facultatif)	COMPOSITE —Commande au fichier KML en sortie d'intégrer toutes les entités de cette carte dans une image raster unique. Le raster est drapé sur le terrain en tant qu'image GroundOverlay KML. Sélectionnez cette option pour réduire la taille du fichier KMZ en sortie. Lorsque vous cochez cette case, les entités et couches individuelles du fichier KML ne peuvent pas être sélectionnées. En outre, le prochain paramètre "is_vector_to_raster" est ignoré. NO_COMPOSITE —Les couches sont renvoyées séparément dans le fichier KML. Le prochain paramètre "is_vector_to_raster" détermine si les couches sont toutes renvoyées sous forme de couches raster ou sous forme d'un mélange de couches vectorielles et raster.	Boolean
is_vector_to_raster (Facultatif)	VECTOR_TO_RASTER —Convertit chaque couche vectorielle de la carte en image raster distincte dans la sortie KML. Les couches raster normales sont également ajoutées à la sortie KML. Chaque raster KML en sortie est sélectionnable et sa transparence réglable dans certains clients KML. VECTOR_TO_VECTOR —Conserve les couches vectorielles dans la carte en tant que vecteurs KML.	Boolean
extent_to_export (Facultatif)	L'étendue géographique de la surface à exporter. Les limites du rectangle d'emprise doivent être spécifiées sous la forme d'une chaîne délimitée par des espaces de coordonnées géographiques WGS84 sous la forme "gauche inférieure droite supérieure".	Extent
image_size (Facultatif)	Taille de l'image renvoyée (pixels) (facultatif) : Définit la résolution verticale et horizontale de tous les rasters présents dans le document KML en sortie.	Long
dpi_of_client (Facultatif)	Définit la résolution de périphérique des rasters du document KML en sortie.	Long

Exemple de code

Exemple 1 d'utilisation de l'outil Carte vers KML (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction Carte vers KML en mode immédiat.

import arcpy
from arcpy import env

env.workspace = "C:/data"
arcpy.MapToKML_3d("city.mxd", "Layers", "city.kmz", "1")

Exemple 2 d'utilisation de l'outil Carte vers KML (script autonome)

Le script Python ci-dessous illustre l'utilisation de la fonction Carte vers KML dans un script autonome.

'''*********************************************************************
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)

Environnements

Espace de travail courant, Etendue, Espace de travail temporaire

Rubriques connexes

Vue d'ensemble du jeu d'outils Vers KML

Informations de licence

ArcView : Oui

ArcEditor : Oui

ArcInfo : Oui

7/10/2012