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, sélectionnez File (Fichier) > Map Document Properties (Propriétés de la carte) dans le menu principal, puis entrez une description et des balises.
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.
Pour décompresser un paquetage de tuiles de carte, faites glisser le fichier .tpk dans ArcMap ou cliquez avec le bouton droit sur le fichier .tpk dans la fenêtre Catalog (Catalogue), puis sélectionnez Unpack (Décompresser). Vous pouvez également utiliser l'outil Extraire le paquetage et spécifier un dossier en sortie.
Par défaut, l’option Unpack (Décompresser) extrait toujours le paquetage dans votre profil d’utilisateur sous un des dossiers suivants :
- XP : C:\Documents and Settings\<username>\My Documents\ArcGIS\Packages
- Vista et Windows 7 : C:\Users\<username>\Documents\ArcGIS\Packages
Pour modifier l'emplacement cible par défaut des paquetages décompressés, ouvrez Options ArcMap dans le menu Personnaliser. Dans l’onglet Sharing (Partage), dans la section Packaging (Empaquetage), activez l’option Use user specified location (Utiliser l’emplacement spécifié par l’utilisateur), puis accédez à l’emplacement du nouveau dossier.
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 | Document ArcMap à partir duquel les tuiles ont été générées et empaquetées. | ArcMap Document |
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) | Indique l'étendue en saisissant manuellement les coordonnées dans le paramètre d'étendue à l'aide du format X-Min Y-Min X-Max Y-Max. Pour utiliser l'étendue d'une couche spécifique, indiquez le nom de la couche.
| 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
Exemple 1 d'utilisation de l'outil CreateMapTilePackage (fenêtre Python)
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("Example.mxd", "ONLINE", "Example.tpk", "PNG8", "10")
Exemple 2 d'utilisation de l'outil CreateMapTilePackage (script autonome)
Recherchez et créez des paquetages de tuiles de carte pour toutes les cartes qui résident dans un dossier spécifié.
# Name: CreateMapTilePackage.py
# Description: Find all the map documents that reside in a specified folder and create tile packages for each map document.
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/Tilepackages/"
# Loop through the workspace, find all the mxds and create a tile package using the same name as the mxd
for mxd in arcpy.ListFiles("*.mxd"):
print("Packaging " + mxd)
arcpy.CreateMapTilePackage_management(mxd, "ONLINE", os.path.splitext(mxd)[0] + ".tpk" "PNG8", "10")
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui