Résumé
Génère des tuiles à partir d'une carte ou d'un fond de carte et crée un paquetage de tuiles pour générer un seul fichier .tpk compressé.
Utilisation
La carte en entrée doit contenir une description et des balises pour que l’outil puisse s’exécuter. Pour ajouter une description et des balises, cliquez avec le bouton droit sur le nom de la carte dans la fenêtre Contents (Contenu), choisissez Properties (Propriétés) et entrer une description et des balises sous l’onglet Description.
En choisissant PNG pour le paramètre Format de tuilage, l'outil sélectionne automatiquement le format correct (PNG8, PNG24 ou PNG32) en fonction de la valeur spécifiée dans Niveau d'affichage.
Cet outil respecte l’environnement Facteur de traitement parallèle. Si l’environnement n’est pas défini (valeur par défaut) ou s’il est défini sur 100, le traitement parallèle complet est activé et l’outil tente de répartir les tâches sur tous les cœurs logiques de la machine. Si vous définissez l’environnement sur 0, le traitement parallèle est désactivé. Si vous spécifiez un facteur compris entre 1 et 99, l’outil détermine le pourcentage de cœurs logiques à utiliser en appliquant la formule suivante, arrondie à l’entier supérieur le plus proche :
.Parallel Processing Factor / 100 * Logical Cores
Si le résultat de cette formule est 0 ou 1, le traitement parallèle n'est pas activé.
Syntaxe
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})
Paramètre | 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 | Paquetage de tuiles de carte en sortie. | File |
format_type | Spécifie le format des tuiles générées.
| String |
level_of_detail | L’échelle maximale à laquelle les tuiles sont générées pour le paquetage. La valeur par défaut est 1. Les valeurs possibles sont comprises entre 1 et 24. Les valeurs plus grandes reflètent des échelles plus grandes qui affichent plus de détails mais occupent un plus grand espace de stockage, tandis que les valeurs plus petites reflètent des échelles plus petites qui affichent moins de détails et occupent un plus petit espace de stockage. Cette valeur doit être supérieure ou égale à min_level_of_detail. | Long |
service_file (Facultatif) | Le nom du service de carte ou des fichiers XML à utiliser pour la structure de tuile. Ce paramètre est requis uniquement lorsque le paramètre service_type est défini sur EXISTING. | MapServer; File |
summary (Facultatif) | Ajoute un récapitulatif des propriétés du paquetage. | String |
tags (Facultatif) | Ajoute des informations sur les balises 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 le format JPEG et MIXED. 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) | L’échelle minimale à laquelle les tuiles sont générées pour le paquetage. La valeur par défaut est 1. Les valeurs possibles sont comprises entre 1 et 24. Les valeurs plus grandes reflètent des échelles plus grandes qui affichent plus de détails mais occupent un plus grand espace de stockage, tandis que les valeurs plus petites reflètent des échelles plus petites qui affichent moins de détails et occupent un plus petit espace de stockage. Cette valeur doit être inférieure ou égale à level_of_detail. | Long |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l’utilisation de l’outil CreateMapTilePackage dans la fenêtre Python.
import arcpy
arcpy.env.workspace = "C:/TilePackageExample"
arcpy.CreateMapTilePackage_management("World Soils", "ONLINE", "Example.tpk", "PNG8", "10")
Recherchez et créez des paquetages de tuiles de carte pour toutes les cartes dans un projet.
# Name: CreateMapTilePackage.py
# Description: Find all the maps in the project and
# create a map tile package for each map
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/Tilepackages"
# Loop through the project, find all the maps, and
# create a map tile package for each map,
# using the same name as the map
p = arcpy.mp.ArcGISProject("c:\\temp\\myproject.aprx")
for m in p.listMaps():
print("Packaging " + m.name)
arcpy.CreateMapTilePackage_management(m, "ONLINE", "{}.tpk".format(m.name),
"PNG8", "10")
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?