トップへ戻る

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

このトピックの内容

  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報

サマリー

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

使用法

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

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

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

パラメーター

ダイアログPython

ラベル説明データ タイプ
入力サービス

エクスポートするキャッシュ タイルを含むマップ イメージ レイヤー。 ポータルでサービスを参照してこれを選択できます。または、[プロジェクト] ウィンドウの [ポータル] タブから Web タイル レイヤーをドラッグして、このパラメーターを指定することもできます。

Image Service; Map Server
ターゲット キャッシュ パス

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

Folder
エクスポートするキャッシュのタイプ

エクスポートするキャッシュのタイプを指定します。 ArcGIS Maps SDKs for Native Apps で使用するには、タイル パッケージが適しています。

  • キャッシュ データセット—ArcGIS Server を使用して生成されたマップまたはイメージ サービス キャッシュがエクスポートされます。 これは、ArcGIS Desktop と、ArcGIS Server のマップまたはイメージ サービスで使用できます。 これがデフォルトです。
  • タイル パッケージ—キャッシュ データセットがレイヤーとして追加され、共有できるように統合された単一の圧縮ファイルがエクスポートされます。 これは ArcGIS Pro および ArcGIS Maps SDKs for Native Apps で使用できます。
String
データをサーバーからコピー

タイルをエクスポート先のフォルダーに移動する方法を指定します。

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

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

エクスポートされたキャッシュに使用される格納形式を指定します。

  • コンパクト—タイルは、ディスク領域の節約とキャッシュのコピーの高速化を可能にするために、bundle および bundlex ファイルにグループ化されます。 [エクスポートするキャッシュのタイプ] パラメーターが [タイル パッケージ] に設定されている場合は、これがデフォルトです。
  • コンパクト V2—タイルはバンドル ファイルのみにグループ化されます。 この形式は、ネットワーク共有とクラウド ストア ディレクトリのパフォーマンスを向上させます。 [エクスポートするキャッシュのタイプ] パラメーターが [タイル パッケージ] に設定されている場合、タイル パッケージの拡張子は (.tpkx) になります。これは、ArcGIS Online、ArcGIS Enterprise 11.4、ArcGIS Maps SDKs for Native Apps 200.0 以降、ArcGIS Runtime 100.5-100.15 などの新しいバージョンの ArcGIS 製品でサポートされています。
  • エクスプロード—各タイルは、個別のファイルとして格納されます。
String
縮尺

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

Double
キャッシュ サービスのインスタンス数
(オプション)

タイルの更新または生成に使用するインスタンスの数を指定します。 このパラメーターの値は無制限 (-1) に設定され、変更できません。

Long
対象エリア
(オプション)

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

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

Feature Set
エクスポート範囲
(オプション)

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

  • [現在の表示範囲] マップ ビュー - 範囲は、アクティブなマップまたはシーンに基づきます。
  • [範囲の描画] 直角化して終了 - 範囲は、マップまたはシーンに描画された四角形に基づきます。
  • [レイヤーの範囲] レイヤー - 範囲は、アクティブなマップ レイヤーに基づきます。 使用可能なレイヤーを選択するか、[すべてのレイヤーのデータの範囲] オプションを使用します。 各マップ レイヤーには、次のオプションがあります。

    • [すべてのフィーチャ] すべて選択 - すべてのフィーチャの範囲。
    • [選択フィーチャ] 選択フィーチャからのエリア - 選択したフィーチャの範囲。
    • [表示フィーチャ] Extent Indicator - 表示フィーチャの範囲。

  • [参照] 参照 - 範囲はデータセットに基づきます。
  • [クリップボード] 貼り付け - 範囲をクリップボードにコピーしたり、クリップボードから貼り付けたりできます。
    • [範囲をコピー] コピー - 範囲と座標系をクリップボードにコピーします。
    • [範囲を貼り付け] 貼り付け - 範囲と座標系をクリップボードから貼り付けます。 クリップボードに座標系が含まれていない場合、マップの座標系が範囲に使用されます。
  • [範囲をリセット] リセット - 範囲はデフォルト値にリセットされます。

座標を手動で入力する場合、アクティブなマップの座標系の座標を数値で指定する必要があります。 マップで、入力した座標と異なる表示単位が使用されることがあります。 南と西の座標にはマイナス値の記号を使用します。

