Étiquette | Explication | Type de données |
Carte en entrée | Carte à partir de laquelle les tuiles ont été générées et empaquetées. | Map |
Paquetage pour ArcGIS Online | Bing Maps | Google Maps | Détermine si la structure de tuilage est générée à partir d’un service de carte existant ou si les tuiles de carte sont générées pour ArcGIS Online, Bing Maps et Google Maps.
| Boolean |
Fichier en sortie | Chemin et le nom de fichier en sortie du paquetage de tuiles de carte. Lorsque le paramètre Créer plusieurs paquetages est activé, ce paramètre est remplacé par le paramètre Dossier en sortie pour spécifier l’emplacement dans lequel les paquetages sont générés. | File |
Format de tuilage | Spécifie le format utilisé pour les tuiles générées.
| String |
Niveau de détail maximal | Représentation sous forme d’entiers correspondant au nombre d’échelles utilisées pour définir une structure de tuilage de cache. Cette échelle définit le niveau maximum de génération des tuiles de cache dans le paquetage de tuiles. Les valeurs plus élevées reflètent des échelles plus grandes qui affichent plus de détails, mais occupent un plus grand espace de stockage. Les valeurs plus faibles reflètent des échelles plus petites qui affichent moins de détails et occupent moins de stockage. Les valeurs possibles sont comprises entre 1 et 23. La valeur par défaut est 1. La valeur maximale du niveau de détail doit être supérieure à la valeur minimale du niveau de détail. | Long |
Service (Facultatif) | Nom du service de carte ou des fichiers .xml utilisés pour la structure de tuilage. Ce paramètre est obligatoire uniquement lorsque le paramètre Paquetage pour ArcGIS Online | Bing Maps | Google Maps est désactivé. | Map Server; File |
Résumé (Facultatif) | Les informations sur le récapitulatif qui seront ajoutées aux propriétés du paquetage. | String |
Balises (Facultatif) | Les informations sur les balises seront ajoutées aux propriétés du paquetage. Vous pouvez ajouter plusieurs balises en les séparant par une virgule ou un point-virgule. | String |
Étendue (Facultatif) | Spécifie l'étendue utilisée pour sélectionner ou découper les entités.
| Extent |
Qualité de compression (Facultatif) | Une valeur comprise entre 1 et 100 pour définir la qualité de compression JPEG. La valeur par défaut est 75 pour le format de tuile JPEG et zéro pour les autres formats. La compression est uniquement prise en charge pour les formats JPEG et mixte. La sélection d'une valeur plus élevée entraîne une taille de fichier supérieure avec une image de meilleure qualité. La sélection d'une valeur inférieure entraîne une taille de fichier inférieure avec une image de qualité inférieure. | Long |
Type de paquetage (Facultatif) | Spécifie le type de paquetage de tuiles à créer.
| String |
Niveau de détail minimal (Facultatif) | Représentation sous forme d’entiers correspondant au nombre d’échelles utilisées pour définir une structure de tuilage de cache. Cette valeur d’échelle définit le niveau minimal pour la mise à disposition et la génération des tuiles de cache dans le paquetage de tuiles. Les valeurs possibles sont comprises entre 0 et 23. La valeur par défaut est 0. La valeur minimale du niveau de détail doit être inférieure ou égale à la valeur maximale du niveau de détail. | Long |
Zone d’intérêt (Facultatif) | Jeu d’entités qui contraint l’emplacement où les tuiles sont créées. Utilisez la zone d’intérêt afin de créer des tuiles pour des zones de forme irrégulière ou des entités multi-parties. Les zones situées en dehors de la zone de délimitation d’entités de zone d’intérêt ne sont pas mises en cache. Si aucune valeur n’est indiquée pour ce paramètre, la zone d’intérêt est l’étendue complète de la carte en entrée. | Feature Set |
Créer plusieurs paquetages (Facultatif) | Spécifie si un paquetage de tuiles compressé ou plusieurs paquetages de tuiles de carte sont générés. Ce paramètre n’est pas disponible lorsque la variable d’environnement Facteur de traitement parallèle est définie sur 0 ou si le paramètre Type de paquetage est défini sur tpk.
| Boolean |
Dossier en sortie | Emplacement dans lequel les différents paquetages de tuiles de carte sont générés. Si le dossier en sortie spécifié n’est pas vide, un sous-dossier est créé dans le dossier en sortie pour y stocker les tuiles. Le GUID généré automatiquement est utilisé comme nom de dossier. Lorsque le paramètre Créer plusieurs paquetages est désactivé, ce paramètre est remplacé par le paramètre Dossier en sortie pour spécifier le nom du seul paquetage de tuiles généré. | Folder |
Synthèse
Génère des tuiles à partir d’une carte et les empaquette sous forme d’un unique paquetage de tuiles compressé ou de plusieurs paquetages de tuiles de carte.
Utilisation
Cet outil respecte la variable d’environnement Facteur de traitement parallèle. Lorsque le paramètre Créer plusieurs paquetages est activé, le traitement parallèle génère le contenu du cache sur plusieurs processus afin d’utiliser l’unité de traitement centrale disponible et de générer les paquetages de tuiles lorsque le seuil par défaut (taille limitée à 1 Go) est atteint.
Utilisez le paramètre Créer plusieurs paquetages lorsque vous utilisez de gros volumes de données. Lorsque ce paramètre est activé, plusieurs petits paquetages de tuiles sont créés au lieu d’un seul grand paquetage. Cela permet de générer un contenu de tuile supérieur à 500 Go en une seule tâche et de le partager ou de le charger et de le publier sur ArcGIS Online sous forme d’une couche de tuile hébergée. Grâce à cette approche, vous pouvez générer le contenu d’une grande tuile en petits paquetages de tuiles en vue de le partager sans diviser les niveaux ou étendues de cache en différentes tâches.
Lorsque ce paramètre est activé, vous devez indiquer un chemin vers un dossier vide du système de fichiers dans le paramètre Dossier en sortie pour enregistrer les paquetages en sortie. Vous pouvez créer des paquetages multi-parties seulement si le paramètre Type de paquetage est défini sur tpkx et si la variable d’environnement Facteur de traitement parallèle n’est pas définie sur 0.
Lorsque le paramètre Format de tuilage est défini sur PNG, l’outil utilise automatiquement le format correct (PNG8, PNG24 ou PNG32) en fonction de la valeur spécifiée dans le paramètre Niveau de détail maximal.
La carte en entrée doit contenir une description et des balises pour que l’outil puisse être exécuté. Pour ajouter une description et des balises, cliquez avec le bouton droit sur le nom de la carte dans la fenêtre Contenu, puis sélectionnez Propriétés. Dans la boîte de dialogue Propriétés de la carte, sous l’onglet Métadonnées, complétez les zones de texte Balises et Description.
Paramètres
arcpy.management.CreateMapTilePackage(in_map, service_type, output_file, format_type, level_of_detail, {service_file}, {summary}, {tags}, {extent}, {compression_quality}, {package_type}, {min_level_of_detail}, {area_of_interest}, {create_multiple_packages}, output_folder)
Nom | Explication | Type de données |
in_map | Carte à partir de laquelle les tuiles ont été générées et empaquetées. | Map |
service_type | Détermine si la structure de tuilage est générée à partir d’un service de carte existant ou si les tuiles de carte sont générées pour ArcGIS Online, Bing Maps et Google Maps.
| Boolean |
output_file | Chemin et le nom de fichier en sortie du paquetage de tuiles de carte. | File |
format_type | Spécifie le format utilisé pour les tuiles générées.
| String |
level_of_detail | Représentation sous forme d’entiers correspondant au nombre d’échelles utilisées pour définir une structure de tuilage de cache. Cette échelle définit le niveau maximum de génération des tuiles de cache dans le paquetage de tuiles. Les valeurs plus élevées reflètent des échelles plus grandes qui affichent plus de détails, mais occupent un plus grand espace de stockage. Les valeurs plus faibles reflètent des échelles plus petites qui affichent moins de détails et occupent moins de stockage. Les valeurs possibles sont comprises entre 1 et 23. La valeur par défaut est 1. La valeur maximale du niveau de détail doit être supérieure à la valeur minimale du niveau de détail. | Long |
service_file (Facultatif) | Nom du service de carte ou des fichiers .xml utilisés pour la structure de tuilage. Ce paramètre est requis uniquement lorsque le paramètre service_type est défini sur EXISTING. | Map Server; File |
summary (Facultatif) | Les informations sur le récapitulatif qui seront ajoutées aux propriétés du paquetage. | String |
tags (Facultatif) | Les informations sur les balises seront ajoutées aux propriétés du paquetage. Vous pouvez ajouter plusieurs balises en les séparant par une virgule ou un point-virgule. | String |
extent (Facultatif) | Spécifie l'étendue utilisée pour sélectionner ou découper les entités.
| Extent |
compression_quality (Facultatif) | Une valeur comprise entre 1 et 100 pour définir la qualité de compression JPEG. La valeur par défaut est 75 pour le format de tuile JPEG et zéro pour les autres formats. La compression est uniquement prise en charge pour les formats JPEG et mixte. La sélection d'une valeur plus élevée entraîne une taille de fichier supérieure avec une image de meilleure qualité. La sélection d'une valeur inférieure entraîne une taille de fichier inférieure avec une image de qualité inférieure. | Long |
package_type (Facultatif) | Spécifie le type de paquetage de tuiles à créer.
| String |
min_level_of_detail (Facultatif) | Représentation sous forme d’entiers correspondant au nombre d’échelles utilisées pour définir une structure de tuilage de cache. Cette valeur d’échelle définit le niveau minimal pour la mise à disposition et la génération des tuiles de cache dans le paquetage de tuiles. Les valeurs possibles sont comprises entre 0 et 23. La valeur par défaut est 0. La valeur minimale du niveau de détail doit être inférieure ou égale à la valeur maximale du niveau de détail. | Long |
area_of_interest (Facultatif) | Jeu d’entités qui contraint l’emplacement où les tuiles sont créées. Utilisez la zone d’intérêt afin de créer des tuiles pour des zones de forme irrégulière ou des entités multi-parties. Les zones situées en dehors de la zone de délimitation d’entités de zone d’intérêt ne sont pas mises en cache. Si aucune valeur n’est indiquée pour ce paramètre, la zone d’intérêt est l’étendue complète de la carte en entrée. | Feature Set |
create_multiple_packages (Facultatif) | Spécifie si un paquetage de tuiles compressé ou plusieurs paquetages de tuiles de carte sont générés. Ce paramètre n’est pas disponible lorsque la variable d’environnement parallelProcessingFactor est définie sur 0 ou si le paramètre package_type est défini sur tpk.
| Boolean |
output_folder | Dossier en sortie dans lequel les différents paquetages de tuiles de carte sont générés. Si le dossier en sortie spécifié n’est pas vide, un sous-dossier est créé dans le dossier en sortie pour y stocker les tuiles. Le GUID généré automatiquement est utilisé comme nom de dossier. | Folder |
Exemple de code
Le script Python ci-dessous illustre l’utilisation de la fonction CreateMapTilePackage dans la fenêtre Python.
import arcpy
arcpy.env.workspace = r"C:\Data\MinMaxLOD\states73K"
aprx = arcpy.mp.ArcGISProject(r"C:\Data\MinMaxLOD\states73K\states73K_1.aprx")
map1 = aprx.listMaps()[0]
arcpy.management.CreateMapTilePackage(map1, "ONLINE", "Example.tpkx", "PNG", "5")
Recherchez toutes les cartes du projet et créez un seul paquetage de tuiles de carte pour chaque carte.
# Name: CreateMapTilePackage.py
# Description: Find all the maps in the project and
# create a single map tile package for each map
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = r"C:\Data\MinMaxLOD\states73K"
# Loop through the project, find all the maps, and
# create a single map tile package for each map,
# using the same name as the map
p = arcpy.mp.ArcGISProject("c:\\temp\\myproject.aprx")
extent = ""
aoi = ""
for m in p.listMaps():
print("Packaging " + m.name)
arcpy.management.CreateMapTilePackage(m, "ONLINE", "{}.tpkx".format(m.name),
"PNG", 9, None, "MapSummary", "MapTag", extent, "", "tpkx", 5, aoi)
Créez plusieurs paquetages de tuiles de carte pour une carte donnée.
# Name: CreateMapTilePackage.py
# Description: Create multiple map tile packages for a given map
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = r"C:\Data\MinMaxLOD\states73K"
# Create multiple map tile packages for given map,
aprx = arcpy.mp.ArcGISProject("c:\\temp\\myproject.aprx")
map1 = aprx.listMaps()[0]
extent = ""
aoi = ""
createMultiplePackages = "create_multiple_packages"
outputFolder = r"C:\11\multi"
arcpy.management.CreateMapTilePackage(map1, "ONLINE", "", "PNG", 9, None, "MapSummary", "MapTag",
extent, "", "tpkx", 5, aoi,createMultiplePackages, outputFolder )
Environnements
Vous avez un commentaire à formuler concernant cette rubrique ?