グローブサービスキャッシュのタイルを管理 (Manage Globe Server Cache Tiles) (サーバー)—ArcMap

概要
使用法
構文
コードのサンプル
環境
ライセンス情報

概要

タイルを既存のグローブサービスキャッシュ内に作成し、更新します。このツールは、新しいタイルの作成、欠落したタイルの補充、古くなったタイルの上書き、または新しいタイルの追加に使用します。そのようなすべてのアクションは、表示範囲枠あるいはポリゴンフィーチャクラスによって定義できます。新しいタイルを構築する場合には、空のタイルのみを作成するか、またはすべてのタイルを再構築するかを選択することができます。

使用法

このツールは、既存のグローブサービスキャッシュの更新に使用する必要があります。キャッシュを更新するには、グローブサービスをホストする ArcGIS Server を指定します。このツールは、対象のサーバー上で使用可能なすべてのグローブサービスの一覧を自動的に表示します。
範囲を指定しない [更新] の実行は、サービスの全範囲を更新します。
入力レイヤーに対して [level_from] と [level_to] を指定して、必ずタイルを生成したい範囲の縮尺レベルを指定するようにしてください。[level_from] は、データキャッシュの使用開始時に設定する最小の詳細レベルを定義します。[level_to] は、データキャッシュのための最も高い解像度を定義します。

構文

arcpy.server.ManageGlobeServerCacheTiles(service, in_layers, update_mode, {num_of_caching_service_instances}, {area_of_interest}, {ignore_status}, {update_extent})

パラメーター	説明	データタイプ
service	キャッシュタイルを更新するグローブサービス。これは、サーバーとサービスの両方の情報を含む文字列です。この文字列の構築方法を確認するには、ArcCatalog を開き、[カタログ] ツリーでサービスを選択して、[場所] ツールバーに表示されているテキストを記録します。バックスラッシュをスラッシュ (たとえば、GIS Servers/arcgis on MYSERVER (admin)/Seattle.GlobeServer) に変更します。	GlobeServer
in_layers [[layer, level_from, level_to],...]	キャッシュ内に含めるレイヤー。レイヤーのキャッシングを開始する詳細のレベルである、[level_from] と、レイヤーのキャッシングを終了する詳細のレベルである、[level_to] を、各レイヤーに提供する必要があります。[level_from] と [level_to] に対して、それぞれ最小/最大の詳細レベルの縮尺を使用した場合、レイヤー用に全キャッシュが構築されます。	Value Table
update_mode	キャッシュを更新するときのモードを選択します。次の 2 つのモードがあります。 RECREATE_EMPTY_TILES —空タイルだけを作成します。既存のタイルは未変更のままです。 RECREATE_ALL_TILES —既存のタイルを含めたすべてのタイルを補充します。また、レイヤーのデータ範囲が変更するか、または新しいレイヤーがグローブサービスに追加されてこのツールに表示された場合には、新しいタイルが追加されます。	String
num_of_caching_service_instances (オプション)	このツールの実行に専用で使用する、System/CachingTools サービスのインスタンス数の合計。 ArcGIS Server への管理者接続を通して使用できる [サービスエディター] ウィンドウで、System/CachingTools サービスの [コンピューターごとのインスタンスの最大数] 設定の値を大きく変更することができます。選択したインスタンス数を、サーバーコンピューターでサポートできることを確認してください。	Long
area_of_interest (オプション)	対象エリアを定義して、タイルを作成または削除する範囲を制限します。フィーチャクラスを指定するか、ArcMap で対話的に定義するフィーチャを指定できます。このパラメーターは、不規則な形状のエリアでタイルを管理する場合に便利です。一部のエリアだけを事前にキャッシュして、表示頻度の低いエリアをキャッシュしない場合にも有効です。	Feature Set
ignore_status (オプション)	このパラメーターを使用すると、フィーチャクラスの境界線に基づいてタイルを作成している場合に、キャッシングのステータスを追跡することができます (update_feature_class パラメーターを参照)。 TRACK_STATUS —フィーチャクラスの [Cached] フィールドを読み取ります (存在していない場合は、フィールドを作成します)。このフィールドの値が [No] または NULL のフィーチャがキャッシュされ、フィーチャのキャッシュ処理が完了するとフィールドが [Yes] になります。このフィールドがすでに [Yes] にマークされているフィーチャは、キャッシュ対象外になります。 DO_NOT_TRACK_STATUS —フィーチャクラスの [Cached] フィールドを無視し、フィーチャクラス内のすべてのフィーチャでタイルを作成します。	Boolean
update_extent (オプション)	update_mode パラメーターの値に従って、タイルを作成または削除する矩形の範囲。範囲の値を入力するか、または既存のデータソースから範囲を選択することができます。	Extent

コードのサンプル

グローブサービスのキャッシュタイルを作成します。

#ManageGlobeServerCacheTiles For ArcGIS Server 10.1 Beta example (stand-alone script)

# Name: ManageGlobeServerCacheTiles.py
# Description: The following stand-alone script demonstrates how to update the
#               globe map server cache tiles
# Requirements: os, sys, time & traceback modules 
# Author: ESRI

# Any line that begins with a pound sign is a comment and will not be executed
# Empty quotes take the default values
# 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)"
globeServiceName = "tstGlobeService.GlobeService"
globeService = connectionFile + "\\" + server + "\\" + globeServiceName
inputLayers = ""
updateExtents = ""
updateMode = "RECREATE_ALL_TILES"
numOfCachingServiceInstances = "2"
areaOfInterest = ""
ignoreStatus = "DO_NOT_TRACK_STATUS"

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:
    starttime= time.clock()
    result = arcpy.ManageGlobeServerCacheTiles_server (globeService, inputLayers,
                                                       updateMode,
                                                       numOfCachingServiceInstances,
                                                       areaOfInterest,
                                                       ignoreStatus, updateExtents)
    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 "Created the GlobeServer cache successfully for mapservice "
    globeService + "\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 step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(e.message)
report.close()
    
print "Created the globe server cache successfully"

環境

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

ライセンス情報

Basic: 次のものが必要 3D Analyst
Standard: 次のものが必要 3D Analyst
Advanced: 次のものが必要 3D Analyst