| É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 | 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.
| 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é.
| 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).
| 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.
| 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 |
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.
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
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. 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.
| 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.
| 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).
| 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.
| 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
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")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
Vous avez un commentaire à formuler concernant cette rubrique ?