Carte vers KML (Conversion)

Synthèse

Convertit une carte en fichier KML contenant des géométries et une symbologie. Le fichier 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 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 le paramètre Return single composite image (Renvoyer une image composite unique).

  • Pour générer toutes les couches sous forme d’image raster séparée, utilisez le paramètre Convert Vector to Raster (Conversion vecteur/raster).

  • 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 000x5 000 pixels, lorsque la valeur du paramètre Size of returned image (pixels) (Taille de l’image renvoyée (pixels)) est 1 000 pixels, l’image en sortie est composée de 7x5 (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.

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 une extension .kmz. Le fichier peut être lu par n’importe quel client KML, dont ArcGIS Earth et Google Earth.

File
Echelle de la carte en sortie
(Facultatif)

Echelle à laquelle exporter chaque couche de la carte.

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 doit être affichée sous la forme de vecteurs 3D, si le paramètre Return single composite image (Renvoyer une image composite unique) est activé, 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.

Double
Renvoyer une image composite unique
(Facultatif)

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

  • Activé : le fichier KML en sortie contient 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 fichier KML en sortie. Lorsque vous sélectionnez cette option, les entités et couches individuelles du fichier KML ne peuvent pas être sélectionnées.
  • Désactivé : le fichier KML en sortie contient des couches individuelles séparées. Il s’agit de l’option par défaut. Le paramètre Convert Vector to Raster (Conversion vecteur/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/raster
(Facultatif)

Spécifie si chaque couche vectorielle de la carte est convertie en une image raster distincte ou conservée en tant que vecteurs KML.

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 sont 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 sont 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 Map Output Scale (É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 votre carte prennent en charge une haute résolution et si votre 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 doivent être fixées au sol.

  • Activé : les valeurs z des entités en entrée sont ignorées et le fichier KML est créé avec les entités attachées au sol. Les entités sont drapées sur le terrain. Cette option est utilisée pour les entités qui 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 sont utilisées lors de la création du fichier KML. Les entités sont dessinées dans les clients KML par rapport au niveau de la mer.
Boolean

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})
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 une extension .kmz. Le fichier peut être lu par n’importe quel client KML, dont ArcGIS Earth et Google Earth.

File
map_output_scale
(Facultatif)

Echelle à laquelle exporter chaque couche de la carte.

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 vos entités ne présentent pas de rendu dépendant de l’échelle.

Double
is_composite
(Facultatif)

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

  • COMPOSITELe fichier KML en sortie contient 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 fichier KML en sortie. Lorsque vous sélectionnez cette option, 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 est convertie en une image raster distincte ou conservée en tant que vecteurs KML.

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

  • VECTOR_TO_IMAGELes couches vectorielles sont 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 sont 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 (É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
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 votre carte prennent en charge une haute résolution et si votre 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
ignore_zvalue
(Facultatif)

Indique si les entités doivent être fixées au sol.

  • CLAMPED_TO_GROUND Les valeurs z des entités sont ignorées et le fichier KML est créé avec les entités attachées au sol. Les entités sont drapées sur le terrain. Ce paramètre est utilisé pour les entités qui ne présentent pas de valeurs z. Il s’agit de l’option par défaut.
  • ABSOLUTELes valeurs z des entités sont utilisées lors de la création du fichier KML. Les entités sont dessinées dans les clients KML par rapport au niveau de la mer.
Boolean

Exemple de code

1er exemple d'utilisation de l'outil MapToKML (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction MapToKML en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.MapToKML_conversion("cities.mapx", "cities.kmz")
2e exemple d'utilisation de l'outil MapToKML (script autonome)

Le script Python ci-dessous illustre l'utilisation de l'outil 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'
            #Execute MapToKML	
            arcpy.MapToKML_conversion(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