マップサービスキャッシュのタイルを管理 (Manage Map Server Cache Tiles) (サーバー)—ArcGIS Pro

サマリー

既存の Web タイルレイヤーキャッシュ (ArcGIS Enterprise または ArcGIS Online)、ArcGIS Enterprise の Web マップイメージレイヤー、およびスタンドアロンサーバーのキャッシュ済みマップまたはイメージサービスにタイル作成し、更新します。このツールは、新しいタイルの作成、欠落したタイルの補充、古くなったタイルの上書き、またはタイルの削除に使用します。

使用法

このツールは、広大な地理的範囲または非常に大縮尺をカバーするキャッシュを行う場合、実行に時間がかかることがあります。もしツールがキャンセルされると、タイルの作成は停止しますが、既存のタイルは削除されません。つまり、時間がないときにはツールをキャンセルし、後で [更新方法] パラメーターを [空タイルを再作成] (Python では update_mode = "RECREATE_EMPTY_TILES") に設定して、同じキャッシュに対して再度ツールを実行することができます。

パラメーター

ラベル	説明	データタイプ
入力サービス	キャッシュタイルを更新する Web タイルレイヤー、Web マップイメージレイヤーまたはマップイメージレイヤー。	Image Service; Map Server
縮尺	タイルを作成する縮尺レベルのリスト。デフォルトでは、ツールダイアログボックスのリストには、サービスの最小と最大のキャッシュ縮尺の間にある縮尺が表示されます。 ArcGIS Pro でサービスのキャッシュ縮尺範囲を変更することはできません。	Double
更新モード	キャッシュの更新に使用されるモードを指定します。空タイルを再作成—空のタイルだけを作成します。既存のタイルは未変更のままです。このオプションは、ArcGIS Online に公開された Web タイルレイヤーでは使用できません。すべてのタイルを再作成—既存のタイルを置き換え、範囲が変更された場合は新しいタイルを追加します。タイルの削除—タイルはキャッシュから削除されます。キャッシュフォルダー構造は削除されません。	String
キャッシュサービスのインスタンス数 (オプション)	このツールの実行に専用で使用する、System/CachingTools サービスのインスタンス数の合計。デフォルト値である -1 を使用した場合、ArcGIS Enterprise 設定のすべてのキャッシュツールインスタンスが使用されます。使用するキャッシュツールインスタンスの数を減らすには値を小さくします。 ArcGIS Server への管理者接続を通して使用できる [サービスエディター] ウィンドウで、System/CachingTools サービスの [コンピューターごとのインスタンスの最大数] 設定の値を大きく変更することができます。選択したインスタンス数を、サーバーコンピューターでサポートできることを確認してください。スタンドアロンサーバーに接続する際は、インスタンスのデフォルトの数字とキャッシュツールサービスの [インスタンスの最大数] 設定の値が等しくなるようにします。	Long
対象エリア (オプション)	タイルを作成または削除する範囲を制限する対象地域。このパラメーターは、不規則な形状のエリアでタイルを管理する場合に便利です。一部のエリアだけを事前にキャッシュして、表示頻度の低いエリアをキャッシュしない場合にも有効です。このパラメーターに値を指定しない場合、デフォルト値のマップ全体表示が使用されます。	Feature Set
更新範囲 (オプション)	[更新モード] パラメーターの値に従って、タイルを作成または削除するのに使用される矩形の範囲。 [更新範囲] と [対象地域] 両方のパラメーター値を指定した場合、[対象地域] の値が使用されます。 [デフォルト] - すべての関連する入力の最大範囲に基づく範囲とします。これがデフォルトです。 [現在の表示範囲] - 範囲がデータフレームまたは表示範囲と同じになります。アクティブなマップが存在しない場合、このオプションは使用できません。 [以下の指定に一致] - この範囲は、指定された最小および最大範囲値に基づきます。 [参照] - 範囲は、既存のデータセットに基づきます。	Extent
ジョブの完了を待機 (オプション)	キャッシュジョブを ArcGIS Online または Portal for ArcGIS 上で実行しながら、このツールを引き続き実行するかどうかを指定します。オン - キャッシュジョブを Portal for ArcGIS または ArcGIS Online 上で実行しながら、このツールが引き続き実行されます。このオプションを利用すると、いつでも詳細な進行状況のレポートをリクエストして、表示されるジオプロセシングメッセージを確認できます。これがデフォルトです。オフ - ジョブがポータルに送信され、ArcGIS Pro で他のジオプロセシングタスクを実行したり、終了できるようにします。サービスを公開するときにキャッシュを自動的に作成する場合にこのオプションを使用します。作成する別のキャッシュでこのオプションを設定することもできます。	Boolean
ポータル URL (オプション)	ポータルの URL。	String

派生した出力

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

arcpy.server.ManageMapServerCacheTiles(input_service, scales, update_mode, {num_of_caching_service_instances}, {area_of_interest}, {update_extent}, {wait_for_job_completion}, {portal_url})

