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 Pro および ArcGIS Maps SDKs for Native Apps で使用できます。
|
String
|
|
source_cache_dataset
(オプション)
|
データ フレーム名に一致するキャッシュ フォルダーのパス。 登録済みのサーバー キャッシュ ディレクトリを指定する必要はありません。通常は、以前にタイルをエクスポートしたディスク上の場所を指定します。 この場所は、ArcGIS Server アカウントがアクセス可能な必要があります。 この場所へのアクセス権を ArcGIS Server アカウントに付与できない場合は、upload_data_to_server パラメーターを UPLOAD_DATA に設定します。
|
Raster Dataset
|
|
source_tile_package
(オプション)
|
インポートするタイル パッケージ (.tpk または .tpkx) のパス。 この場所は、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
(オプション)
|
タイルをキャッシュにインポートする範囲を空間的に制限する対象エリアのポリゴン。 このパラメーターは、不規則な形状のエリアにタイルをインポートする場合に便利です。ツールはピクセル解像度でポリゴンと交差するキャッシュ データセットをクリップし、その結果をサービス キャッシュ ディレクトリにインポートします。
このパラメーターに値を指定しない場合は、import_extent パラメーター値が使用されます。 デフォルトでは、マップの全範囲が使用されます。
|
Feature Set
|
|
import_extent
(オプション)
|
キャッシュにインポートするタイルを定義する矩形の範囲。 デフォルトでは、表示範囲は、インポートするマップ サービスの全体表示に設定されます。 オプションの 対象エリア パラメーターを使用すると、不規則な形状を使用してインポート対象のタイルを空間的に制限できます。 両方のパラメーターに値を指定した場合は、対象エリア パラメーター値が使用されます。
キャッシュにインポートするタイルを定義する矩形の範囲。 デフォルトでは、表示範囲は、インポートするマップ サービスの全体表示に設定されます。 オプションの area_of_interest パラメーターを使用すると、不規則な形状を使用してインポート対象のタイルを空間的に制限できます。 両方のパラメーターに値を指定した場合は、area_of_interest パラメーター値が使用されます。
MAXOF - すべての入力データの最大範囲が使用されます。
MINOF - すべての入力データに共通する最小領域が使用されます。
DISPLAY - 範囲は、表示範囲と同じになります。
レイヤー名 - 指定されたレイヤーの範囲が使用されます。
Extent オブジェクト - 指定されたオブジェクトの範囲が使用されます。
スぺース区切りの座標文字列 - 指定された文字列の範囲が使用されます。 座標値は、x-min、y-min、x-max、y-max という順序で表記されます。
|
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 run
# 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 sys
import time
import datetime
# 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 の例 2 (スタンドアロン スクリプト)
対象エリアのキャッシュ タイルをタイル パッケージからキャッシュ サービスにインポートします。
# 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 run
# 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 sys
import time
import datetime
# 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")
- 範囲は、アクティブなマップまたはシーンに基づきます。
- 範囲は、マップまたはシーンに描画された四角形に基づきます。
- 範囲は、アクティブなマップ レイヤーに基づきます。 使用可能なレイヤーを選択するか、すべてのレイヤーのデータの範囲 オプションを使用します。 各マップ レイヤーには、次のオプションがあります。
- レイヤーのすべてのフィーチャの範囲。
- 選択したフィーチャの範囲を使用します。
- レイヤーの表示フィーチャの範囲。
- 範囲は、既存のデータセットに基づきます。
- 範囲をクリップボードにコピーしたり、クリップボードから貼り付けたりできます。
- 範囲の座標と座標系をクリップボードにコピーします。
- 範囲はデフォルト値にリセットされます。