Carte vers KML (3D Analyst)

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éritageHéritage :

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

Utilisation

Syntaxe

MapToKML_3d (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ètreExplicationType 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)
  • COMPOSITECommande 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_COMPOSITELes 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_RASTERConvertit 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_VECTORConserve 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

Informations de licence

ArcView : Obligatoire 3D Analyst
ArcEditor : Obligatoire 3D Analyst
ArcInfo : Obligatoire 3D Analyst

7/10/2012