Couche vers KML (Outils de conversion)

Résumé

Convertit une couche d’entités ou une couche raster au format KML (fichier .kmz ou .kml). Le fichier KML en sortie contient une conversion des géométries d’entités, des cellules raster, de la symbologie de la couche et d’autres propriétés Esri.

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

Utilisation

La sortie par défaut de l’outil porte l’extension .kmz qui est une archive ou un fichier .zip contenant un fichier .kml et d’autres fichiers complémentaires. Un fichier .kmz peut être lu par de nombreuses applications et notemment ArcGIS Earth et Google Earth.
Vous pouvez contrôler l’apparence des fichiers KML des deux manières suivantes :
- Par défaut, l’affichage contextuel est composé de tous les champs visibles de la couche. Vous pouvez également définir les affichages contextuels à l’aide des fenêtres contextuelles personnalisées de la couche. Si les fenêtres contextuelles de la couche n’ont pas été personnalisées, les valeurs figurant dans le champ PopupInfo de la couche d’entités apparaissent dans la fenêtre contextuelle lorsque vous cliquez sur une entité KML. Il peut s’agir de valeurs numériques, d’attributs de texte ou de code HTML stocké dans un champ de texte.
- Si les propriétés de la couche ne sont pas définies et que la classe d’entités contient certains attributs (champs), les propriétés des champs sont utilisées pour créer les couches KML créées à l’origine à l’aide de l’outil KML To Layer (KML vers couche), avec les attributs qui définissent le mode de création des fichiers KML. Pour plus d’informations sur la création de fichiers KML à partir d’attributs, reportez-vous à la rubrique Conversion KML.
Si les propriétés d’affichage de l’entrée dépendent de l’échelle, réduisez la taille du fichier .kmz en sortie en spécifiant une valeur appropriée pour le paramètre Layer Output Scale (Échelle de la couche en sortie).
La couche en entrée est projetée sur WGS84 car tous les fichiers .kml et .kmz doivent utiliser ce système de coordonnées. Pour s’assurer que la projection localise les entités et cellules raster avec précision, vous pouvez spécifier l’environnement de transformation géographique. Vous pouvez également utiliser l’outil Project (Projeter) pour reprojeter la couche en entrée sur WGS84 avec une transformation valide avant la conversion au format KML.
Les entités en entrée avec des pièces jointes sont incluses dans le fichier .kmz en sortie. Gardez à l’esprit les conditions suivantes pour les pièces jointes dans les fichiers .kmz :
- Les pièces jointes peuvent considérablement augmenter la taille des fichiers en sortie.
- Si vous utilisez le fichier .kml dans un client KML, les pièces jointes sont disponibles à partir de la fenêtre contextuelle KML.
- Les pièces jointes peuvent être exclues en désactivant le paramètre d’environnement Maintain Attachments (Conserver les pièces jointes) avant d’exécuter l’outil.
- Tous les clients KML ne prennent pas en charge l'affichage des pièces jointes de manière uniforme. Certaines applications clientes KML prennent mieux en charge les pièces jointes, telles que les images et les fichiers PDF.
Les pièces jointes ne sont pas incluses si la sortie est un fichier .kml.
Les paramètres Layer Output Scale (Échelle de la couche en sortie) et Size of Returned Image (Pixels) (Taille de l’image renvoyée [pixels]) sont utilisés ensemble pour créer une sortie tuilée. Par exemple, pour une image d’une taille de 7 000 x 5 000 pixels, si la valeur du paramètre Size of Returned Image (Pixels) (Taille de l’image renvoyée [pixels]) est de 1 000 pixels, l’image en sortie est composée de 7 x 5 (35) sous-images. Si la valeur du paramètre Layer Output Scale (Échelle de la couche en sortie) est 1, la taille de chaque sous-image est de 1 000 x 1 000 pixels. Si la valeur du paramètre Layer Output Scale (Échelle de la couche en sortie) est 10, la taille de chaque sous-image est de 100 x 100 pixels.
Les descriptions de domaines sont transférées dans la sortie si l’environnement Transfer field domain descriptions (Transfert des descriptions de domaine de champ) est sélectionné.

