Résumé
Crée un cache de tuiles ou actualise des tuiles dans un cache de tuiles existant. Vous pouvez utiliser cet outil pour créer des tuiles, remplacer des tuiles manquantes, actualiser des tuiles devenues obsolètes et supprimer des tuiles.
Utilisation
La valeur du paramètre Source de données en entrée peut être une carte ; toutefois, le document ne peut pas contenir de service de carte ou d’imagerie.
Lorsque vous créez un cache de tuiles avec cet outil, si la valeur du paramètre Zone d’intérêt n’est pas définie, le cache est créé avec l’étendue complète du raster ou l’étendue actuelle de la carte.
Il peut arriver que l’étendue du cache généré soit supérieure à la valeur du paramètre Zone d’intérêt. Dans ce cas, l’outil divise les données en zones de grande taille, connues sous le nom de super tuiles, avant de les découper en tuiles de la taille spécifiée. Lorsque la valeur du paramètre Source de données en entrée utilise l’anticrénelage, la taille de la super tuile est de 2 048 pixels sur 2 048. Sinon, la taille est de 4 096 pixels sur 4 096. Lorsque l’entité Zone d’intérêt définie intersecte la limite d’une super tuile, l’intégralité de cette super tuile est créée. Cela signifie qu’un zoom avant peut être nécessaire pour réellement constater un gain de temps et d’espace disque grâce à la mise en cache par une classe d’entités. Si vous possédez plusieurs zones d’intérêt et qu’elles couvrent la majorité de la valeur du paramètre Source de données en entrée, il est possible que l’avantage de la mise en cache par classe d’entités soit limité, car la plupart des entités intersectent une super tuile.
Pour créer un cache dans une structure de tuilage personnalisée, vérifiez qu’une structure de tuilage est définie pour le jeu de données source avant d’utiliser cet outil. Vous pouvez utiliser l'outil Générer la structure de tuilage du cache de tuiles pour créer la structure de tuilage.
Pour créer un cache dans une structure de tuilage ArcGIS Online, spécifiez ARCGISONLINE_SCHEME pour le paramètre Structure de tuilage en entrée.
L'exécution de cet outil peut prendre du temps pour les caches qui couvrent une grande étendue géographique ou des échelles très grandes. Si l'outil est annulé, la création de tuiles est arrêtée, mais les tuiles existantes ne sont pas supprimées. Cela signifie que vous pouvez annuler l’exécution de l’outil à tout moment. Si vous l’exécutez à nouveau ultérieurement sur le même cache et que vous spécifiez RECREATE_EMPTY_TILES pour le paramètre Mode de gestion, il reprendra là où il s’est arrêté.
Cet outil prend en charge le paramètre d'environnement Traitement parallèle.
Syntaxe
arcpy.management.ManageTileCache(in_cache_location, manage_mode, {in_cache_name}, {in_datasource}, {tiling_scheme}, {import_tiling_scheme}, {scales}, {area_of_interest}, {max_cell_size}, {min_cached_scale}, {max_cached_scale})
Paramètre | Explication | Type de données |
in_cache_location | Dossier dans lequel le jeu de données du cache est créé, couche raster ou chemin d’accès à un cache de tuiles existant. | Folder; Raster Layer |
manage_mode | Indique le mode à utiliser pour gérer le cache.
| String |
in_cache_name (Facultatif) | Nom du jeu de données du cache à créer dans l’emplacement du cache. | String |
in_datasource (Facultatif) | Jeu de données raster, mosaïque ou document ArcMap. Ce paramètre n’est pas obligatoire lorsque DELETE_TILES est spécifié dans le paramètre manage_mode. Un document ArcMap (.mxd) ne peut pas contenir de service de carte ou d'imagerie. | ArcMap Document; Mosaic Layer; Raster Layer |
tiling_scheme (Facultatif) | Indique la structure de tuilage utilisée.
| String |
import_tiling_scheme (Facultatif) | Chemin d’accès vers un fichier de structure existant (.xml) ou importé à partir d’un service d’imagerie ou de carte existant. | Image Service; Map Server; File |
scales [scale,...] (Facultatif) | Niveaux d’échelle auxquels les tuiles sont créées ou supprimées, selon la valeur du paramètre manage_mode. La taille de pixel repose sur la référence spatiale de la structure de tuilage.
| Double |
area_of_interest (Facultatif) | Définit une zone d'intérêt pour contraindre l'emplacement où les tuiles seront créées ou supprimées. Il peut s'agir d'une classe d'entité ou d'une entité que vous définissez de manière interactive. Ce paramètre est utile si vous souhaitez gérer des tuiles pour les zones de forme irrégulière. Il permet également de mettre certaines zones en cache et de conserver telles quelles les zones moins visitées qui n’ont pas été mises en cache. | Feature Set |
max_cell_size (Facultatif) |
Valeur qui définit la visibilité de la source de données pour laquelle le cache va être généré. Par défaut, la valeur est vide. Si la valeur est vide, le comportement suivant s’applique :
Si la valeur est supérieure à zéro, le comportement suivant s’applique :
L'unité de la valeur Taille maximale de la cellule source doit être la même que l'unité de la taille de cellule du jeu de données source. | Double |
min_cached_scale (Facultatif) | Échelle minimale à laquelle les tuiles sont créées. Il ne s’agit pas nécessairement de la plus petite échelle de la structure de tuilage. L’échelle minimale du cache détermine les échelles utilisées lorsque le cache est généré. | Double |
max_cached_scale (Facultatif) | Échelle maximale à laquelle les tuiles sont créées. Il ne s’agit pas nécessairement de l’échelle la plus grande de la structure de tuilage. L'échelle maximale de votre cache détermine les échelles utilisées lorsque le cache est généré. | Double |
Sortie dérivée
Nom | Explication | Type de données |
out_cache_location | Jeu de données du cache à créer dans l’emplacement du cache en sortie. | Raster Dataset |
Exemple de code
Exemple 1 d'utilisation de l'outil Gérer le cache de tuiles (fenêtre Python)
Il s'agit d'un exemple Python d'utilisation de l'outil ManageTileCache.
import arcpy
arcpy.ManageTileCache_management(
"C:/CacheDatasets/Manage", "RECREATE_ALL_TILES", "Test",
"C:/Data/Cache.gdb/Md", "IMPORT_SCHEME", "C:/Data/Cache.gdb/Md",
"#", "#", "#", "40000", "2000")
Exemple 2 d'utilisation de l'outil Gérer le cache de tuiles (script autonome)
Il s'agit d'un exemple de script Python d'utilisation de l'outil ManageTileCache.
#Generate tile cache for 3 out of 5 levels defined in tiling scheme
import arcpy
folder = "C:/Workspace/CacheDatasets/Manage"
mode = "RECREATE_ALL_TILES"
cacheName = "Test"
dataSource = "C:/Workspace/Cache.gdb/md"
method = "IMPORT_SCHEME"
tilingScheme = "C:/Workspace/Schemes/Tilingscheme.xml"
scales = "16000;8000;4000;2000;1000"
areaofinterest = "#"
maxcellsize = "#"
mincachedscale = "8000"
maxcachedscale = "2000"
arcpy.ManageTileCache_management(
folder, mode, cacheName, dataSource, method, tilingScheme,
scales, areaofinterest, maxcellsize, mincachedscale, maxcachedscale)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui