概要
タイル キャッシュを作成するか、既存のタイル キャッシュ内のタイルを更新します。 このツールを使用して、タイルの作成、欠落したタイルの補充、古くなったタイルの上書き、またはタイルの削除ができます。
使用法
[入力データ ソース] パラメーター値をマップにすることはできますが、ドキュメントにマップ サービスまたはイメージ サービスを含めることはできません。
このツールを使用してタイル キャッシュを作成するとき、[対象地域 (AOI)] パラメーター値が指定されていない場合、キャッシュはラスターの全範囲またはマップ ドキュメントの現在の範囲を使用して作成されます。
生成されるキャッシュの範囲が [対象地域] パラメーター値より大きい場合があります。 この場合、ツールは、データをスーパータイルと呼ばれる大きな領域に分割してから、それを指定されたサイズのタイルに分割します。 [入力データ ソース] パラメーター値がアンチエイリアスを使用している場合、スーパータイルは 2,048 x 2,048 ピクセルです。それ以外の場合は 4,096 x 4,096 です。 指定された [対象地域] のフィーチャがスーパータイルの境界と交差する場合、そのスーパータイル全体が作成されます。 つまり、フィーチャクラスに基づくキャッシュを行って時間やディスク容量の節約効果を得るには、拡大表示する必要がある場合があります。 対象地域が複数あり、[入力データ ソース] パラメーター値のほとんどをカバーしている場合、ほとんどのフィーチャがスーパータイルと交差するため、フィーチャクラスに基づくキャッシュの効果はあまり得られない可能性があります。
カスタム タイル スキーマ内にキャッシュを作成するには、ソース データセットのタイル スキーマを定義していることを確認してからこのツールを使用します。 [タイル キャッシュのタイル スキーマの生成 (Generate Tile Cache Tiling Scheme)] ツールを使用してタイル スキーマを作成できます。
ArcGIS Online タイル スキーマにキャッシュを作成するには、[入力タイル スキーマ] パラメーターに対して ARCGISONLINE_SCHEME を指定します。
このツールは、広大な地理的範囲または非常に大きな縮尺をカバーするキャッシュを作成するために、実行に時間がかかることがあります。 ツールがキャンセルされると、タイルの作成は停止しますが、既存のタイルは削除されません。 このため、ツールはいつでもキャンセルでき、後で [管理モード] パラメーターに 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 (オプション) | ラスター データセット、モザイク データセット、またはマップ ドキュメント。 manage_mode パラメーターで DELETE_TILES を指定した場合、このパラメーターは必要ありません。 ArcMap ドキュメント (*.mxd) には、マップ サービスまたはイメージ サービスを含めることはできません。 | ArcMap Document; Mosaic Layer; Raster Layer |
tiling_scheme (オプション) | 使用するタイル スキーマを指定します。
| String |
import_tiling_scheme (オプション) | 既存のスキーマ ファイル (*.xml) 、または既存のイメージ サービスかマップ サービスからインポートされたタイル スキーマのパス。 | Image Service; Map Server; 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 | 出力キャッシュの場所に作成されるキャッシュ データセット。 | Raster Dataset |
コードのサンプル
ManageTileCache (タイル キャッシュの管理) の例 1 (Python ウィンドウ)
以下は、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 (タイル キャッシュの管理) の例 2 (スタンドアロン スクリプト)
以下は、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: はい