Extent
タイルの上書き
(オプション)

エクスポート先のキャッシュ内にある画像を、作成されたキャッシュのタイルとマージするか、タイルで上書きするかを指定します。

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

派生した出力

ラベル説明データ タイプ
出力キャッシュ パス

キャッシュのエクスポート先のフォルダー。

String

arcpy.server.ExportMapServerCache(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

エクスポートするキャッシュ タイルを含むマップ イメージ レイヤー。

Image Service; Map Server
target_cache_path

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

Folder
export_cache_type

エクスポートするキャッシュのタイプを指定します。 ArcGIS Maps SDKs for Native Apps で使用するには、タイル パッケージが適しています。

  • CACHE_DATASET—ArcGIS Server を使用して生成されたマップまたはイメージ サービス キャッシュがエクスポートされます。 これは、ArcGIS Desktop と、ArcGIS Server のマップまたはイメージ サービスで使用できます。 これがデフォルトです。
  • TILE_PACKAGE—キャッシュ データセットがレイヤーとして追加され、共有できるように統合された単一の圧縮ファイルがエクスポートされます。 これは ArcGIS Pro および ArcGIS Maps SDKs for Native Apps で使用できます。
String
copy_data_from_server

タイルをエクスポート先のフォルダーに移動する方法を指定します。

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

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

エクスポートされたキャッシュに使用される格納形式を指定します。

  • COMPACT—タイルは、ディスク領域の節約とキャッシュのコピーの高速化を可能にするために、bundle および bundlex ファイルにグループ化されます。 export_cache_type パラメーターが TILE_PACKAGE に設定されている場合、これがデフォルトです。
  • COMPACT_V2—タイルはバンドル ファイルのみにグループ化されます。 この形式は、ネットワーク共有とクラウド ストア ディレクトリのパフォーマンスを向上させます。 export_cache_type パラメーターが TILE_PACKAGE に設定されている場合、タイル パッケージの拡張子は .tpkx になります。これは、ArcGIS Online、ArcGIS Enterprise 11.4、ArcGIS Maps SDKs for Native Apps 200.0 以降、ArcGIS Runtime 100.5-100.15 などの新しいバージョンの ArcGIS 製品でサポートされています。
  • EXPLODED—各タイルは、個別のファイルとして格納されます。
String
scales
[scales,...]

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

Double
num_of_caching_service_instances
(オプション)

タイルの更新または生成に使用するインスタンスの数を指定します。 このパラメーターの値は無制限 (-1) に設定され、変更できません。

Long
area_of_interest
(オプション)

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

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

Feature Set
export_extent
(オプション)

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

  • MAXOF - すべての入力データの最大範囲が使用されます。
  • MINOF - すべての入力データに共通する最小領域が使用されます。
  • DISPLAY - 範囲は、表示範囲と同じになります。
  • レイヤー名 - 指定したレイヤーの範囲が使用されます。
  • Extent オブジェクト - 指定したオブジェクトの範囲が使用されます。
  • 座標のスペース区切りの文字列 - 指定した文字列の範囲が使用されます。 座標は、x-min、y-min、x-max、y-max の順序で表されます。
Extent
overwrite
(オプション)

エクスポート先のキャッシュ内にある画像を、作成されたキャッシュのタイルとマージするか、タイルで上書きするかを指定します。

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

派生した出力

名前説明データ タイプ
output_cache_path

キャッシュのエクスポート先のフォルダー。

String

コードのサンプル

ExportMapServerCache の例 1 (スタンドアロン スクリプト)

格納形式を EXPLODED から COMPACT に変更して、フィーチャクラスのキャッシュ タイルをエクスポートします。

# 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.server.ExportMapServerCache(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 as 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(str(e))

print("Exported Map server Cache  using area of Interest")

report.close()
ExportMapServerCache の例 2 (スタンドアロン スクリプト)

ArcGIS 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.server.ExportMapServerCache(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 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("Exported Map server Cache ")

report.close()

環境

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

ライセンス情報

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

関連トピック

  • キャッシュ ツールセットの概要
  • ジオプロセシング ツールの検索

このトピックへのフィードバック

このトピックの内容
  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報