Couche vers KML (Conversion)

Synthèse

Convertit une couche d’entités ou une couche raster au format KML (fichier .kmz ou .kml). Le fichier KML en sortie contiendra 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 bon nombre d’applications et notamment par ArcGIS Earth et Google Earth.

  • Vous pouvez contrôler l’apparence de KML de deux manières différentes :

    • Par défaut, l’affichage contextuel est composé de tous les champs visibles à partir de la couche. Vous pouvez également définir les affichages contextuels en utilisant les 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 l’affichage contextuel 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 seront utilisées à la création du fichier KML. Les couches créées initialement à l’aide de l’outil KML To Layer (KML vers couche) contiennent des attributs qui définissent la façon dont le fichier KML est créé. Pour plus d’informations sur la création de données KML à partir d’attributs, reportez-vous à la rubrique Conversion KML.

  • Si l’entrée a des propriétés d’affichage de la couche qui dépendent de l’échelle, réduisez la taille du fichier .kmz en sortie en fournissant une valeur appropriée au paramètre Échelle de la couche en sortie.

  • La couche en entrée sera projetée au format WGS84, tous les fichiers .kml et .kmz devant utiliser ce système de coordonnées. Pour s’assurer que la projection localise précisément les entités et les cellules raster, il sera peut-être nécessaire de spécifier l’environnement de transformations géographiques. Vous pouvez également utiliser l’outil Projeter pour reprojeter la couche en entrée au format WGS84 selon une transformation valide avant de la convertir en 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 des fichiers .kmz :

    • Les pièces jointes peuvent considérablement augmenter la taille des fichiers en sortie.
    • Lorsque 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 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 Échelle de la couche en sortie et 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 000x5 000 pixels, lorsque la valeur du paramètre Taille de l’image renvoyée (pixels) est 1 000 pixels, l’image en sortie est composée de 7x5 ou 35 sous-images. Si la valeur du paramètre Échelle de la couche en sortie est 1, la taille de chaque sous-image sera de 1 000x1 000 pixels. Si la valeur du paramètre Échelle de la couche en sortie est 10, la taille de chaque sous-image sera de 100x100 pixels.

  • Les descriptions de domaines sont transférées dans la sortie lorsque l’environnement Transfert des descriptions de domaine de champ est sélectionné.

Paramètres

ÉtiquetteExplicationType 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 produire une archive ou un fichier compressé ou encore l’extension .kml pour produire un fichier au format KML de base. Un fichier .kmz en sortie est défini 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, ainsi que d’autres fonctionnalités avancées. Les fichiers .kml en sortie utilisent les propriétés et les symboles 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 seulement si vous spécifiez la sortie KML en tant que fichier .kmz, étant donné que les fichiers .kml ne prennent pas en charge la superposition des images ou des rasters.

  • Activé - La sortie est 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. Lorsque 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ésactivé - Si la couche en entrée comporte des entités vectorielles, elles sont conservées en tant que vecteurs KML.
Boolean
Étendue
(Facultatif)

Étendue géographique de la couche à convertir. Seules les entités et les cellules raster de cette étendue seront incluses dans le fichier KML en sortie.

  • Current Display Extent (Étendue actuellement affichée) Vue cartographique : l’étendue repose sur la carte ou la scène active. Cette option est uniquement disponible lorsqu’une carte est active.
  • Dessiner l’étendue Draw Extent : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Cette option crée une classe d’entités dans la géodatabase du projet et ajoute une couche à la carte. La classe d’entités possède le même système de coordonnées que la carte.
    Remarque :

    Cette option n’est pas disponible dans la boîte de dialogue Environnements. Elle est disponible uniquement dans un paramètre de l’outil correspondant à un type de données d’étendue ou dans l’onglet Environnements de la boîte de dialogue de l’outil.

    Remarque :

    Lorsque l’option de mise à jour Activer et désactiver la mise à jour de l’onglet Mettre à jour est activée, vous devez activer la mise à jour dans l’onglet du ruban Mettre à jour pour dessiner l’étendue.

  • Extent of a Layer (Étendue d’une couche) Couche : l’étendue repose sur une couche de carte active. Utilisez la liste déroulante pour choisir une couche disponible ou utilisez l’option Extent of data in all layers (Étendue des données dans toutes les couches) pour obtenir l’étendue combinée de toutes les couches de carte actives, y compris le fond de carte. Cette option est uniquement disponible lorsqu’une carte avec des couches est active.

    Chaque couche de carte comporte les options suivantes :

    • Toutes les entités Sélectionner tout : étendue de toutes les entités dans la couche.
    • Entités sélectionnéesArea from Selected Features : étendue de toutes les entités sélectionnées dans la couche.
    • Entités visibles Extent Indicator : étendue des entités visibles dans la couche.
      Remarque :

      Les étendues des options Entités sélectionnées Area from Selected Features et Entités visibles Extent Indicator sont disponibles uniquement pour les couches d’entités.

  • Browse (Parcourir) Parcourir : l’étendue repose sur un jeu de données existant.
  • Presse-papiers Coller : l’étendue peut être copiée vers et collée depuis le Presse-papiers.
    • Copier l’étendue Copier : copie les coordonnées et le système de coordonnées de l’étendue dans le Presse-papiers.
    • Coller l’étendue Coller : colle les coordonnées et, éventuellement, le système de coordonnées de l’étendue depuis le Presse-papiers. Si les valeurs du Presse-papiers n’incluent pas de système de coordonnées, l’étendue utilise celui de la carte.
    Remarque :

    Les coordonnées de l’étendue sont copiées vers et collées depuis le Presse-Papiers avec la même mise en forme et le même ordre que ceux de l’objet ArcPy Extent : X min, Y min, X max, Y max et la référence spatiale.

  • Reset Extent (Réinitialiser l’étendue) Réinitialiser : la valeur par défaut de l’étendue est rétablie.
  • Manually entered coordinates (Coordonnées saisies manuellement) : les coordonnées doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active.
    Attention :

    La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. L’utilisation d’une direction cardinale (N, S, E, O) n’est pas prise en charge. 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 É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 de l’image en sortie
