Gérer le cache de tuiles (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 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ètreExplicationType 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.

  • RECREATE_ALL_TILESToutes 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_TILESSeules les tuiles vides sont créées. Les tuiles existantes restent en l'état.
  • DELETE_TILESLes 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 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.

  • ARCGISONLINE_SCHEMEUtilisez la structure de tuilage ArcGIS Online par défaut.
  • IMPORT_SCHEMEImportez une structure de tuilage existante.
  • ARCGISONLINE_ELEVATION_SCHEMEUtilisez cette structure de tuilage pour les services d'altitude.
  • WGS84_V2_SCHEMEUtilisez cette structure de tuilage basée sur WGS84 Version 2.
  • WGS84_V2_ELEVATION_SCHEME Utilisez cette structure de tuilage basée sur WGS84 Version 2 pour créer le 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; 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.

  • Par défaut, seules les échelles 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 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)

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

  • 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

  • Pour les niveaux dont les tailles de cellules sont inférieures ou égales au paramètre Taille maximale de la cellule source (max_cell_size), le cache est généré à partir de la source de données.
  • Pour les niveaux dont les tailles de cellules sont supérieures au paramètre Taille maximale de la cellule source (max_cell_size), le cache est généré à partir du niveau de cache précédent.

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

NomExplicationType 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

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

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