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

サマリー

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

使用法

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

パラメーター

ラベル	説明	データタイプ
入力サービス	キャッシュタイルを更新する 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 上で実行しながら、このツールを引き続き実行するかどうかを指定します。オン - キャッシュジョブを ArcGIS Online または Portal for ArcGIS 上で実行しながら、このツールが引き続き実行されます。このオプションを使用すると、いつでも詳細な進行状況のレポートをリクエストして、表示されるジオプロセシングメッセージを確認できます。これがデフォルトです。オフ - ジョブがポータルに送信され、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—キャッシュジョブを ArcGIS Online または Portal for ArcGIS 上で実行しながら、このツールが引き続き実行されます。このオプションを使用すると、いつでも詳細な進行状況のレポートをリクエストして、表示されるジオプロセシングメッセージを確認できます。これがデフォルトです。 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
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)

### Sign in to ArcGIS Online
##myPortal= "https://www.arcgis.com"
##arcpy.SignInToPortal(myPortal, "MyUserName", "MyPassword")
##serviceRestUrl="https://www.arcgis.com/tiles/orgid"
##serviceName= "MyServiceName"
##serviceType= "MapServer"
##myPortalServiceURL = (serviceRestUrl + "/" + "arcgis/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 
##scales = [591657527.591555,295828763.79577702,147914381.89788899]
scales = [73957190.948944,36978595.474472]
numOfCachingServiceInstances = 8
updateMode = "RECREATE_ALL_TILES"
areaOfInterest = ""
waitForJobCompletion = "WAIT"
updateExtents = ""
portalURL =""


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

try:
    result = arcpy.server.ManageMapServerCacheTiles(myPortalServiceURL, 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(str(e))
report.close()

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

環境

現在のワークスペース

ライセンス情報

Basic: Yes
Standard: Yes
Advanced: Yes

サマリー

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容