(Facultatif)

Résolution de l’appareil pour la sortie KML lorsque le paramètre Return single composite image (Renvoyer une image composite unique) est sélectionné. Utilisez ce paramètre avec le paramètre Taille de l’image renvoyée (pixels) pour contrôler la résolution d’image en sortie du raster.

Ce paramètre ne rééchantillonne pas les rasters source. Une capture d’écran est prise pour les rasters en entrée et est incluse dans la sortie KML comme une simple image .png.

Long
Attacher les entités au sol
(Facultatif)

Indique si les valeurs z des entités en entrée sont ignorées et si toutes les entités sont localisées, ou attachées, au niveau du sol.

  • Activé : les valeurs z des entités en entrée sont ignorées et toutes les entités sont localisées, ou attachées, au niveau du sol. Si les entités en entrée ne possèdent pas de valeurs z, elles seront toujours attachées au sol. Il s’agit de l’option par défaut.
  • Désactivé : les valeurs z des entités sont gérées dans le fichier 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})
NomExplicationType 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 produire une archive ou un fichier compressé ou encore l’extension .kml pour produire un fichier au format KML de base. Un fichier .kmz en sortie est défini 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, ainsi que d’autres fonctionnalités avancées. Les fichiers .kml en sortie utilisent les propriétés et les symboles 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 seulement si vous spécifiez la sortie KML en tant que fichier .kmz, étant donné que les fichiers .kml ne prennent pas en charge la superposition des images ou des rasters.

  • COMPOSITELa sortie est 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. Lorsque 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_COMPOSITESi l’entrée comporte des entités vectorielles, elles sont conservées en tant que vecteurs KML.
Boolean
boundary_box_extent
(Facultatif)

Étendue géographique de la couche à convertir. Seules les entités et les cellules raster de cette étendue seront incluses dans le fichier KML en sortie. Les options suivantes permettent de spécifier l’étendue :

  • 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.
  • Objet Extent : 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 lorsque 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 d'image en sortie.

Ce paramètre ne rééchantillonne pas les rasters source. Une capture d’écran est prise pour les rasters en entrée et est incluse dans la sortie KML comme une simple image .png.

Long
ignore_zvalue
(Facultatif)

Indique si les valeurs z des entités en entrée sont ignorées et si toutes les entités sont localisées, ou attachées, au niveau du sol.

  • ABSOLUTELes valeurs z des entités sont gérées dans le fichier KML en sortie. Les entités seront dessinées dans les clients KML par rapport au niveau de la mer.
  • CLAMPED_TO_GROUNDLes valeurs z des entités en entrée sont ignorées et toutes les entités sont localisées, ou attachées, au niveau du sol. Si les entités en entrée ne possèdent pas de valeurs z, elles seront toujours attachées au sol. Il s’agit de l’option par défaut.
Boolean

Exemple de code

Exemple 1 d’utilisation de l’outil LayerToKML (fenêtre Python)

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction LayerToKML en mode immédiat.

import arcpy
arcpy.conversion.LayerToKML("buildings", "c:/outputKMZs/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.

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

Rubriques connexes