| Étiquette | 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 une extension .kmz pour produire une archive ou un fichier compressé ou encore une 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 |
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 en tant que fichier .kmz, étant donné que les fichiers .kml ne prennent pas en charge la superposition des images ou des rasters.
| 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.
| 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.
| Boolean |
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.
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.
Paramètres
: l’étendue repose sur la carte ou la scène active. Cette option est uniquement disponible lorsqu’une carte est active.
: l’étendue repose sur une couche de carte active. Utilisez la liste déroulante pour choisir une couche disponible ou utilisez l’option 
: l’étendue repose sur un jeu de données existant.
: la valeur par défaut de l’étendue est rétablie.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 une extension .kmz pour produire une archive ou un fichier compressé ou encore une 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 |
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.
| 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 :
| 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.
| Boolean |
Exemple de code
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")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))Environnements
Vous avez un commentaire à formuler concernant cette rubrique ?