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.
Utilisation
Vous pouvez contrôler l'apparence de KML de deux manières différentes.
- Si les propriétés de la couche, telles que le paramètre Fiche HTML, l'expression d'affichage et l'alias KMLSnippet, sont utilisées, elles le seront également à la création du fichier KML.
- 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 du champ seront utilisées à la création du fichier KML. Les couches créées à l'origine à l'aide de l'outil KML vers couche présentent des attributs qui définissent la méthode de création du fichier KML.
Pour en savoir plus sur la création d'un fichier KML dans ArcGIS for Desktop
-
Vous pouvez réduire la taille du document KMZ en sortie si les propriétés d'affichage de la couche dépendent de l'échelle et que vous sélectionnez une échelle en sortie appropriée pour la carte.
Tous les fichiers KML/KMZ sont créés dans le système de coordonnées WGS84. Vous devez être sûr que vos couches se projettent correctement si elles ne se trouvent pas déjà dans WGS84. Vous pouvez utiliser l'outil Projet pour projeter à nouveau vos données avant la conversion KML si votre projection nécessite une transformation.
Pour générer une seule image raster drapée sur la topographie, utilisez l'option Renvoyer une image composite unique.
Syntaxe
LayerToKML_conversion (layer, out_kmz_file, {layer_output_scale}, {is_composite}, {boundary_box_extent}, {image_size}, {dpi_of_client}, {ignore_zvalue})| Paramètre | Explication | Type 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) |
| 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) |
| 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.
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'
for scale in range(10000, 30001, 10000):
# Strips the '.lyr' and adds scale + _.kmz
outKML = layer[:4] + str(scale) + "_.kmz"
#Execute LayerToKML
arcpy.LayerToKML_conversion(layer, outKML, scale, composite,
'', pixels, dpi, clamped)
else:
arcpy.AddMessage('There are no layer files in '+arcpy.env.workspace+'.')
Environnements
Informations de licence
- ArcGIS for Desktop Basic: Oui
- ArcGIS for Desktop Standard: Oui
- ArcGIS for Desktop Advanced: Oui