マップ サービス キャッシュのインポート (Import Map Server Cache) (サーバー)

サマリー

マップ イメージ レイヤーのキャッシュに、ディスク上のフォルダーからタイルをインポートします。

ソース フォルダーには、登録済みサーバー キャッシュ ディレクトリの子、以前にキャッシュをエクスポートしたフォルダー、またはタイル パッケージ (*.tpk) を指定できます。ターゲット サービスのタイル スキーマと格納形式は、ソース キャッシュと同じである必要があります。

使用法

• このツールを使用して、キャッシュのすべてまたは一部をフォルダー間でインポートします。

• [タイルの上書き] パラメーターにより、画像をブレンドするのではなく、インポートされたタイルで既存のタイルを完全に上書きできるようになりました。 インポートされたタイルは、対象エリアに制限されます。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力サービス	インポートするキャッシュ タイルを含むマップ イメージ レイヤー。 ポータルで必要なサービスを参照してこれを選択できます。または、[プロジェクト] ウィンドウの [ポータル] タブから Web タイル レイヤーをドラッグして、このパラメーターを指定することもできます。	Image Service; Map Server
ソース キャッシュ タイプ	サーバーで実行中のキャッシュされたマップまたはイメージ サービスに、キャッシュ データセットまたはタイル パッケージからキャッシュをインポートします。 マップまたはイメージ サービス キャッシュ—ArcGIS Server を使用して生成されるマップまたはイメージ サービス キャッシュ。 これは、ArcGIS Desktop と、ArcGIS Server のマップまたはイメージ サービスで使用できます。 タイル パッケージ—キャッシュ データセットがレイヤーとして追加され、共有できるように統合された単一の圧縮ファイル。 これは、ArcGIS Desktop、ArcGIS Runtime、およびモバイル アプリで使用できます。	String
ソースとなるキャッシュ データセット (オプション)	インポートするタイルへのパス。 参照時にはラスター データセット アイコンで表されます。 登録済みのサーバー キャッシュ ディレクトリを指定する必要はありません。ほとんどの場合は、以前にタイルをエクスポートしたディスク上の場所を指定します。 このパラメーターには、ArcGIS Server アカウントがアクセスできる場所を指定します。 この場所へのアクセス権を ArcGIS Server アカウントに付与できない場合は、[データをサーバーへアップロード] パラメーターをオンにします。	Raster Dataset
ソースとなるタイル パッケージ (オプション)	インポートするタイル パッケージのパス。 このパラメーターには、ArcGIS Server アカウントがアクセスできる場所を指定します。 タイル パッケージ ファイルをキャッシュされたマップまたはイメージ サービスにインポートすると、[データをサーバーへアップロード] パラメーターが自動的に有効になります。	File
データをサーバーへアップロード (オプション)	ArcGIS Server アカウントにソース キャッシュに対する読み取りアクセス権がない場合は、このパラメーターをオンにします。 キャッシュが ArcGIS Server のキャッシュ ディレクトリに移動される前に、ソース キャッシュが ArcGIS Server のアップロード ディレクトリにアップロードされます。 オン - タイルはサーバーのアップロード ディレクトリに配置された後、サーバーのキャッシュ ディレクトリに移動されます。 [ソース キャッシュ タイプ] パラメーターが [TILE_PACKAGE] に設定されている場合は、デフォルトでこの設定が有効になります。 オフ - タイルは直接、サーバーのキャッシュ ディレクトリにインポートされます。 ArcGIS Server アカウントには、ソース キャッシュに対する読み取りアクセス権が必要です。	Boolean
縮尺 (オプション)	タイルをインポートする縮尺レベルのリスト。 デフォルトでは、ツール ダイアログ ボックスのリストには、サービスの最小と最大のキャッシュ縮尺の間にある縮尺が表示されます。 縮尺の範囲を更新するには、[サービス エディター] > [キャッシュ] タブの順に移動し、スライダーを使用して最小と最大のキャッシュ縮尺を更新します。	Double
キャッシュ サービスのインスタンス数 (オプション)	タイルの更新または生成に使用するインスタンスの数を指定します。 このパラメーターの値は無制限 (-1) に設定され、変更できません。	Long
対象地域 (オプション)	タイルをキャッシュにインポートする範囲を空間的に制限する対象エリアのポリゴン。 このパラメーターは、不規則な形状のエリアにタイルをインポートする場合に便利です。ツールはピクセル解像度でポリゴンと交差するキャッシュ データセットをクリップし、その結果をサービス キャッシュ ディレクトリにインポートします。 このパラメーターに値を指定しない場合は、[インポート範囲] パラメーターの値が使用されます。 デフォルトでは、マップの全範囲が使用されます。	Feature Set
インポート範囲 (オプション)	キャッシュにインポートするタイルを定義する矩形の範囲。 デフォルトでは、表示範囲は、インポートするマップ サービスの全体表示に設定されます。 このツールのオプション パラメーターの [対象地域] を使用すると、不規則な形状を使用してインポート対象のタイルを空間的に制限できます。 両方のパラメーターを指定した場合は、[対象地域] パラメーターが [インポート範囲] よりも優先されます。 [現在の表示範囲] - 範囲は、アクティブなマップまたはシーンに基づきます。 このオプションは、アクティブなマップが存在する場合にのみ使用できます。 [範囲の描画] - 範囲は、マップまたはシーンに描画された四角形に基づきます。 このオプションは、プロジェクト ジオデータベースにフィーチャクラスを作成し、レイヤーをマップに追加します。 フィーチャクラスの座標系はマップと同じです。 注意: このオプションは、[環境] ダイアログ ボックスでは使用できません。 範囲データ タイプを使用するツール パラメーターまたはツール ダイアログ ボックスの [環境] タブからのみ使用できます。 注意: 編集タブで編集を有効/無効にする編集オプションがオンの場合、範囲を描画するには [編集] リボン タブで編集を有効化する必要があります。 [レイヤーの範囲] - 範囲は、アクティブなマップ レイヤーに基づきます。 ドロップダウン リストを使用して使用可能なレイヤーを選択するか、[すべてのレイヤーのデータの範囲] オプションを使用して、ベースマップを除くすべてのアクティブなマップ レイヤーを組み合わせた範囲を取得します。 このオプションは、レイヤーを含むアクティブなマップが存在する場合にのみ使用できます。 各マップ レイヤーには、次のオプションがあります。 [すべてのフィーチャ] - レイヤーのすべてのフィーチャの範囲。 [選択フィーチャ] - レイヤーの選択フィーチャの範囲。 [表示フィーチャ] - レイヤーの表示フィーチャの範囲。 注意: [選択フィーチャ] と [表示フィーチャ] オプションの範囲は、フィーチャ レイヤーでのみ使用できます。 [参照] - 範囲は、既存のデータに基づきます。 [クリップボード] - 範囲をクリップボードにコピーしたり、クリップボードから貼り付けたりできます。 [範囲をコピー] - 範囲の座標と座標系をクリップボードにコピーします。 [範囲を貼り付け] - 範囲の座標と、必要に応じて座標系をクリップボードから貼り付けます。 クリップボードの値に座標系が含まれていない場合、マップの座標系が範囲に使用されます。 注意: 範囲の座標は、ArcPy Extent オブジェクトと同じ書式と順序 (x-min、y-min、x-max、y-max、空間参照) を使用して、クリップボードからコピーおよびクリップボードから貼り付けられます。 [範囲をリセット] - 範囲はデフォルト値にリセットされます。 手動入力した座標値 - 座標値は数値であり、アクティブなマップの座標系で表示する必要があります。 注意: マップで、入力された座標と異なる表示単位が使用されることがあります。 基本方向 (N、S、E、W) を使用することはできません。 南と西の座標にはマイナス値の記号を使用します。	Extent
タイルの上書き (オプション)	インポート先のキャッシュ内にある画像を、作成されたキャッシュのタイルとマージするか、タイルで上書きするかを指定します。 オン - インポートにより、対象エリアのすべてのピクセルが置き換えられます。インポート先のキャッシュ内にあるタイルを、作成されたキャッシュのタイルで完全に上書きします。 オフ - タイルのインポート時に、作成されたキャッシュ内の透明なピクセルはデフォルトで無視されます。 この結果、エクスポート先のキャッシュはマージまたはブレンドされます。 これがデフォルトです。	Boolean

