概要
マップまたはイメージ サービスのキャッシュに、ディスク上のフォルダーからタイルをインポートします。
ソース フォルダーには、登録済みサーバー キャッシュ ディレクトリの子、以前にキャッシュをエクスポートしたフォルダー、またはタイル パッケージ (*.tpk) を指定できます。ターゲット サービスのタイル スキーマと格納形式は、ソース キャッシュと同じである必要があります。
使用法
このツールを使用して、キャッシュのすべてまたは一部をフォルダー間でインポートします。
[タイルの上書き] パラメーターにより、画像をブレンドするのではなく、インポートされたタイルで既存のタイルを完全に上書きできるようになりました。インポートされたタイルは、対象エリアに制限されます。
10.1 Service Pack 1 では、このツールにこのパラメーターが追加されました。
構文
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 | タイルのインポート先となるマップまたはイメージ サービス。 これは、サーバーとサービスの両方の情報を含む文字列です。 この文字列の構築方法を確認するには、ArcCatalog を開き、[カタログ] ツリーでサービスを選択して、[場所] ツールバーに表示されているテキストを記録します。 バックスラッシュをスラッシュ (たとえば、GIS Servers/arcgis on MYSERVER (admin)/USA.MapServer) に変更します。 | Image Service; MapServer |
source_cache_type | サーバーで実行中のキャッシュされたマップまたはイメージ サービスに、キャッシュ データセットまたはタイル パッケージからキャッシュをインポートします。
| 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 のアップロード ディレクトリにアップロードされます。
| Boolean |
scales [scales,...] (オプション) | タイルをインポートする縮尺レベルのリスト。 | Double |
num_of_caching_service_instances (オプション) | このツールの実行に専用で使用する、System/CachingTools サービスのインスタンス数の合計。 ArcGIS Server への管理者接続を通して使用できる [サービス エディター] ウィンドウで、System/CachingTools サービスの [コンピューターごとのインスタンスの最大数] 設定の値を大きく変更することができます。 選択したインスタンス数を、サーバー コンピューターでサポートできることを確認してください。 | Long |
area_of_interest (オプション) | タイルをキャッシュにインポートする範囲を空間的に制限する対象エリアのポリゴン。このパラメーターは、不規則な形状のエリアにタイルをインポートする場合に便利です。ツールはピクセル解像度でポリゴンと交差するキャッシュ データセットをクリップし、その結果をサービス キャッシュ ディレクトリにインポートします。 このパラメーターに値を指定しない場合は、[インポート範囲] パラメーターの値が使用されます。デフォルトでは、マップの全範囲が使用されます。 | Feature Set |
import_extent (オプション) | キャッシュにインポートするタイルを定義する矩形の範囲。デフォルトでは、表示範囲は、インポートするマップ サービスの全体表示に設定されます。このツールのオプション パラメーターの [対象地域] を使用すると、不規則な形状を使用してインポート対象のタイルを空間的に制限できます。両方のパラメーターを指定した場合は、[対象地域] パラメーターが [インポート範囲] よりも優先されます。 | Extent |
overwrite (オプション) | インポート先のキャッシュ内にある画像を、作成されたキャッシュのタイルとマージするか、タイルで上書きするかを指定します。
| 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.ImportMapServerCache_server(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 + " in " + str(elapsedtime)+ "sec on " + arg2
except Exception, 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(e.message)
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
# 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.ImportMapServerCache_server(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 + " using " +\
areaOfInterest + " in " + str(elapsedtime) + " sec on " + arg2
except Exception, 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(e.message)
report.close()
print "Imported Map server Cache Tiles for the given feature class"
環境
このツールは、ジオプロセシング環境を使用しません。
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい