概要
タイル キャッシュを作成するか、既存のタイル キャッシュ内のタイルを更新します。このツールを使用して、新しいタイルの作成、欠落したタイルの補充、古くなったタイルの上書き、またはタイルの削除ができます。
使用法
[タイル キャッシュの管理 (Manage Tile Cache)] ツールを使用してタイル キャッシュを作成するとき、[対象地域 (AOI)] が定義されていない場合、キャッシュは、ソース ラスターまたはモザイク データセットの全範囲、またはマップ ファイルの現在の範囲を使用して作成されます。
生成されるキャッシュの範囲が [対象地域] より大きい場合があります。この場合、[タイル キャッシュの管理 (Manage Tile Cache)] ツールは、データをスーパータイルと呼ばれる大きな領域に分割してから、それを要求したサイズのタイルに分割します。[入力データ ソース] がアンチエイリアスを使用している場合、スーパータイルは 2,048 x 2,048 ピクセルです。それ以外の場合は 4,096 x 4,096 です。定義された [対象地域] のフィーチャがスーパータイルの境界と交差する場合、そのスーパータイル全体が作成されます。つまり、フィーチャクラスに基づくキャッシュを行って時間やディスク容量の節約効果を得るには、拡大表示する必要がある場合があります。対象地域が多く、[入力データ ソース] のほとんどをカバーしている場合、ほとんどのフィーチャがスーパータイルと交差するため、フィーチャクラスに基づくキャッシュの効果はあまり得られない可能性があります。
カスタム タイル スキーマ内にキャッシュを作成するには、ソース データセットのタイル スキーマを定義していることを確認してからこのツールを使用します。[タイル キャッシュのタイル スキーマの生成 (Generate Tile Cache Tiling Scheme)] ツールを使用してタイル スキーマを作成できます。
ArcGIS Online タイル スキーマにキャッシュを作成するには、[入力タイル スキーマ] パラメーターに [ArcGIS Online スキーマ]を指定 (Python では tiling_scheme を ARCGISONLINE_SCHEME に設定) します。
このツールは、広大な地理的範囲または非常に大きな縮尺をカバーするキャッシュを作成するために、実行に時間がかかることがあります。ツールがキャンセルされると、タイルの作成は停止しますが、既存のタイルは削除されません。このため、ツールはいつでもキャンセルでき、後で [管理モード] パラメーターに [空タイルを再作成] を指定 (Python では manage_mode を RECREATE_EMPTY_TILES に設定) して、同じキャッシュに対してツールを再実行すると、キャンセルした場所からツールの実行が継続されます。
このツールは、並列処理環境設定をサポートしています。
構文
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})| パラメーター | 説明 | データ タイプ |
in_cache_location | キャッシュ データセットが作成されるフォルダーまたは既存のタイル キャッシュへのパス。 | Folder; Raster Layer |
manage_mode | キャッシュを管理するためのモード。
| String |
in_cache_name (オプション) | キャッシュの格納先に作成されるキャッシュ データセットの名前。 | String |
in_datasource (オプション) | ラスター データセット、モザイク データセット、またはマップ ファイル。 DELETE_TILES パラメーターで manage_mode を指定した場合、このパラメーターは必要ありません。 マップ ファイル (*.mapx) には、マップ サービスまたはイメージ サービスを含めることはできません。 | Mosaic Layer; Raster Layer; Map |
tiling_scheme (オプション) | タイル スキーマを指定するオプション パラメーター。
| String |
import_tiling_scheme (オプション) | 既存のスキーマ ファイル (*.xml) へのパスを指定するか、インポート先の既存のイメージ サービスまたはマップ サービスを指定します。 | Image Service; MapServer; File |
scales [scale,...] (オプション) | このツールの実行時に、manage_mode パラメーターの値に応じてタイルを作成または削除する縮尺レベル。ピクセル サイズは、タイル スキーマの空間参照に基づいて表されます。
| Double |
area_of_interest (オプション) | 対象エリアを定義して、タイルを作成または削除する範囲を制限します。 フィーチャクラスを指定するか、対話的に定義するフィーチャを指定できます。 このパラメーターは、不規則な形状のエリアでタイルを管理する場合に便利です。一部のエリアだけを事前にキャッシュして、表示頻度の低いエリアをキャッシュしない場合にも有効です。 | Feature Set |
max_cell_size (オプション) | キャッシュが生成されるデータソースの表示設定を定義する値。デフォルトでは、この値は空です。 この値が空の場合、以下のように動作します。
この値が 0 よりも大きい場合、以下のように動作します。
[最大ソース セル サイズ] の値の単位は、ソース データセットのセル サイズの単位と同じである必要があります。 | Double |
min_cached_scale (オプション) | タイルを作成するときの最小縮尺です。これがタイル スキーマ内で最も小さい縮尺とは限りません。最小キャッシュ縮尺は、キャッシュの生成時に使用する縮尺を決定します。 | Double |
max_cached_scale (オプション) | タイルを作成するときの最大縮尺です。これがタイル スキーマ内で最も大きい縮尺とは限りません。最大キャッシュ縮尺は、キャッシュの生成時に使用する縮尺を決定します。 | Double |
派生した出力
| 名前 | 説明 | データ タイプ |
| out_cache_location | 出力キャッシュの場所に作成されたキャッシュ データセット。 | ラスター データセット |
コードのサンプル
以下は、ManageTileCache ツールを実行する Python サンプルです。
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")以下は、ManageTileCache ツールを実行する Python スクリプト サンプルです。
#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)ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい