Carte vers KML (Conversion)

Synthèse

Convertit une carte en fichier KML contenant des géométries et une symbologie. Le fichier en sortie est compressé à l’aide de la compression ZIP, porte l’extension .kmz et peut être lu par n’importe quel client KML, notamment ArcGIS Earth et Google Earth.

En savoir plus sur la prise en charge de KML dans ArcGIS

Utilisation

  • 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.

  • Vous pouvez réduire la taille du document KMZ en sortie si les propriétés d’affichage de la carte dépendent de l’échelle et que vous sélectionnez une échelle en sortie appropriée pour la carte.

  • Tous les fichiers .kml et .kmz sont créés dans le système de coordonnées WGS84. Assurez-vous que les couches se projettent correctement si elles ne figurent pas dans le système WGS84. Vous pouvez utiliser l’outil Projeter pour reprojeter les données avant la conversion KML si la projection nécessite une transformation.

  • Pour générer une seule image raster drapée sur la topographie, utilisez le paramètre Renvoyer une image composite unique.

  • Pour générer toutes les couches sous forme d’image raster séparée, utilisez le paramètre Conversion vecteur vers raster.

  • Les paramètres Échelle de la carte 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 Map Output Scale (Échelle de la carte en sortie) est 1, la taille de chaque sous-image sera de 1 000x1 000 pixels. Si la valeur du paramètre Map Output Scale (Échelle de la carte en sortie) est 10, la taille de chaque sous-image sera de 100x100 pixels.

  • Pour inclure une légende dans le KML en sortie, spécifiez une valeur pour le paramètre Mise en page source de légende. Un élément de légende doit être présent dans une mise en page sur la carte.

    Le KML comprendra la légende sous forme de superposition d’écran. Seuls les éléments de légende deviendront des superpositions d’écran dans le KML. Lors de l’affichage des données KML, chaque légende se transformera en sous-dossier, sous le dossier KML principal. Configurez la position de la superposition d’écran en activant la position dans l’arborescence du dossier KML.

Paramètres

ÉtiquetteExplicationType de données
Carte en entrée

Carte, scène ou fond de carte à convertir au format KML.

Map
Fichier en sortie

Fichier KML en sortie. Ce fichier est compressé et présente l’extension .kmz. Le fichier peut être lu par n’importe quel client KML, notamment ArcGIS Earth et Google Earth.

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 en sortie, elle n’est pas incluse dans le fichier 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.

Vous ne devez saisir que de caractères numériques, à savoir une échelle de 20000, par exemple et non 1: 20000. Dans les langues qui utilisent les virgules comme séparateur décimal, 20,000 est également autorisé.

Lors de l’exportation d’une couche qui sera affichée sous la forme de vecteurs 3D, si le paramètre Renvoyer une image composite unique est activé, vous pouvez définir ce paramètre sur n’importe quelle 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 fichier KML en sortie contiendra une image composite unique ou des couches séparées.

  • Activé : le fichier KML en sortie contiendra une seule image qui incorpore toutes les entités de la carte en une image raster unique. Le raster est drapé sur le terrain en tant qu'image GroundOverlay KML. 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ésactivé : le fichier KML en sortie contiendra des couches individuelles séparées. Il s’agit de l’option par défaut. Le paramètre Conversion vecteur vers raster détermine si les couches sont renvoyées sous forme de rasters ou sous forme d’une combinaison de vecteurs et de rasters.
Boolean
Conversion vecteur vers raster
(Facultatif)

Spécifie si chaque couche vectorielle de la carte sera convertie en une image raster distincte ou conservée en tant que couches vectorielles.

Ce paramètre est inactif si le paramètre Return single composite image (Renvoyer une image composite unique) est sélectionné.

  • Activé : les couches vectorielles 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 certains clients KML.
  • Désactivé : les couches vectorielles seront conservées en tant que vecteurs KML. Il s’agit de l’option par défaut.