派生した出力

ラベル	説明	データ タイプ
出力マップ サービス URL	出力 URL。	String

Python

arcpy.server.ImportMapServerCache(input_service, source_cache_type, {source_cache_dataset}, {source_tile_package}, {upload_data_to_server}, {scales}, {num_of_caching_service_instances}, {area_of_interest}, {import_extent}, {overwrite})

名前	説明	データ タイプ
input_service	インポートするキャッシュ タイルを含むマップ イメージ レイヤー。	Image Service; Map Server
source_cache_type	サーバーで実行中のキャッシュされたマップまたはイメージ サービスに、キャッシュ データセットまたはタイル パッケージからキャッシュをインポートします。 CACHE_DATASET—ArcGIS Server を使用して生成されるマップまたはイメージ サービス キャッシュ。 これは、ArcGIS Desktop と、ArcGIS Server のマップまたはイメージ サービスで使用できます。 TILE_PACKAGE—キャッシュ データセットがレイヤーとして追加され、共有できるように統合された単一の圧縮ファイル。 これは、ArcGIS Desktop、ArcGIS Runtime、およびモバイル アプリで使用できます。	String
source_cache_dataset (オプション)	データ フレーム名に一致するキャッシュ フォルダーのパス。 登録済みのサーバー キャッシュ ディレクトリを指定する必要はありません。ほとんどの場合は、以前にタイルをエクスポートしたディスク上の場所を指定します。 このパラメーターには、ArcGIS Server アカウントがアクセスできる場所を指定します。 この場所へのアクセス権を ArcGIS Server アカウントに付与できない場合は、upload_data_to_server パラメーターを UPLOAD_DATA に設定します。	Raster Dataset
source_tile_package (オプション)	インポートするタイル パッケージのパス (*.tpk)。 このパラメーターには、ArcGIS Server アカウントがアクセスできる場所を指定します。 タイル パッケージ ファイルをキャッシュされたマップまたはイメージ サービスにインポートする場合、upload_data_to_server パラメーターは無視され、自動的に UPLOAD_DATA に設定されます。	File
upload_data_to_server (オプション)	ArcGIS Server アカウントにソース キャッシュに対する読み取りアクセス権がない場合は、このパラメーターを UPLOAD_DATA に設定します。 キャッシュが ArcGIS Server のキャッシュ ディレクトリに移動される前に、ソース キャッシュが ArcGIS Server のアップロード ディレクトリにアップロードされます。 UPLOAD_DATA—タイルはサーバーのアップロード ディレクトリに配置された後、サーバーのキャッシュ ディレクトリに移動されます。 source_cache_type が TILE_PACKAGE に設定されている場合は、デフォルトでこの設定が有効になります。 DO_NOT_UPLOAD—タイルは直接、サーバーのキャッシュ ディレクトリにインポートされます。 ArcGIS Server アカウントには、ソース キャッシュに対する読み取りアクセス権が必要です。	Boolean
scales [scales,...] (オプション)	タイルをインポートする縮尺レベルのリスト。	Double
num_of_caching_service_instances (オプション)	タイルの更新または生成に使用するインスタンスの数を指定します。 このパラメーターの値は無制限 (-1) に設定され、変更できません。	Long
area_of_interest (オプション)	タイルをキャッシュにインポートする範囲を空間的に制限する対象エリアのポリゴン。 このパラメーターは、不規則な形状のエリアにタイルをインポートする場合に便利です。ツールはピクセル解像度でポリゴンと交差するキャッシュ データセットをクリップし、その結果をサービス キャッシュ ディレクトリにインポートします。 このパラメーターに値を指定しない場合は、[インポート範囲] パラメーターの値が使用されます。 デフォルトでは、マップの全範囲が使用されます。	Feature Set
import_extent (オプション)	キャッシュにインポートするタイルを定義する矩形の範囲。 デフォルトでは、表示範囲は、インポートするマップ サービスの全体表示に設定されます。 このツールのオプション パラメーターの [対象地域] を使用すると、不規則な形状を使用してインポート対象のタイルを空間的に制限できます。 両方のパラメーターを指定した場合は、[対象地域] パラメーターが [インポート範囲] よりも優先されます。 MAXOF - すべての入力データの最大範囲が使用されます。 MINOF - すべての入力データに共通する最小領域が使用されます。 DISPLAY - 範囲は、表示範囲と同じになります。 レイヤー名 - 指定したレイヤーの範囲が使用されます。 Extent オブジェクト - 指定したオブジェクトの範囲が使用されます。 座標のスペース区切りの文字列 - 指定した文字列の範囲が使用されます。 座標は、x-min、y-min、x-max、y-max の順序で表されます。	Extent
overwrite (オプション)	インポート先のキャッシュ内にある画像を、作成されたキャッシュのタイルとマージするか、タイルで上書きするかを指定します。 OVERWRITE—インポートにより、対象エリアのすべてのピクセルが置き換えられます。インポート先のキャッシュ内にあるタイルを、作成されたキャッシュのタイルで完全に上書きします。 MERGE—タイルのインポート時に、作成されたキャッシュ内の透明なピクセルはデフォルトで無視されます。 この結果、エクスポート先のキャッシュはマージまたはブレンドされます。 これがデフォルトです。	Boolean