名前	説明	データタイプ
input_service	キャッシュタイルを更新する Web タイルレイヤー、Web マップイメージレイヤーまたはマップイメージレイヤー。	Image Service; Map Server
scales [scales,...]	タイルを作成する縮尺レベルのリスト。	Double
update_mode	キャッシュの更新に使用されるモードを指定します。 RECREATE_EMPTY_TILES—空のタイルだけを作成します。既存のタイルは未変更のままです。このオプションは、ArcGIS Online に公開された Web タイルレイヤーでは使用できません。 RECREATE_ALL_TILES—既存のタイルを置き換え、範囲が変更された場合は新しいタイルを追加します。 DELETE_TILES—タイルはキャッシュから削除されます。キャッシュフォルダー構造は削除されません。	String
num_of_caching_service_instances (オプション)	このツールの実行に専用で使用する、System/CachingTools サービスのインスタンス数の合計。デフォルト値である -1 を使用した場合、ArcGIS Enterprise 設定のすべてのキャッシュツールインスタンスが使用されます。使用するキャッシュツールインスタンスの数を減らすには値を小さくします。 ArcGIS Server への管理者接続を通して使用できる [サービスエディター] ウィンドウで、System/CachingTools サービスの [コンピューターごとのインスタンスの最大数] 設定の値を大きく変更することができます。選択したインスタンス数を、サーバーコンピューターでサポートできることを確認してください。スタンドアロンサーバーに接続する際は、インスタンスのデフォルトの数字とキャッシュツールサービスの [インスタンスの最大数] 設定の値が等しくなるようにします。	Long
area_of_interest (オプション)	タイルを作成または削除する範囲を制限する対象地域。このパラメーターは、不規則な形状のエリアでタイルを管理する場合に便利です。一部のエリアだけを事前にキャッシュして、表示頻度の低いエリアをキャッシュしない場合にも有効です。このパラメーターに値を指定しない場合、デフォルト値のマップ全体表示が使用されます。	Feature Set
update_extent (オプション)	update_mode パラメーターの値に従って、タイルを作成または削除するのに使用される矩形の範囲。 update_extent と area_of_interest 両方のパラメーター値を指定した場合、area_of_interest の値が使用されます。 MAXOF - すべての入力の最大範囲が使用されます。 MINOF - すべての入力に共通する最小領域が使用されます。 DISPLAY - 範囲は、表示範囲と同じになります。 [レイヤー名] - 指定したレイヤーの範囲が使用されます。 Extent オブジェクト - 指定したオブジェクトの範囲が使用されます。 [座標のスペース区切りの文字列] - 指定した文字列の範囲が使用されます。座標は、x-min、y-min、x-max、y-max の順序で表されます。	Extent
wait_for_job_completion (オプション)	キャッシュジョブを ArcGIS Online または Portal for ArcGIS 上で実行しながら、このツールを引き続き実行するかどうかを指定します。 WAIT—キャッシュジョブを Portal for ArcGIS または ArcGIS Online 上で実行しながら、このツールが引き続き実行されます。このオプションを利用すると、いつでも詳細な進行状況のレポートをリクエストして、表示されるジオプロセシングメッセージを確認できます。これがデフォルトです。 Python スクリプトでは、このオプションを使用することをお勧めします。 DO_NOT_WAIT—ジョブがサーバーに送信され、他のジオプロセシングタスクを実行できます。サービスを公開するときにキャッシュを自動的に作成する場合にこのオプションを使用します。作成する別のキャッシュでこのオプションを設定することもできます。	Boolean
portal_url (オプション)	ポータルの URL。	String

派生した出力

名前	説明	データタイプ
out_job_url	出力 URL。	String

コードのサンプル

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

以下は、対象地域を使用してマップまたはイメージサービスですべてのキャッシュタイルを再作成する方法を示したものです。

# Name: ManageMapServerCacheTiles.py
# Description: The following stand-alone script demonstrates how to Recreate all 
#               cache tiles for for a map or image service using an area of interest.
#               This tool works for weblayers published to ArcGIS Enterprise and ArcGIS Online.
#               and for map and image services on a stand alone ArcGIS Server

# Example: This sample script updates map cache tiles.

import arcpy
import os

# Sign in to portal
myPortal= "https://www.myArcGISEnterprise.com/webadaptor"
arcpy.SignInToPortal(myPortal, "MyUserName", "MyPassword")
serviceName= "MyCounty"
serviceType= "MapServer"
myPortalServiceURL = (myPortal + "/" + "rest/services" +"/" + serviceName + "/" + serviceType)


# Stand alone ArcGIS Server
target_server_connection = r"C:\Project\gisserver.ags.esri.com (publisher).ags"
serviceName= "MyCounty"
serviceType= "MapServer"
myServerServiceURL= target_server_connection + "/" + serviceName + "." + serviceType


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


# List of input variables for map or image service 
scales = [500000,250000]
numOfCachingServiceInstances = 8
updateMode = "RECREATE_ALL_TILES"
areaOfInterest = "C:/data/shp/CaTxFlMaMin.shp"
waitForJobCompletion = "WAIT"
updateExtents = ""
portalURL =""

# Variables for reporting
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')

try:
    result = arcpy.server.ManageMapServerCacheTiles(mytest, scales, updateMode,
                                                    numOfCachingServiceInstances, areaOfInterest,
                                                    updateExtents, waitForJobCompletion,
                                                    portalURL)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print ("Created cache tiles for given schema 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(e.message)
report.close()

print ("Completed update of cache tiles for " + serviceName)

サマリー

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

特殊なケース

ライセンス情報

関連トピック

このトピックの内容