ヘルプ

マップ サービス キャッシュのエクスポート (Export Map Server Cache)

サマリー

マップまたはイメージ サービスのキャッシュから、タイルをキャッシュ データセットまたはタイル パッケージとしてディスク上のフォルダーにエクスポートします。タイルは、他のキャッシュにインポートするか、またはサービスから独立したラスター データセットとして ArcGIS for Desktop またはモバイル デバイスからアクセスすることができます。

使用法

  • このツールを実行する前に、タイルを格納するためのフォルダーをディスク上に作成します。

  • ArcGIS Server アカウントには、エクスポート先のキャッシュ フォルダーに対する書き込みアクセス権が必要です。ArcGIS Server アカウントにエクスポート先のキャッシュ フォルダーに対する書き込みアクセス権を付与できない場合、ArcGIS for Desktop クライアントにこのフォルダーへの書き込みアクセス権があるときは、[データをサーバーからコピー](copy_data_from_server) パラメーターを選択します。

  • 10.1 Service Pack 1 では、このツールに [タイルの上書き] パラメーターが追加され、画像をブレンドするのではなく、出力先のキャッシュ内のタイルをエクスポートされたタイルで完全に上書きできるようになりました。エクスポートされたタイルは、対象エリアに制限されます。

構文

ExportMapServerCache_server (input_service, target_cache_path, export_cache_type, copy_data_from_server, storage_format_type, scales, {num_of_caching_service_instances}, {area_of_interest}, {export_extent}, {overwrite})
パラメーター説明データ タイプ
input_service

エクスポートするキャッシュ タイルを含むマップまたはイメージ サービス。

これは、サーバーとサービスの両方の情報を含む文字列です。この文字列の構築方法を確認するには、ArcCatalog を開き、カタログ ツリーでサービスを選択して、[場所] ツールバーに表示されているテキストを記録します。バックスラッシュをスラッシュに変更します (たとえば、GIS Servers/arcgis on MYSERVER (admin)/USA.MapServer)。

String
target_cache_path

キャッシュのエクスポート先のフォルダー。このフォルダーは、登録済みサーバー キャッシュ ディレクトリである必要はありません。ArcGIS Server アカウントには、エクスポート先のキャッシュ フォルダーに対する書き込みアクセス権が必要です。サーバー アカウントにエクスポート先のフォルダーに対する書き込みアクセス権を付与できないときに、ArcGIS for Desktop クライアントにこのフォルダーへの書き込みアクセス権がある場合は、[データをサーバーからコピー] パラメーターを選択します。

Folder
export_cache_type

キャッシュをキャッシュ データセットとしてエクスポートするか、タイル パッケージとしてエクスポートするかを選択します。ArcGIS Runtime および ArcGIS Mobile の配置では、タイル パッケージが適しています。

  • CACHE_DATASET —ArcGIS Server を使用して生成されるマップまたはイメージ サービス キャッシュ。ArcMap と、ArcGIS Server のマップまたはイメージ サービスで使用されます。これがデフォルトです。
  • TILE_PACKAGE —キャッシュ データセットがレイヤーとして追加され、簡単に共有できるように統合された単一の圧縮ファイル。ArcGIS for Desktop や、ArcGIS Runtime およびモバイル アプリケーションで使用できます。
String
copy_data_from_server

ArcGIS Server アカウントにエクスポート先フォルダーに対する書き込みアクセス権を付与できないときに、ArcGIS for Desktop クライアントにこのフォルダーへの書き込みアクセス権がある場合のみ、COPY_DATA に対するこのオプションをオンにします。ソフトウェアは、タイルをエクスポート先のフォルダーに移動する前に、サーバーの出力ディレクトリにエクスポートします。

  • COPY_DATA —タイルはサーバーの出力ディレクトリに配置された後、エクスポート先のフォルダーに移動されます。ArcGIS for Desktop クライアントには、エクスポート先のフォルダーに対する書き込みアクセス権が必要です。
  • DO_NOT_COPY —タイルは直接エクスポート先のフォルダーにエクスポートされます。ArcGIS Server アカウントには、エクスポート先のフォルダーに対する書き込みアクセス権が必要です。これがデフォルトです。
Boolean
storage_format_type

エクスポートしたキャッシュの格納形式。

  • COMPACT —タイルは、ディスク領域の節約とキャッシュのコピーの高速化を可能にするために、バンドル ファイルにグループ化されます。[エクスポートするキャッシュのタイプ](Python では export_cache_type) がタイル パッケージの場合は、これがデフォルトです。
  • EXPLODED —各タイルは、個別のファイルとして格納されます (ArcGIS Server 10 よりも前のバージョンでのキャッシュの格納方法のように)。
String
scales
[scales,...]

タイルのエクスポート先の縮尺レベルのリスト。

Double
num_of_caching_service_instances
(オプション)

