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
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 source ou de la mosaïque, ou l'étendue actuelle de la carte.
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 Utiliser la structure d'ArcGIS Online pour le paramètre Structure de tuilage en entrée (définissez tiling_scheme sur ARCGISONLINE_SCHEME dans Python).
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 Recréer les tuiles vides pour le paramètre Mode de gestion, il reprendra là où il s'est arrêté (définissez manage_mode sur RECREATE_EMPTY_TILES dans Python).
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éé 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 carte. Ce paramètre n'est pas obligatoire lorsque DELETE_TILES est spécifié dans le paramètre manage_mode. Une carte (.mapx) ne peut pas contenir de service de carte ou d'imagerie. | Mosaic Layer; Raster Layer; Map |
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 | Jeu de données du cache à créer dans l’emplacement du cache en sortie. | Jeu de données raster |
Exemple de code
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")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
- Facteur de traitement parallèle
Si la valeur Facteur de traitement parallèle est vide (non renseignée), l'outil s'exécute avec la valeur par défaut 50 % (la moitié) des cœurs disponibles.
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?