Boolean
Etendue à exporter
(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 droite supérieure" (x-min, y-min, x-max, y-max).

  • Default (Par défaut) : l’étendue repose sur l’étendue maximale de toutes les entrées participantes. Il s’agit de l’option par défaut.
  • Current Display Extent (Étendue d’affichage actuelle) : l’étendue correspond au bloc de données ou à l’affichage visible. Cette option n’est pas disponible lorsque aucune carte n’est active.
  • As Specified Below (Comme spécifié ci-dessous) : l’étendue est basée sur les valeurs d’étendue minimale et maximale indiquées.
  • Browse (Parcourir) : l’étendue repose sur un jeu de données existant.
Extent
Taille de l'image renvoyée (pixels)
(Facultatif)

Taille des tuiles des couches raster si la valeur du paramètre Échelle de la carte en sortie est supérieure ou égale à 1. Ce paramètre n’a d’effet que sur les couches raster.

Long
PPP de l’image en sortie
(Facultatif)

Résolution de périphérique des 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 cette valeur. Utilisez ce paramètre avec le paramètre Size of returned image (pixels) (Taille de l’image renvoyée) (pixels) pour contrôler la résolution d’image en sortie du raster. La valeur par défaut est 96.

Long
Entités attachées au sol
(Facultatif)

Indique si les entités seront fixées au sol.

  • Activé : les valeurs z des entités en entrée seront ignorées et la sortie KML sera créée avec les entités attachées au sol. Les entités seront drapées sur le terrain. Utilisez cette option lorsque les entités ne présentent pas de valeurs z. Il s’agit de l’option par défaut.
  • Désactivé : les valeurs z des entités en entrée seront utilisées lors de la création de la sortie KML. Les entités seront dessinées dans les clients KML par rapport au niveau de la mer.
Boolean
Mise en page source de légende
(Facultatif)

Nom d’une mise en page contenant les éléments de légende qui seront inclus dans la sortie KML comme superpositions d’é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})
NomExplicationType de données
in_map

Carte, scène ou fond de carte à convertir au format KML.

Map
out_kmz_file

Fichier KML en sortie. Ce fichier est compressé et présente l’extension .kmz. Le fichier peut être lu par n’importe quel client KML, notamment ArcGIS Earth et Google Earth.

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 en sortie, elle n’est pas incluse dans le fichier 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.

Vous ne devez saisir que de caractères numériques, à savoir une échelle de 20000, par exemple et non 1: 20000. Dans les langues qui utilisent les virgules comme séparateur décimal, 20,000 est également autorisé.

Lors de l’exportation d’une couche qui sera affichée 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 n’importe quelle valeur tant que les entités ne présentent pas de rendu dépendant de l’échelle.

Double
is_composite
(Facultatif)

Indique si le fichier KML en sortie contiendra une image composite unique ou des couches séparées.

  • COMPOSITELe fichier KML en sortie contiendra une seule image qui incorpore toutes les entités de la carte en une image raster unique. Le raster est drapé sur le terrain en tant qu'image GroundOverlay KML. 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_COMPOSITELe fichier KML contient des couches individuelles séparées. 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 sous forme d’une combinaison de vecteurs et de rasters.
Boolean
is_vector_to_raster
(Facultatif)

Spécifie si chaque couche vectorielle de la carte sera convertie en une image raster distincte ou conservée en tant que couches vectorielles.

Ce paramètre est désactivé si le paramètre is_composite est défini sur COMPOSITE.

  • VECTOR_TO_IMAGELes couches vectorielles 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 certains clients KML.
  • VECTOR_TO_VECTORLes couches vectorielles seront conservées en tant que vecteurs KML. Il s’agit de l’option par défaut.
Boolean
extent_to_export
(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 droite supérieure" (x-min, y-min, x-max, y-max).

  • MAXOF : l’étendue maximale de toutes les entrées est utilisée.
  • MINOF : l’étendue minimale de 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 map_output_scale est supérieure ou égale à 1. Ce paramètre n’a d’effet que sur les couches raster.

Long
dpi_of_client
(Facultatif)

Résolution de périphérique des 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 cette valeur. Utilisez ce paramètre avec le paramètre image_size pour contrôler la résolution d'image en sortie. La valeur par défaut est 96.

Long
ignore_zvalue
(Facultatif)

Indique si les entités seront fixées au sol.

  • CLAMPED_TO_GROUNDLes valeurs z des entités en entrée seront ignorées et la sortie KML sera créée avec les entités attachées au sol. Les entités seront drapées sur le terrain. Utilisez cette option lorsque les entités ne présentent pas de valeurs z. Il s’agit de l’option par défaut.
  • ABSOLUTELes valeurs z des entités seront utilisées lors de la création de la sortie KML. Les entités seront dessinées dans les clients KML par rapport au niveau de la mer.
Boolean
layout
(Facultatif)

Nom d’une mise en page contenant les éléments de légende qui seront inclus dans la sortie KML comme superpositions d’écran.

String

Exemple de code

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

La fenêtre de script Python suivante illustre l’utilisation de la fonction MapToKML en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.MapToKML("cities.mapx", "cities.kmz")
Exemple 2 d'utilisation de la fonction MapToKML (script autonome)

Le script Python suivant 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

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes