| Étiquette | Explication | Type de données |
Couche en entrée | Couche d’entités, couche raster ou fichier de couche (.lyrx) à convertir au format KML. | Feature Layer; Raster Layer; Mosaic Layer; Group Layer; Layer File |
Fichier en sortie (.kmz ou .kml) | Fichier .kmz ou .kml 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. 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 le fichier au format KML en sortie avec une extension .kmz, étant donné que les fichiers .kml ne prennent pas en charge la superposition des images ou des rasters.
| Boolean |
Etendue à exporter (Facultatif) | L'étendue géographique de la surface à exporter. Définissez la zone d’étendue (dans le système de coordonnées WGS84) ou choisissez une couche ou un jeu de données définissant une étendue.
| 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 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é. Ce paramètre est utilisé avec 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 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 |
Entités attachées au sol (Facultatif) | Indique si les valeurs z des entités en entrée doivent être remplacées.
| Boolean |
Synthèse
Convertit une couche d’entités ou une couche raster au format KML (fichier .kmz ou .kml) contenant une conversion des géométries et de la symbologie 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 sélectionnant une valeur appropriée pour le paramètre Échelle de la couche en sortie.
Tous les fichiers .kml et .kmz sont créés dans le système de coordonnées WGS84. Assurez-vous que la couche en entrée se projette correctement si elle n’utilise pas le système WGS84. Utilisez l’outil Projeter pour reprojeter les données avant la conversion KML si la projection de l’entrée nécessite une transformation.
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 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 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 Layer Output Scale (É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 Layer Output Scale (Échelle de la couche en sortie) est 10, la taille de chaque sous-image sera de 100x100 pixels.
Paramètres
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 fichier de couche (.lyrx) à convertir au format KML. | Feature Layer; Raster Layer; Mosaic Layer; Group Layer; Layer File |
out_kmz_file | Fichier .kmz ou .kml 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. 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 le fichier au format KML en sortie avec une extension .kmz, étant donné que les fichiers .kml ne prennent pas en charge la superposition des images ou des rasters.
| Boolean |
boundary_box_extent (Facultatif) | L'étendue géographique de la surface à exporter. Spécifiez les limites du rectangle d’emprise en tant que chaîne délimitée par des espaces de coordonnées géographiques WGS84, sous la forme gauche inférieure et droite supérieure (xmin, ymin, xmax, ymax).
| 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. Ce paramètre est utilisé 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 doivent être remplacées.
| Boolean |
Exemple de code
Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction LayerToKML en mode immédiat.
import arcpy
arcpy.conversion.LayerToKML("buildings", "c:/outputKMZs/bldg.kmz")Le script Python suivant 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
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?