Carte vers KML (Conversion)

Synthèse

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

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 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 carte en sortie.

  • Les couches de la carte en entrée seront projetées au format WGS84, tous les fichiers .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 les couches de la carte au format WGS84 selon une transformation valide avant de la convertir en KML.

  • 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 É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 É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 en tant que superposition d’écran, 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.

    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.

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 (KMZ)

Fichier KML en sortie, sous forme compressée, 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 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 que 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. La valeur du paramètre Convertir les entités en images détermine si les couches sont renvoyées sous forme de rasters ou sous forme d’une combinaison de vecteurs et de rasters.
Boolean
Convertir les entités en images
(Facultatif)

Spécifie si chaque couche d’entités de la carte sera convertie en une image raster distincte ou conservée en tant qu’entités. Ce paramètre n’est pas utilisé si le paramètre Renvoyer une image composite unique est sélectionné.

  • Activé : les couches d’entités sont converties en image raster distincte dans la sortie KML. Les couches raster normales sont également ajoutées à la sortie KML. Chaque couche raster KML en sortie est sélectionnable et sa transparence réglable dans certaines applications de visionneuse KML.
  • Désactivé : les entités sont conservées en tant que géométries d’entités dans la sortie KML. Il s’agit de l’option par défaut.
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.

  • Current Display Extent (Étendue actuellement affichée) Vue cartographique : l’étendue repose sur la carte ou la scène active. Cette option est uniquement disponible lorsqu’une carte est active.
  • Dessiner l’étendue Draw Extent : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Cette option crée une classe d’entités dans la géodatabase du projet et ajoute une couche à la carte. La classe d’entités possède le même système de coordonnées que la carte.
    Remarque :

    Cette option n’est pas disponible dans la boîte de dialogue Environnements. Elle est disponible uniquement dans un paramètre de l’outil correspondant à un type de données d’étendue ou dans l’onglet Environnements de la boîte de dialogue de l’outil.

    Remarque :

    Lorsque l’option de mise à jour Activer et désactiver la mise à jour de l’onglet Mettre à jour est activée, vous devez activer la mise à jour dans l’onglet du ruban Mettre à jour pour dessiner l’étendue.

  • Extent of a Layer (Étendue d’une couche) Couche : l’étendue repose sur une couche de carte active. Utilisez la liste déroulante pour choisir une couche disponible ou utilisez l’option Extent of data in all layers (Étendue des données dans toutes les couches) pour obtenir l’étendue combinée de toutes les couches de carte actives, y compris le fond de carte. Cette option est uniquement disponible lorsqu’une carte avec des couches est active.

    Chaque couche de carte comporte les options suivantes :

    • Toutes les entités Sélectionner tout : étendue de toutes les entités dans la couche.
    • Entités sélectionnéesArea from Selected Features : étendue de toutes les entités sélectionnées dans la couche.
    • Entités visibles Extent Indicator : étendue des entités visibles dans la couche.
      Remarque :

      Les étendues des options Entités sélectionnées Area from Selected Features et Entités visibles Extent Indicator sont disponibles uniquement pour les couches d’entités.

  • Browse (Parcourir) Parcourir : l’étendue repose sur un jeu de données existant.
  • Presse-papiers Coller : l’étendue peut être copiée vers et collée depuis le Presse-papiers.
    • Copier l’étendue Copier : copie les coordonnées et le système de coordonnées de l’étendue dans le Presse-papiers.
    • Coller l’étendue Coller : colle les coordonnées et, éventuellement, le système de coordonnées de l’étendue depuis le Presse-papiers. Si les valeurs du Presse-papiers n’incluent pas de système de coordonnées, l’étendue utilise celui de la carte.
    Remarque :

    Les coordonnées de l’étendue sont copiées vers et collées depuis le Presse-Papiers avec la même mise en forme et le même ordre que ceux de l’objet ArcPy Extent : X min, Y min, X max, Y max et la référence spatiale.

  • Reset Extent (Réinitialiser l’étendue) Réinitialiser : la valeur par défaut de l’étendue est rétablie.
  • Manually entered coordinates (Coordonnées saisies manuellement) : les coordonnées doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active.
    Attention :

    La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. L’utilisation d’une direction cardinale (N, S, E, O) n’est pas prise en charge. 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 Échelle de la carte 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 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 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
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.

  • Activé : les valeurs z des entités en entrée sont ignorées et toutes les entités sont localisées, ou attachées, au niveau du sol. Si les entités en entrée ne possèdent pas de valeurs z, elles seront toujours attachées au sol. Il s’agit de l’option par défaut.
  • Désactivé : les valeurs z des entités sont gérées dans le fichier KML en sortie. 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 de la 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, sous forme compressée, 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 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 que 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 en sortie contiendra des couches individuelles séparées. Il s’agit de l’option par défaut. La valeur du 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 d’entités de la carte sera convertie en une image raster distincte ou conservée en tant qu’entités. Ce paramètre n’est utilisé que si le paramètre is_composite est défini sur COMPOSITE.

  • VECTOR_TO_IMAGELes couches d’entités sont converties en image raster distincte dans la sortie KML. Les couches raster normales sont également ajoutées à la sortie KML. Chaque couche raster KML en sortie est sélectionnable et sa transparence réglable dans certaines applications de visionneuse KML.
  • VECTOR_TO_VECTORLes entités sont conservées en tant que géométries d’entités dans la sortie KML. 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 et les cellules raster de cette étendue seront incluses dans le fichier KML en sortie. Les options suivantes permettent de spécifier l’étendue :

  • 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.
  • 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 aucun effet sur les couches non 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 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.

  • ABSOLUTELes valeurs z des entités sont gérées dans le fichier KML en sortie. Les entités seront dessinées dans les clients KML par rapport au niveau de la mer.
  • CLAMPED_TO_GROUNDLes valeurs z des entités en entrée sont ignorées et toutes les entités sont localisées, ou attachées, au niveau du sol. Si les entités en entrée ne possèdent pas de valeurs z, elles seront toujours attachées au sol. Il s’agit de l’option par défaut.
Boolean
layout
(Facultatif)

Nom de la 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 l’outil MapToKML (fenêtre Python)

Le script ci-dessous pour la fenêtre Python montre comment utiliser 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-dessous 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))

Rubriques connexes