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

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 cet outil, si aucune valeur n’est définie pour le paramètre Area of Interest (Zone d’intérêt), 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 Area of Interest (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 Input Data Source (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é Area of Interest (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 Input Data Source (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 Generate Tile Cache Tiling Scheme (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 ArcGIS Online scheme (Structure ArcGIS Online) pour le paramètre Input Tiling Scheme (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 (Recréer les tuiles vides) pour le paramètre Manage Mode (Mode de gestion), il reprendra là où il s’est arrêté.
Cet outil respecte le paramètre d’environnement Traitement parallèle.
Lorsque le paramètre Ready To Serve Format (Format prêt à l’emploi) est coché, le contenu en cache est généré à l’aide de la spécification de paquetage de tuiles ouverte. Le format du cache est Compact V2, mais la structure du cache est stockée au format JSON au lieu de 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.

Etiqueter	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 le paramètre Manage Mode (Mode de gestion) est défini sur Delete tiles (Supprimer des tuiles). Un fichier 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 tuile 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’élévation 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 vers une structure de tuilage importée à 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 Manage Mode (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 Minimum Cached Scale (Échelle mise en cache minimale) et Maximum Cached Scale (Échelle mise en cache maximale) sont utilisées. La modification de la valeur du paramètre Minimum Cached Scale (Échelle mise en cache minimale) ou Maximum Cached Scale (É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 Minimum Cached Scale (Échelle mise en cache minimale) ou Maximum Cached Scale (É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és, ou d’un jeu d’entités que vous définissez interactivement. 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 en 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 une archive zip en tant que paquetage de tuiles pour les processus hors ligne. Le format de cache est Compact V2 et la structure de cache est stockée au format JSON. Décoché—Le contenu en 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 dérivée

Etiqueter	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

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`. Un fichier 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 tuile 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 vers une structure de tuilage importée à 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és, ou d’un jeu d’entités que vous définissez interactivement. 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 en 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 une archive zip en tant que paquetage de tuiles pour les processus hors ligne. 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 en 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 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 ManageTileCache (fenêtre Python)

Il s’agit d’un exemple Python d’utilisation de la fonction ManageTileCache.

import arcpy

arcpy.management.ManageTileCache(
      "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 ManageTileCache (script autonome)

Ceci est un exemple de script Python pour 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.management.ManageTileCache(
       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: If the Parallel Processing Factor value is empty (blank), the tool will run with a default value of 50 percent (one-half) of the available cores.

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

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

Résumé

Utilisation

Paramètres

Sortie dérivée

Environnements

Cas particuliers

Informations de licence

Rubriques connexes