このツールの実行に専用で使用する、システム/CachingTools サービスのインスタンス数の合計。ArcGIS Server への管理者接続を通して使用できる [サービス エディター] ウィンドウで、システム/CachingTools サービスの [コンピューターごとのインスタンスの最大数] の値を大きく変更することができます。選択したインスタンス数を、サーバー コンピューターでサポートできることを確認してください。

Long
area_of_interest
(オプション)

キャッシュからタイルをエクスポートする範囲を空間的に制限する対象エリア (ポリゴン)。フィーチャクラスを指定するか、ArcMap で対話的に定義するフィーチャを指定できます。このパラメーターは不規則な形状のエリアをエクスポートする場合に有効です。ツールはキャッシュ データセットをピクセル解像度でクリップします。

対象エリアを指定しない場合、マップ全体がエクスポートされます。

Feature Set
export_extent
(オプション)

エクスポートするタイルを定義する矩形の表示範囲。デフォルトでは、表示範囲は、インポートするマップ サービスの全体表示に設定されます。このツールのオプション パラメーターの [対象地域] を使用すると、矩形の代わりにポリゴンを使用してインポートを行えます。1 つのジョブに対して両方のパラメーターを同時に指定しないようにすることをお勧めします。両方のパラメーターを指定した場合は、[対象地域] パラメーターが [インポート範囲] よりも優先されます。

Extent
overwrite
(オプション)
  • OVERWRITE —エクスポートにより、対象エリアのすべてのピクセルが置き換えられます。エクスポート先のキャッシュ内にあるタイルを、作成されたキャッシュのタイルで完全に上書きします。
  • MERGE (マージする) —タイルのインポート時に、作成されたキャッシュ内の透明なピクセルはデフォルトで無視されます。この結果、エクスポート先のキャッシュはマージまたはブレンドされます。これがデフォルトです。
Boolean

コードのサンプル

ExportMapServerCache (マップ サービス キャッシュのエクスポート) の例 1格納形式をエクスプロードからコンパクトに変更して、フィーチャクラスのキャッシュ タイルをエクスポートします。

# Name: ExportMapServerCache.py for ArcGIS Server 
# Description: The following stand-alone script demonstrates how to export 
# cache as CACHE_DATASET in COMPACT storage format and MERGE tiles using
# an AREA_OF_INTEREST to TARGET_CACHE_PATH which is accessible to server
# instances 

# 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
targetCachePath 	= "C:/data/temp"
exportCacheType 	= "CACHE_DATASET"
copyDataFromServer 	= "DO_NOT_COPY"
storageFormat 		= "COMPACT"
scales 			= [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
areaOfInterest 		= "C:/data/101/Portland/Metro.shp"
exportExtents 		= ""
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 "scaleValues[0]","scaleValues[-1]","scaleValues[0:3]"

# Enter rectangular custom extent values for the "exportExtents" variable to
# constrain the exporting cache along the rectangular extents

try:
    starttime = time.clock()
    result = arcpy.ExportMapServerCache_server(inputService, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales, 
                                               numOfCachingServiceInstances, 
                                               areaOfInterest, exportExtents, 
					       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 "Exported cache successfully for mapservice " + serviceName +\
    " to " + targetCachePath + "\n using " + areaOfInterest + "\n in " +\
    str(elapsedtime) + " sec \n on " + arg2
    
except Exception, e:
    # If an error occurred, print line number and error message
    tb = sys.exc_info()[2]
    report.write("Failed at \n" "Line %i" % tb.tb_lineno)
    report.write(e.message)

print "Exported Map server Cache  using area of Interest"

report.close()

ExportMapServerCache (マップ サービス キャッシュのエクスポート) の例 2ArcGIS Server インスタンスからエクスポート先のフォルダーにアクセスできない場合に、キャッシュを TILE_PACKAGE としてエクスポートします。

# Name: ExportMapServerCache.py
# Description: The following stand-alone script demonstrates how to export cache
# as TILE_PACKAGE for default number of scales of a service, to a 
# TARGET_CACHE_PATH which is inaccessible to server instances using
# COPY_DATA_FROM_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
targetCachePath = "C:/temp/usa"
exportCacheType = "TILE_PACKAGE"
copyDataFromServer = "COPY_DATA"
storageFormat = "COMPACT"
scaleValues = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
exportExtents = ""
areaOfInterest = ""
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 "scaleValues[0]","scaleValues[-1]","scaleValues[0:3]"

try:
    starttime = time.clock()
    result = arcpy.ExportMapServerCache_server(inputService, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest,
                                               exportExtents, 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 "Exported cache successfully for mapservice " + serviceName +\
    + " to " + targetCachePath + " in " + str(elapsedtime) + " sec \n 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 "Exported Map server Cache "

report.close()

環境

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

ライセンス情報

  • ArcGIS Desktop Basic: はい
  • ArcGIS Desktop Standard: はい
  • ArcGIS Desktop Advanced: はい

関連トピック