派生した出力

名前	説明	データ タイプ
out_job_url	出力 URL。	String

コードのサンプル

ImportMapServerCache (マップ サーバー キャッシュのインポート) の例 1 (スタンドアロン スクリプト)

デフォルトの縮尺数でキャッシュ データセットをキャッシュされたサービスにインポートします。 インポート先のキャッシュ内にあるタイルは、インポートされるタイルによって上書きされます。

# Name: ImportMapServerCache.py
# Description: The following stand-alone script demonstrates how to import map
#               server cache from a source directory with CACHE_DATASET and
#               OVERWRITE existing cache on the service for the number
#               of scales specified without Uploading data to server
# Requirements: os, sys, time and traceback modules

# Any line that begins with a pound sign is a comment and will not be executed
# Empty quotes take the default value.
# To accept arguments from the command line replace values of variables to
#                                                           "sys.argv[]"

# Import system modules
import arcpy
from arcpy import env
import os, sys, time, datetime, traceback, string

# Set environment settings
env.workspace = "C:/data"

# List of input variables for map service properties
connectionFile      = r"C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.1\ArcCatalog"
server              = "arcgis on MyServer_6080 (publisher)"
serviceName         = "Rainfall.MapServer"
inputService        = connectionFile + "\\" + server + "\\" + serviceName
sourceCacheType     = "CACHE_DATASET"
sourceCacheDataset  = "C:/data/destination_folder/Layers"
sourceTilePackage   = ""
uploadDataToServer  = "DO_NOT_UPLOAD"
scales              = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
areaOfInterest      = ""
importExtents       = ""
overwriteTiles      = "OVERWRITE"

