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 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 l'outil Gérer le cache de tuiles, si aucune zone d'intérêt n'est définie, le cache est créé avec l'étendue complète du raster et l'étendue actuelle d'un document ArcMap.
Il peut arriver que l'étendue du cache généré soit plus importante que la zone d'intérêt. Dans ce cas, l'outil Gérer le cache de tuiles 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 que vous avez demandée. Lorsque la 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 un grand nombre de zones d'intérêt et qu'elles couvrent la majorité de la 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 votre 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 de 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
ManageTileCache_management (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éé ou chemin d'accès à un cache de tuiles existant. | Folder; Raster Layer |
manage_mode | Mode de gestion du 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) | Paramètre facultatif permettant de spécifier la structure de tuilage.
| 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; MapServer; File |
scales [scale,...] (Facultatif) | Niveaux d'échelle auxquels vous créez ou supprimez des tuiles lors de l'exécution de cet outil, selon la valeur du paramètre manage_mode. La taille de pixel est représentée en fonction de 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
Si la valeur est supérieure à zéro
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) | Echelle minimale à laquelle vous souhaitez créer des tuiles. Ce n'est pas nécessairement la plus petite échelle de votre structure de tuile. L'échelle minimale de votre cache détermine les échelles utilisées lorsque le cache est généré. | Double |
max_cached_scale (Facultatif) | Echelle maximale à laquelle vous souhaitez créer des tuiles. Ce n'est pas nécessairement la plus grande échelle de votre structure de tuile. 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 |
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
- ArcGIS Desktop Basic: Oui
- ArcGIS Desktop Standard: Oui
- ArcGIS Desktop Advanced: Oui