Etiqueter	Explication	Type de données
Couche en entrée	Couche d’entités, couche raster ou groupe de couches à convertir au format KML.	Feature Layer; Raster Layer; Mosaic Layer; Group Layer; Layer File
Fichier en sortie (KMZ ou KML)	Fichier `.kml` ou `.kmz` en sortie. Le fichier en sortie peut utiliser l’extension `.kmz` pour générer une archive ou un fichier compressé ou encore l’extension `.kml` pour générer un fichier au format KML de base. Un fichier `.kmz` en sortie est la valeur par défaut. Les fichiers `.kmz` en sortie prennent en charge les couches raster, la symbologie et d’autres propriétés de couche, les pièces jointes et d’autres fonctionnalités avancées. Les fichiers `.kml` en sortie utilisent les symboles et propriétés KML de base.	File; Workspace; KML Layer
Echelle de la couche en sortie (Facultatif)	Échelle du fichier en sortie. Pour les couches raster, la valeur 0 peut être utilisée pour créer une image en sortie non tuilée. Si une valeur supérieure ou égale à 1 est utilisée, elle détermine la résolution en sortie du raster. Ce paramètre n’a aucun effet sur les couches non raster.	Double
Renvoyer une image composite unique (Facultatif)	Indique si la sortie sera une image composite unique. Ce paramètre s’applique uniquement si vous spécifiez le KML en sortie en tant que fichier `.kmz` car les fichiers `.kml` en sortie ne prennent pas en charge les images ou rasters de superposition au sol. Activé—La 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 que `GroundOverlay`. Utilisez cette option pour réduire la taille du fichier en sortie. Si cette option est utilisée, les entités et couches individuelles du fichier `.kml` ne peuvent pas être sélectionnées. Seuls les fichiers `.kmz` en sortie prennent en charge les images. Décoché—Si l’entrée comporte des entités vectorielles, elles seront conservées en tant que vecteurs KML.	Boolean
Etendue (Facultatif)	Étendue géographique de la couche à convertir. Seules les entités ou les cellules raster dans cette étendue seront incluses dans le KML en sortie. Current Display Extent (Étendue actuellement affichée) : l’étendue repose sur la carte ou scène active. Draw Extent (Dessiner l’étendue) : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Extent of a Layer (Étendue d’une couche) : l’étendue repose sur une couche de carte active. Choisissez une couche disponible ou utilisez l’option Étendue des données dans toutes les couches. Chaque couche de carte comporte les options suivantes : All Features (Toutes les entités) : étendue de toutes les entités. Selected Features (Entités sélectionnées) : étendue des entités sélectionnées. Visible Features (Entités visibles) : étendue des entités visibles. Browse (Parcourir) : l’étendue repose sur un jeu de données existant. Clipboard (Presse-papiers) : l’étendue peut être copiée depuis et vers le Presse-papiers. Copy Extent (Copier l’étendue) : copie l’étendue et le système de coordonnées dans le Presse-papiers. Paste Extent (Coller l’étendue) : colle l’étendue et les coordonnées depuis le Presse-papiers. Si le Presse-papiers n’inclut pas de système de coordonnées, l’étendue utilise celui de la carte. Reset Extent (Réinitialiser l’étendue) : la valeur par défaut de l’étendue est rétablie. Lorsque les coordonnées sont saisies manuellement, elles doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active. La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. Utilisez le signe moins pour les coordonnées sud et ouest.	Extent
Taille de l’image renvoyée (pixels) (Facultatif)	Taille des tuiles des couches raster si la valeur du paramètre Layer Output Scale (Échelle de la couche en sortie) est supérieure ou égale à 1. Ce paramètre n’a aucun effet sur les couches non raster.	Long
PPP d’image en sortie (Facultatif)	Résolution de l’appareil pour la sortie KML si le paramètre Return single composite image (Renvoyer une image composite unique) est sélectionné. Utilisez ce paramètre avec le paramètre Size of Returned Image (Pixels) (Échelle de l’image renvoyée [pixels]) pour contrôler la résolution de l’image en sortie. Ce paramètre ne rééchantillonne pas les rasters sources. Une capture d’écran est prise pour les rasters en entrée et incluse dans la sortie KML comme image `.png` simple.	Long
Attacher les entités au sol (Facultatif)	Détermine si les valeurs z des entités en entrée seront ignorées et si toutes les entités seront localisées, ou attachées, à l’élévation du sol. Activé—Les valeurs z des entités en entrée seront ignorées et toutes les entités seront localisées, ou attachées, à l’élévation du sol. Si les entités en entrée n’ont pas de valeur z, elles seront toujours attachées au sol. Il s’agit de l’option par défaut. Décoché—Les valeurs z des entités seront conservées dans le KML en sortie. Les entités seront dessinées dans les clients KML par rapport au niveau de la mer.	Boolean

arcpy.conversion.LayerToKML(layer, out_kmz_file, {layer_output_scale}, {is_composite}, {boundary_box_extent}, {image_size}, {dpi_of_client}, {ignore_zvalue})

Nom	Explication	Type de données
layer	Couche d’entités, couche raster ou groupe de couches à convertir au format KML.	Feature Layer; Raster Layer; Mosaic Layer; Group Layer; Layer File
out_kmz_file	Fichier `.kml` ou `.kmz` en sortie. Le fichier en sortie peut utiliser l’extension `.kmz` pour générer une archive ou un fichier compressé ou encore l’extension `.kml` pour générer un fichier au format KML de base. Un fichier `.kmz` en sortie est la valeur par défaut. Les fichiers `.kmz` en sortie prennent en charge les couches raster, la symbologie et d’autres propriétés de couche, les pièces jointes et d’autres fonctionnalités avancées. Les fichiers `.kml` en sortie utilisent les symboles et propriétés KML de base.	File; Workspace; KML Layer
layer_output_scale (Facultatif)	Échelle du fichier en sortie. Pour les couches raster, la valeur 0 peut être utilisée pour créer une image en sortie non tuilée. Si une valeur supérieure ou égale à 1 est utilisée, elle détermine la résolution en sortie du raster. Ce paramètre n’a aucun effet sur les couches non raster.	Double
is_composite (Facultatif)	Indique si la sortie sera une image composite unique. Ce paramètre s’applique uniquement si vous spécifiez le KML en sortie en tant que fichier `.kmz` car les fichiers `.kml` en sortie ne prennent pas en charge les images ou rasters de superposition au sol. `COMPOSITE`—La 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 que `GroundOverlay`. Utilisez cette option pour réduire la taille du fichier en sortie. Si cette option est utilisée, les entités et couches individuelles du fichier `.kml` ne peuvent pas être sélectionnées. Seuls les fichiers `.kmz` en sortie prennent en charge les images. `NO_COMPOSITE`—Si l’entrée comporte des entités vectorielles, elles seront conservées en tant que vecteurs KML.	Boolean
boundary_box_extent (Facultatif)	Étendue géographique de la couche à convertir. Seules les entités ou les cellules raster dans cette étendue seront incluses dans le KML en sortie. L’étendue peut être spécifiée à l’aide des options suivantes : `MAXOF` : l’étendue maximale de toutes les entrées est utilisée. `MINOF` : l’étendue minimale commune à toutes les entrées est utilisée. `DISPLAY` : l’étendue est égale à l’affichage visible. Nom de la couche : l’étendue de la couche spécifiée est utilisée. `Extent` object : l’étendue de l’objet spécifié est utilisée. Chaîne délimitée par des espaces de coordonnées géographiques : l’étendue de la chaîne spécifiée est utilisée. Les coordonnées sont exprimées dans l’ordre x-min, y-min, x-max, y-max.	Extent
image_size (Facultatif)	Taille des tuiles des couches raster si la valeur du paramètre `layer_output_scale` est supérieure ou égale à 1. Ce paramètre n’a aucun effet sur les couches non raster.	Long
dpi_of_client (Facultatif)	Résolution de l’appareil pour la sortie KML si le paramètre `is_composite` est défini sur `COMPOSITE`. Utilisez ce paramètre avec le paramètre `image_size` pour contrôler la résolution de l’image en sortie. Ce paramètre ne rééchantillonne pas les rasters sources. Une capture d’écran est prise pour les rasters en entrée et incluse dans la sortie KML comme image `.png` simple.	Long
ignore_zvalue (Facultatif)	Détermine si les valeurs z des entités en entrée seront ignorées et si toutes les entités seront localisées, ou attachées, à l’élévation du sol. `CLAMPED_TO_GROUND`—Les valeurs z des entités en entrée seront ignorées et toutes les entités seront localisées, ou attachées, à l’élévation du sol. Si les entités en entrée n’ont pas de valeur z, elles seront toujours attachées au sol. Il s’agit de l’option par défaut. `ABSOLUTE`—Les valeurs z des entités seront conservées dans le KML en sortie. Les entités seront dessinées dans les clients KML par rapport au niveau de la mer.	Boolean

Exemple de code

Exemple 1 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.conversion.LayerToKML("buildings", "c:/outputKMZs/bldg.kmz")

Exemple 2 d’utilisation de l’outil LayerToKML (script autonome)

Le script Python ci-après illustre l’utilisation de la fonction LayerToKML dans un script autonome.

# 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.
import arcpy

arcpy.env.workspace = "C:/data"

# Set Local Variables
composite = 'NO_COMPOSITE'
pixels = 2048
dpi = 96
clamped = 'CLAMPED_TO_GROUND'

# Use the ListFiles method to identify all lyr and lyrx files in workspace
layers = arcpy.ListFiles("*.lyr*")

if len(layers) > 0:
    for layer in layers:
        # Strips the '.lyr(x)' part of the name and appends '.kmz'
        outKML = os.path.join(os.path.splitext(layer), ".kmz")
        for scale in range(10000, 30001, 10000):
            # Run LayerToKML
            arcpy.conversion.LayerToKML(layer, outKML, scale, composite,
                                        '', pixels, dpi, clamped)
else:
    arcpy.AddMessage('There are no layer files in {}'.format(arcpy.env.workspace))

Environnements

Espace de travail courant, Etendue, Espace de travail temporaire, Conserver les pièces jointes, Transformations géographiques, Transférer les descriptions des domaines de champs

Informations de licence