currentTime         = datetime.datetime.now()
arg1                = currentTime.strftime("%H-%M")
arg2                = currentTime.strftime("%Y-%m-%d %H:%M")
file                = 'C:/data/report_%s.txt' % arg1

# print results of the script to a report
report      = open(file,'w')

# use "scales[0]","scales[-1]","scales[0:3]"

try:
    starttime = time.clock()
    result = arcpy.server.ImportMapServerCache(inputService, sourceCacheType,
                                               sourceCacheDataset,
                                               sourceTilePackage,
                                               uploadDataToServer, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest, importExtents,
                                               overwriteTiles)
    finishtime = time.clock()
    elapsedtime = finishtime - starttime

    #print messages to a file
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print("Imported Map server Cache Tiles successfully for" + serviceName + \
        " from" + sourceCacheDataset + "\n in " + str(elapsedtime)+ "sec on " + arg2)

except Exception as e:
    # If an error occurred, print line number and error message
    tb = sys.exc_info()[2]
    report.write("Failed at step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(str(e))

print("Imported Map server Cache Tiles ")

report.close()

ImportMapServerCache (マップ サーバー キャッシュのインポート) の例 1 (スタンドアロン スクリプト)

対象エリアのキャッシュ タイルをタイル パッケージからキャッシュ サービスにインポートします。

# Name: ImportMapServerCache.py
# Description: The following stand-alone script demonstrates how to import map
#               server cache from a source directory with Tile Package to an existing service for
#               the default number of scales specified using an AOI by uploading data to remote server
# To Import cache tiles for the scales specified for given feature class

# Requirements: os, sys, time and traceback modules
# Author: ESRI

# Any line that begins with a pound sign is a comment and will not be executed
# Empty quotes take the default value.
# To accept arguments from the command line replace values of variables to
#                                                           "sys.argv[]"

# Import system modules
import arcpy
from arcpy import env
import os, sys, time, datetime, traceback, string

# Set environment settings
env.workspace = "C:/data"

# List of input variables for map service properties
connectionFile = r"C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.1\ArcCatalog"
server = "arcgis on MyServer_6080 (publisher)"
serviceName = "Rainfall.MapServer"
inputService = connectionFile + "\\" + server + "\\" + serviceName
sourceCacheType = "TILE_PACKAGE"
sourceCacheDataset = ""
sourceTilePackage = "C:\\data\\destination_folder\\TPK\\Rainfall.tpk"
uploadDataToServer = "UPLOAD_DATA"
scales = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
cacheDir = "c:\\arcgisserver\\arcgiscache"
areaOfInterest = "C:/data/101/Portland/Portland_Metro.shp"
importExtents = ""
overwriteTiles = "MERGE"

currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = 'C:/data/report_%s.txt' % arg1

# print results of the script to a report
report = open(file,'w')

# use "scales[0]","scales[-1]","scales[0:3]"

try:
    starttime = time.clock()
    result = arcpy.server.ImportMapServerCache(inputService, sourceCacheType,
                                               sourceCacheDataset,
                                               sourceTilePackage,
                                               uploadDataToServer, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest, importExtents,
					       overwriteTiles)
    finishtime = time.clock()
    elapsedtime = finishtime - starttime
    #print messages to a file
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print("Imported Map server Cache Tiles successfully for " + serviceName + \
        " from " + sourceTilePackage + " to " + cacheDir + "\n using "+ areaOfInterest + \
        " in " + str(elapsedtime) + " sec \n on  " + arg2)

except Exception as e:
    # If an error occurred, print line number and error message
    tb = sys.exc_info()[2]
    report.write("Failed at step 2 \n" "Line %i" % tb.tb_lineno)
    report.write(str(e))

report.close()

print("Imported Map server Cache Tiles for the given feature class")

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

• Basic: Yes
• Standard: Yes
• Advanced: Yes