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

サマリー

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

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

使用法

このツールを使用して、キャッシュのすべてまたは一部をフォルダー間でインポートします。
[タイルの上書き] パラメーターにより、画像をブレンドするのではなく、インポートされたタイルで既存のタイルを完全に上書きできるようになりました。インポートされたタイルは、対象エリアに制限されます。

パラメーター

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

派生した出力

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

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)。このパラメーターには、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 の例 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
# 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

サマリー

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容