| Étiquette | Explication | Type 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.
| 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é.
| 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.
| 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.
| 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 |
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.
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
: l’étendue repose sur la carte ou la scène active. Cette option est uniquement disponible lorsqu’une carte est active.
: l’étendue repose sur une couche de carte active. Utilisez la liste déroulante pour choisir une couche disponible ou utilisez l’option 
: étendue de toutes les entités dans la couche.
: étendue de toutes les entités sélectionnées dans la couche.
: l’étendue repose sur un jeu de données existant.
: l’étendue peut être copiée vers et collée depuis le Presse-papiers.
: copie les coordonnées et le système de coordonnées de l’étendue dans le Presse-papiers.
: la valeur par défaut de l’étendue est rétablie.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 | 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.
| 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.
| 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 :
| 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.
| 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
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")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))Environnements
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?