Gérer le cache de tuiles (Gestion des données)

Synthèse

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 cet outil, si aucune valeur de paramètre Zone d’intérêt n’est définie, le cache est créé avec l’étendue complète du raster source ou du jeu de données mosaïque, ou l’étendue actuelle du fichier de 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 Structure ArcGIS Online 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 Recréer les tuiles vides 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.

• Lorsque le paramètre Format prêt à l’emploi est sélectionné, le contenu du cache est généré à l’aide de la spécification de paquetage de tuiles ouverte. Le format de cache est Compact V2, mais la structure de cache est stockée au format JSON au lieu du format XML. Pour en savoir plus sur le format prêt à l’emploi, consultez Publier une couche de tuiles à partir d’un jeu de données en cache.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Emplacement du cache	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
Mode de gestion	Indique le mode à utiliser pour gérer le cache. Recréer toutes les tuiles—Toutes les tuiles sont remplacées. De nouvelles tuiles sont créées si nécessaire du fait de la modification de l'étendue ou de l'ajout de nouvelles couches dans le cas d'un cache multi-couches. Récréer les tuiles vides—Seules les tuiles vides sont créées. Les tuiles existantes restent en l'état. Supprimer des tuiles—Les tuiles sont supprimées du cache. La structure du dossier de cache n'est pas supprimée.	String
Nom du cache (Facultatif)	Nom du jeu de données du cache à créer dans l’emplacement du cache.	String
Source de données en entrée (Facultatif)	Jeu de données raster, mosaïque ou carte. Ce paramètre n’est pas obligatoire lorsque Mode de gestion est défini sur Supprimer des tuiles. Une carte (.mapx) ne peut pas contenir de service de carte ou d'imagerie.	Mosaic Layer; Raster Layer; Map
Structure de tuilage en entrée (Facultatif)	Indique la structure de tuilage utilisée. Structure ArcGIS Online—La structure de tuilage ArcGIS Online par défaut est utilisée. Importer la structure—Une structure de tuilage existante est importée et utilisée. Structure de tuile d'altitude—La structure de tuilage des services d’altitude est utilisée. Structure de tuilage WGS84 Version 2—La structure de tuilage WGS84 version 2 est utilisée. Structure de tuilage d’altitude WGS84 Version 2—La structure de tuilage WGS84 version 2 est utilisée pour créer un cache de tuiles des données d’altitude.	String
Importer la structure de tuilage (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
Echelles [Taille de pixel] (Espace disque estimé) (Facultatif)	Niveaux d’échelle auxquels les tuiles sont créées ou supprimées, selon la valeur du paramètre Mode de gestion. La taille de pixel repose sur la référence spatiale de la structure de tuilage. Par défaut, seules les valeurs des paramètres Échelle mise en cache minimale et Échelle mise en cache maximale sont utilisées. La modification de la valeur du paramètre Échelle mise en cache minimale ou Échelle mise en cache maximale a pour effet d'activer ou de désactiver les valeurs d'échelle appropriées. Les échelles qui sont activées et qui ne se trouvent pas dans la plage des valeurs du paramètre Échelle mise en cache minimale ou Échelle mise en cache maximale sont ignorées lorsque le cache est généré.	Double
Zone d’intérêt (Facultatif)	Zone d’intérêt utilisée pour contraindre l’emplacement où les tuiles sont 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
Taille maximale de la cellule source (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 : Pour les niveaux de cache situés dans les plages de visibilité de la source de données, le cache est généré à partir de la source de données. Pour les niveaux de cache qui ne sont pas situés dans les plages de visibilité de la source de données, le cache est généré à partir du niveau de cache précédent. Si la valeur est supérieure à zéro, le comportement suivant s’applique : Pour les niveaux dont les tailles de cellule sont inférieures ou égales à cette valeur de paramètre, le cache est généré à partir de la source de données. Pour les niveaux dont les tailles de cellule sont supérieures à cette valeur de paramètre, le cache est généré à partir du niveau de cache précédent. L’unité de mesure de cette valeur de paramètre doit être la même que l’unité de mesure de la taille de cellule du jeu de données source.	Double
Echelle mise en cache minimale (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
Echelle mise en cache maximale (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
Format prêt à l’emploi (Facultatif)	Indique si le contenu du cache est généré à l’aide de la spécification de paquetage de tuiles ouverte et indique également le format de fichier de la structure de cache. Activé : le contenu du cache est généré à l’aide de la spécification de paquetage de tuiles ouverte. Un paquetage de tuiles peut être empaqueté dans un fichier zip en tant que paquetage de tuiles pour les processus hors connexion. Le format de cache est Compact V2 et la structure de cache est stockée au format JSON. Désactivé : le contenu du cache est généré à l’aide d’une structure stockée au format XML. Il s’agit de l’option par défaut.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Nom du cache	Jeu de données du cache à créer dans l’emplacement du cache en sortie.	Raster Dataset

Python

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}, {ready_to_serve_format})

Nom	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. RECREATE_ALL_TILES—Toutes les tuiles sont remplacées. De nouvelles tuiles sont créées si nécessaire du fait de la modification de l'étendue ou de l'ajout de nouvelles couches dans le cas d'un cache multi-couches. RECREATE_EMPTY_TILES—Seules les tuiles vides sont créées. Les tuiles existantes restent en l'état. DELETE_TILES—Les tuiles sont supprimées du cache. La structure du dossier de cache n'est pas supprimée.	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 requis lorsque le paramètre manage_mode est défini sur DELETE_TILES. Une carte (.mapx) ne peut pas contenir de service de carte ou d'imagerie.	Mosaic Layer; Raster Layer; Map
tiling_scheme (Facultatif)	Indique la structure de tuilage utilisée. ARCGISONLINE_SCHEME—La structure de tuilage ArcGIS Online par défaut est utilisée. IMPORT_SCHEME—Une structure de tuilage existante est importée et utilisée. ARCGISONLINE_ELEVATION_SCHEME—La structure de tuilage des services d’altitude est utilisée. WGS84_V2_SCHEME—La structure de tuilage WGS84 version 2 est utilisée. WGS84_V2_ELEVATION_SCHEME—La structure de tuilage WGS84 version 2 est utilisée pour créer un cache de tuiles des données d’altitude.	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. Par défaut, seules les valeurs des paramètres min_cached_scale et max_cached_scale sont utilisées lorsque le cache est généré. La modification de la valeur du paramètre min_cached_scale ou max_cached_scale a un impact sur les échelles utilisées lorsque le cache est généré. Les échelles qui ne se trouvent pas dans la plage des valeurs du paramètre min_cached_scale ou max_cached_scale sont ignorées lorsque le cache est généré.	Double
area_of_interest (Facultatif)	Zone d’intérêt utilisée pour contraindre l’emplacement où les tuiles sont 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 : Pour les niveaux de cache situés dans les plages de visibilité de la source de données, le cache est généré à partir de la source de données. Pour les niveaux de cache qui ne sont pas situés dans les plages de visibilité de la source de données, le cache est généré à partir du niveau de cache précédent. Si la valeur est supérieure à zéro, le comportement suivant s’applique : Pour les niveaux dont les tailles de cellule sont inférieures ou égales à cette valeur de paramètre, le cache est généré à partir de la source de données. Pour les niveaux dont les tailles de cellule sont supérieures à cette valeur de paramètre, le cache est généré à partir du niveau de cache précédent. L’unité de mesure de cette valeur de paramètre doit être la même que l’unité de mesure 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
ready_to_serve_format (Facultatif)	Indique si le contenu du cache est généré à l’aide de la spécification de paquetage de tuiles ouverte et indique également le format de fichier de la structure de cache. READY_TO_SERVE_FORMAT—Le contenu du cache est généré à l’aide de la spécification de paquetage de tuiles ouverte (https://github.com/Esri/tile-package-spec). Un paquetage de tuiles peut être empaqueté dans un fichier zip en tant que paquetage de tuiles pour les processus hors connexion. Le format de cache est Compact V2 et la structure de cache est stockée au format JSON. NON_READY_TO_SERVE_FORMAT—Le contenu du cache est généré à l’aide d’une structure stockée au format XML. Il s’agit de l’option par défaut.	Boolean

Sortie obtenue

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 la fonction ManageTileCache (fenêtre Python)

Il s’agit d’un exemple Python d’utilisation de la fonction 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", "NON_READY_TO_SERVE_FORMAT")

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 la fonction 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"
ready_to_serve_format="NON_READY_TO_SERVE_FORMAT"

arcpy.ManageTileCache_management(
       folder, mode, cacheName, dataSource, method, tilingScheme,
       scales, areaofinterest, maxcellsize, mincachedscale, maxcachedscale, ready_to_serve_format)

Environnements

Facteur de traitement parallèle

Cas particuliers

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