Carte vers KML (Outils de conversion)

Résumé

Convertit une carte contenant des couches d’entités ou raster au format KML (fichier .kmz). 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

Le fichier .kmz en sortie 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 fournissant une valeur appropriée au paramètre Map Output Scale (Échelle de la carte en sortie).
Les couches de la carte en entrée sont projetées sur WGS84 car tous les fichiers .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 les couches de la carte sur WGS84 avec une transformation valide avant la conversion au format KML.
Les paramètres Map Output Scale (Échelle de la carte 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 Map Output Scale (Échelle de la carte en sortie) est de 1, la taille de chaque sous-image est de 1 000 x 1 000 pixels. Si la valeur du paramètre Map Output Scale (Échelle de la carte en sortie) est de 10, la taille de chaque sous-image est de 100 x 100 pixels.
Pour inclure une légende dans le fichier KML en sortie sous forme de superposition à l’écran, spécifiez une valeur pour le paramètre Legend Layout Source (Source de mise en page de la légende). La carte doit comporter un élément de légende dans une mise en page.

Seuls les éléments de légende deviendront des superpositions à l’écran dans le fichier KML. Chaque légende deviendra un sous-dossier sous le dossier KML principal lors de l’affichage des données KML.

Etiqueter	Explication	Type de données
Carte en entrée	La carte, la scène ou le fond de carte seront convertis au format KML.	Map
Fichier en sortie (KMZ)	Fichier KML en sortie, sous forme compressée et portant une extension `.kmz`.	File
Echelle de la carte en sortie (Facultatif)	Échelle à laquelle chaque couche de la carte sera exportée. Ce paramètre est important pour 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 de la sortie, elle n’est pas incluse dans le KML en sortie. N'importe quelle valeur, par exemple 1, peut être utilisée en l'absence de dépendance d'échelle. 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. Seuls les caractères numériques sont acceptés. Par exemple, saisissez une échelle de 20000 et non 1:20000. Pour les langues qui utilisent des virgules comme point décimal, 20,000 est également acceptable. Lors de l’exportation d’une couche à afficher sous la forme de vecteurs 3D, si le paramètre Return single composite image (Renvoyer une image composite unique) est sélectionné, vous pouvez définir ce paramètre sur toute valeur, tant que les entités ne présentent pas de rendu dépendant de l’échelle.	Double
Renvoyer une image composite unique (Facultatif)	Indique si le KML en sortie contiendra une image composite unique ou des couches distinctes. Activé—Le KML en sortie contiendra une image unique qui intègre toutes les entités de la carte dans une image raster unique. Le raster est drapé sur le MNT en tant que fichier KML `GroundOverlay`. Cette option réduit la taille du KML en sortie. Les entités et couches individuelles du fichier KML ne peuvent pas être sélectionnées. Décoché—Le KML en sortie contiendra des couches individuelles distinctes. Il s’agit de l’option par défaut. Le paramètre Convert features to images (Convertir des entités en images) détermine si les couches sont renvoyées sous forme de rasters ou de combinaison de vecteurs et de rasters.	Boolean
Convertir des entités en images (Facultatif)	Indique si chaque couche d’entités dans la carte sera convertie en une image raster distincte ou conservée sous forme d’entités. Ce paramètre n’est pas utilisé si le paramètre Return single composite image (Renvoyer une image composite unique) est sélectionné. Activé—Les couches d’entités seront converties en image raster distincte dans la sortie KML. Les couches raster normales sont également ajoutées à la sortie KML. Chaque raster KML en sortie est sélectionnable et sa transparence réglable dans certaines applications de visionneuse KML. Décoché—Les entités seront conservées dans le KML en sortie sous forme de géométries d’entités. Il s’agit de l’option par défaut.	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 Map Output Scale (Échelle de la carte en sortie) est supérieure ou égale à 1. Ce paramètre n’a aucun effet sur les couches de type autre que raster.	Long
PPP d’image en sortie (Facultatif)	Résolution de l’appareil pour les rasters du document KML en sortie. La définition de l'écran standard s'élève à 96 ppp. Si les données de la carte prennent en charge une haute résolution et si le fichier KML le nécessite, augmentez la valeur. 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. La valeur par défaut est 96.	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
Source de mise en page de la légende (Facultatif)	Nom de la mise en page contenant les éléments de légende qui seront inclus dans la sortie KML en tant que superpositions à l’écran.	String

arcpy.conversion.MapToKML(in_map, out_kmz_file, {map_output_scale}, {is_composite}, {is_vector_to_raster}, {extent_to_export}, {image_size}, {dpi_of_client}, {ignore_zvalue}, {layout})

Nom	Explication	Type de données
in_map	La carte, la scène ou le fond de carte seront convertis au format KML.	Map
out_kmz_file	Fichier KML en sortie, sous forme compressée et portant une extension `.kmz`.	File
map_output_scale (Facultatif)	Échelle à laquelle chaque couche de la carte sera exportée. Ce paramètre est important pour 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 de la sortie, elle n’est pas incluse dans le KML en sortie. N'importe quelle valeur, par exemple 1, peut être utilisée en l'absence de dépendance d'échelle. 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. Seuls les caractères numériques sont acceptés. Par exemple, saisissez une échelle de 20000 et non 1:20000. Pour les langues qui utilisent des virgules comme point décimal, 20,000 est également acceptable. Lors de l’exportation d’une couche à afficher sous la forme de vecteurs 3D, si le paramètre `is_composite` est défini sur `NO_COMPOSITE`, vous pouvez définir ce paramètre sur toute valeur, tant que les entités ne présentent pas de rendu dépendant de l’échelle.	Double
is_composite (Facultatif)	Indique si le KML en sortie contiendra une image composite unique ou des couches distinctes. `COMPOSITE`—Le KML en sortie contiendra une image unique qui intègre toutes les entités de la carte dans une image raster unique. Le raster est drapé sur le MNT en tant que fichier KML `GroundOverlay`. Cette option réduit la taille du KML en sortie. Les entités et couches individuelles du fichier KML ne peuvent pas être sélectionnées. `NO_COMPOSITE`—Le KML en sortie contiendra des couches individuelles distinctes. Il s’agit de l’option par défaut. Le paramètre `is_vector_to_raster` détermine si les couches sont renvoyées sous forme de rasters ou de combinaison de vecteurs et de rasters.	Boolean
is_vector_to_raster (Facultatif)	Indique si chaque couche d’entités dans la carte sera convertie en une image raster distincte ou conservée sous forme d’entités. Ce paramètre n’est pas utilisé si le paramètre `is_composite` est défini sur `COMPOSITE`. `VECTOR_TO_IMAGE`—Les couches d’entités seront converties en image raster distincte dans la sortie KML. Les couches raster normales sont également ajoutées à la sortie KML. Chaque raster KML en sortie est sélectionnable et sa transparence réglable dans certaines applications de visionneuse KML. `VECTOR_TO_VECTOR`—Les entités seront conservées dans le KML en sortie sous forme de géométries d’entités. Il s’agit de l’option par défaut.	Boolean
extent_to_export (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 `map_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 les rasters du document KML en sortie. La définition de l'écran standard s'élève à 96 ppp. Si les données de la carte prennent en charge une haute résolution et si le fichier KML le nécessite, augmentez la valeur. Utilisez ce paramètre avec le paramètre `image_size` pour contrôler la résolution de l’image en sortie. La valeur par défaut est 96.	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
layout (Facultatif)	Nom de la mise en page contenant les éléments de légende qui seront inclus dans la sortie KML en tant que superpositions à l’écran.	String

Exemple de code

Exemple 1 d’utilisation de la fonction MapToKML (fenêtre Python)

Le script de fenêtre Python ci-après illustre l’utilisation de la fonction MapToKML en mode immédiat.

import arcpy
arcpy.conversion.MapToKML("C:/Maps/Cities.mapx", "C:/OutputMaps/Cities.kmz")

Exemple 2 d’utilisation de la fonction MapToKML (script autonome)

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

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Use ListFiles to identify all map files in workspace
files = arcpy.ListFiles('*.mapx')
if len(files) > 0:
    for map_file in files:
        # Set Local Variables
        composite = 'NO_COMPOSITE'
        vector = 'VECTOR_TO_VECTOR'
        pixels = 2048
        dpi = 96
        clamped = 'ABSOLUTE'
        for scale in range(10000, 20000, 30000):
            # Strips the '.mapx' part of the name and appends '.kmz'
            outKML = map_file[:-5]+'.kmz'

            # Run MapToKML
            arcpy.conversion.MapToKML(map_file, outKML, scale, composite,
                                      vector, '', pixels, dpi, clamped)
else:
    arcpy.AddMessage('There are no map files (*.mapx) in {}.'.format(arcpy.env.workspace))

Environnements

Espace de travail courant, Etendue, Espace de travail temporaire, Conserver les pièces jointes, Transformations géographiques

Informations de licence