Couche vers KML (Conversion)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Cet outil convertit une couche d'entités ou raster en fichier KML contenant une traduction des géométries et de la symbologie Esri. Ce fichier compressé porte l'extension .kmz et peut être lu par n'importe quel client KML, dont ArcGIS Explorer, ArcGlobe et Google Earth.

En savoir plus sur la prise en charge de KML dans ArcGIS

Utilisation

Syntaxe

LayerToKML_conversion (layer, out_kmz_file, {layer_output_scale}, {is_composite}, {boundary_box_extent}, {image_size}, {dpi_of_client}, {ignore_zvalue})
ParamètreExplicationType de données
layer

Entité, couche raster ou fichier de couches (.lyr) à convertir au format KML.

Layer
out_kmz_file

Le fichier KML à écrire. Ce fichier est compressé et présente une extension .kmz. Il peut être lu par n'importe quel client KML, dont ArcGIS Explorer, ArcGlobe et Google Earth.

File
layer_output_scale
(Facultatif)

L'échelle à laquelle exporter la couche. Ce paramètre est utilisé avec n'importe quelle dépendance d'échelle, comme la visibilité des couches ou le rendu dépendant de l'échelle. Si la couche n'est pas visible à l'échelle d'exportation, elle n'est pas incluse dans le fichier KML créé. N'importe quelle valeur, par exemple 0, peut être utilisée en l'absence de dépendance d'échelle.

Lors de l'exportation d'une couche qui sera affichée sous la forme de vecteurs 3D, si le paramètre is_composite a la valeur NO_COMPOSITE, vous pouvez définir ce paramètre sur n'importe quelle valeur, tant que vos entités ne présentent pas de rendu dépendant de l'échelle.

Vous ne devez entrer que des caractères numériques, à savoir une échelle de 20000, par exemple et non 1:20000 ou 20 000.

Double
is_composite
(Facultatif)
  • COMPOSITELe fichier KML en sortie sera une image composite unique représentant les entités raster ou vectorielles dans la couche source. 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.
  • NO_COMPOSITESi votre couche comporte des entités vectorielles, elles sont conservées en tant que vecteurs KML. (Si votre couche est un raster, vous pouvez sélectionner l'une ou l'autre option pour ce paramètre sans différence visuelle.)
Boolean
boundary_box_extent
(Facultatif)

L'étendue géographique de la surface à exporter. Les limites du rectangle d'emprise doivent être spécifiées en tant que chaîne délimitée par des espaces de coordonnées géographiques WGS84, sous la forme "gauche inférieure droite supérieure" (xmin, ymin, xmax, ymax).

Extent
image_size
(Facultatif)

Définit la résolution verticale et horizontale des rasters du document KML en sortie. Utilisez ce paramètre avec le paramètre PPP pour contrôler la résolution d'image en sortie du raster.

Long
dpi_of_client
(Facultatif)

Définit la résolution de périphérique des rasters du document KML en sortie. Utilisez ce paramètre avec le paramètre Taille d'image pour contrôler la résolution d'image en sortie du raster.

Long
ignore_zvalue
(Facultatif)
  • ABSOLUTEUtilisez les valeurs Z des entités lors de la création de fichiers KML. Les entités seront dessinées dans les clients KML par rapport au niveau de la mer.
  • CLAMPED_TO_GROUNDIgnorez les valeurs Z de vos entités et créez un fichier KML avec les entités attachées au sol. Les entités seront drapées sur le terrain. Ce paramètre est utilisé pour les entités qui ne présentent pas de valeurs Z. Il s'agit de l'option par défaut.
Boolean

Exemple de code

1er exemple d'utilisation de l'outil LayerToKML (fenêtre Python)

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

import arcpy

arcpy.env.workspace = "C:/data"
arcpy.LayerToKML_conversion("bldg.lyr", "bldg.kmz")
2e exemple d'utilisation de l'outil LayerToKML (script autonome)

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

# Name: LayerToKML Example
# Description: The following stand-alone script demonstrates how to find 
#              all layer files 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 LayerToKML tool.
# Author: ESRI

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("*.lyr")) > 0:
    for layer in arcpy.ListFiles("*.lyr"):
        # Set Local Variables
        composite = 'NO_COMPOSITE'
        pixels = 2048
        dpi = 96
        clamped = 'CLAMPED_TO_GROUND'
        # Strips the '.lyr' part of the name and appends '.kmz'
        outKML = file[:4] + ".kmz"
        for scale in range(10000, 30001, 10000):
            #Execute LayerToKML
            arcpy.LayerToKML_conversion(layer, outKML, scale, composite, 
                                        '', pixels, dpi, clamped)
else:
    arcpy.AddMessage('There are no layer files in '+env.workspace+'.')

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Oui
ArcGIS for Desktop Standard: Oui
ArcGIS for Desktop Advanced: Oui
5/10/2014