トップへ戻る

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

このトピックの内容

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

サマリー

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

使用法

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

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

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

  • [すぐに利用できる形式] パラメーターがオンの場合、キャッシュのコンテンツは、開いているタイル パッケージ仕様を使用して生成されます。 キャッシュの形式は Compact V2 ですが、キャッシュ スキーマは XML ではなく JSON で格納されます。 このキャッシュ コンテンツは、公開ワークフローおよびオフライン ワークフロー用のタイル パッケージとして ZIP アーカイブにパッケージ化できます。 このキャッシュ コンテンツは、「キャッシュ データセットからのタイル レイヤーの公開」トピックに記載されているワークフローを使用してすぐに利用できます。 このパラメーターは、[エクスポートするキャッシュのタイプ] パラメーターの値が [キャッシュ データセット] である場合にのみ使用できます。

パラメーター

ダイアログPython

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

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

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

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

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

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

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

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

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

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

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

  • コンパクト—タイルは、ディスク領域の節約とキャッシュのコピーの高速化を可能にするために、bundle および bundlex ファイルにグループ化されます。 [エクスポートするキャッシュのタイプ] パラメーターが [タイル パッケージ] に設定されている場合は、これがデフォルトです。
  • コンパクト V2—タイルはバンドル ファイルのみにグループ化されます。 この形式は、ネットワーク共有とクラウド ストア ディレクトリのパフォーマンスを向上させます。 [エクスポートするキャッシュのタイプ] パラメーターが [タイル パッケージ] に設定されている場合、タイル パッケージの拡張子は (.tpkx) になります。これは、ArcGIS Online、ArcGIS Enterprise 11.5、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
すぐに利用できる形式
(オプション)

キャッシュのコンテンツが、開いているタイル パッケージ仕様を使用して生成されるかどうか、およびキャッシュ スキーマのファイル形式を指定します。 このパラメーターは、[エクスポートするキャッシュのタイプ] パラメーターの値が [キャッシュ データセット] である場合にのみ使用できます。

  • オン - キャッシュのコンテンツは、オープンなタイル パッケージ仕様を使用して生成されます。 タイル パッケージは、オフライン ワークフロー用のタイル パッケージとして ZIP アーカイブにパッケージ化できます。 キャッシュ形式は Compact V2 で、キャッシュ スキーマは JSON 形式で格納されます。
  • オフ - キャッシュ コンテンツは、XML 形式で格納されたスキーマを使用して生成されます。 以前のバージョンの ArcGIS Enterprise にキャッシュをコピーするには、このオプションを使用します。 これがデフォルトです。

Boolean

派生した出力

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

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

String

arcpy.management.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}, {ready_to_serve_format})
名前説明データ タイプ
input_service

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

Image Service; Map Server
target_cache_path

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

Folder
export_cache_type

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

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

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

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

  • COPY_DATA—タイルは最初にサーバーの出力ディレクトリに配置された後、エクスポート先のフォルダーに移動されます。 ArcGIS Desktop または ArcGIS AllSource のクライアントには、エクスポート先のフォルダーに対する書き込みアクセス権が必要です。
  • 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.5、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
ready_to_serve_format
(オプション)

キャッシュのコンテンツが、開いているタイル パッケージ仕様を使用して生成されるかどうか、およびキャッシュ スキーマのファイル形式を指定します。 このパラメーターは、export_cache_type パラメーター値が CACHE_DATASET である場合にのみ使用できます。

  • READY_TO_SERVE_FORMAT—キャッシュのコンテンツは、オープンなタイル パッケージ仕様 (https://github.com/Esri/tile-package-spec) を使用して生成されます。 タイル パッケージは、オフライン ワークフロー用のタイル パッケージとして ZIP アーカイブにパッケージ化できます。 キャッシュ形式は Compact V2 で、キャッシュ スキーマは JSON 形式で格納されます。
  • NON_READY_TO_SERVE_FORMAT—キャッシュ コンテンツは、XML 形式で格納されたスキーマを使用して生成されます。 以前のバージョンの ArcGIS Enterprise にキャッシュをコピーするには、このオプションを使用します。 これがデフォルトです。
Boolean

派生した出力

名前説明データ タイプ
output_cache_path

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

String

コードのサンプル

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

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

# Name: ExportMapServerCacheTiles.py
# Description: The following stand-alone script demonstrates how to export
# 		cache from a map layer in ArcGIS Enterprise portal,
# 		as CACHE_DATASET in COMPACT_V2 storage format and MERGE tiles
#               using an AREA_OF_INTEREST to TARGET_CACHE_PATH
#		which is accessible to server instances

# Example: This sample script updates map cache tiles.

import arcpy
from arcpy import env
import os, sys, time, datetime, traceback, string
import traceback, sys

# Set environment settings
env.workspace = "C:/data"

# Sign in to ArcGIS Enterprise
myPortal= "https://MyPortal.domain.com/portalwebadaptor"
arcpy.SignInToPortal(myPortal, "siteadminValue", "siteadminPassword")
myServer="https://Myserver.domain.com/serverwebadaptor"
serviceName= "SampleWorldCities"
serviceType= "MapServer"
myPortalServiceURL = (myServer + "/" + "rest/services" +"/" + serviceName + "/"
                      + serviceType)



# Stand alone ArcGIS Server
##target_server_connection = r"C:\share\python3\arcgis on MyServer.ags"
##serviceName= "MyServiceName"
##serviceType= ".MapServer"
##myPortalServiceURL = (target_server_connection +  "\\" + serviceName + serviceType)

print (myPortalServiceURL)

#variables for reporting
currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = r'C:\test\report_%s.txt'% arg1


# List of input variables for map or image service 
targetCachePath 	= "C:/data/temp"
exportCacheType 	= "CACHE_DATASET"
copyDataFromServer 	= "DO_NOT_COPY"
storageFormat 		= "COMPACT_V2"
scales 			= [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
areaOfInterest 		= "C:/data/101/Portland/Metro.shp"
exportExtents 		= ""
overwriteTiles 		= "MERGE"
ready_to_serve_format   = "NON_READY_TO_SERVE_FORMAT"


# Print results of the script to a report
report = open(file,'w')

try:
    result = arcpy.server.ExportMapServerCache(myPortalServiceURL, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest, exportExtents,
					       overwriteTiles,
                                               ready_to_serve_format)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print ("Exported cache successfully for " + serviceName )
    
except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    report.write("Failed at step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(str(e))
report.close()
ExportMapServerCache の例 2 (スタンドアロン スクリプト)

ArcGIS Server インスタンスからエクスポート先のフォルダーにアクセスできない場合に、TILE_PACKAGE を使用してキャッシュをエクスポートします。

# Name: ExportMapServerCacheTiles2.py
# Description: The following stand-alone script demonstrates how to export cache
#               on a map service on standalone server 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 

# Example: This sample script updates map cache tiles.

import arcpy
from arcpy import env
import os, sys, time, datetime, traceback, string
import traceback, sys

# Set environment settings
env.workspace = "C:/data"

# Sign in to ArcGIS Enterprise
##myPortal= "https://MyPortal.domain.com/portalwebadaptor"
##arcpy.SignInToPortal(myPortal, "siteadminValue", "siteadminPassword")
##myServer="https://Myserver.domain.com/serverwebadaptor"
##serviceName= "SampleWorldCities"
##serviceType= "MapServer"
##myPortalServiceURL = (myServer + "/" + "rest/services" +"/" + serviceName + "/"
##                      + serviceType)
##

# Stand alone ArcGIS Server
target_server_connection = r"C:\share\python3\arcgis on MyServer.ags"
serviceName= "MyServiceName"
serviceType= ".MapServer"
myPortalServiceURL = (target_server_connection +  "\\" + serviceName + serviceType)

print (myPortalServiceURL)

#variables for reporting
currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = r'C:\test\report_%s.txt'% arg1


# List of input variables for map or image service 
targetCachePath = "C:/temp/usa"
exportCacheType = "TILE_PACKAGE"
copyDataFromServer = "COPY_DATA"
storageFormat = "COMPACT_V2"
scaleValues = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
exportExtents = ""
areaOfInterest = ""
overwriteTiles = "MERGE"
ready_to_serve_format = "NON_READY_TO_SERVE_FORMAT"

# Print results of the script to a report
report = open(file,'w')

try:
    result = arcpy.server.ExportMapServerCache(inputService, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest,
                                               exportExtents, overwriteTiles,
                                               ready_to_serve_format)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print ("Exported cache successfully for " + serviceName )
    
except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    report.write("Failed at step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(str(e))
report.close()

環境

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

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

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