トップへ戻る

マップ サービス キャッシュのインポート (Import Map Server Cache) (サーバー)

このトピックの内容

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

サマリー

マップ イメージ レイヤーのキャッシュに、ディスク上のフォルダーからタイルをインポートします。

ソース フォルダーには、登録済みサーバー キャッシュ ディレクトリの子、以前にキャッシュをエクスポートしたフォルダー、またはタイル パッケージ (.tpk または .tpkx) を指定できます。ターゲット サービスのタイル スキーマと格納形式は、ソース キャッシュと同じである必要があります。

使用法

  • このツールを使用して、キャッシュのすべてまたは一部をフォルダー間でインポートします。

  • [タイルの上書き] パラメーターにより、画像をブレンドするのではなく、インポートされたタイルで既存のタイルを完全に上書きできるようになりました。 インポートされたタイルは、対象エリアに制限されます。

  • このツールは、すぐに利用できる形式で作成されたキャッシュを認識します。つまり、キャッシュのコンテンツは、開いているタイル パッケージ仕様を使用して生成されています。 XML 形式で格納されたスキーマを使って生成されたキャッシュもサポートされます。

パラメーター

ダイアログPython

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

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

Image Service; Map Server
ソース キャッシュ タイプ

サーバーで実行中のキャッシュされたマップまたはイメージ サービスにインポートされるキャッシュのタイプを指定します。

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

インポートするタイルへのパス。 参照時にはラスター データセット アイコンで表されます。 登録済みのサーバー キャッシュ ディレクトリを指定する必要はありません。通常は、以前にタイルをエクスポートしたディスク上の場所を指定します。 このパラメーターには、ArcGIS Server アカウントがアクセスできる場所を指定します。 この場所へのアクセス権を ArcGIS Server アカウントに付与できない場合は、[データをサーバーへアップロード] パラメーターをオンにします。

Raster Dataset
ソースとなるタイル パッケージ
(オプション)

インポートするタイル パッケージ (.tpk または .tpkx) のパス。 このパラメーターには、ArcGIS Server アカウントがアクセスできる場所を指定します。 タイル パッケージ ファイルをキャッシュされたマップまたはイメージ サービスにインポートすると、[データをサーバーへアップロード] パラメーターが自動的に有効になります。

File
データをサーバーへアップロード
(オプション)

タイルをサーバー キャッシュ ディレクトリに移動する方法を指定します。

ArcGIS Server アカウントにソース キャッシュに対する読み取りアクセス権がない場合は、このパラメーターをオンにします。 キャッシュが ArcGIS Server のキャッシュ ディレクトリに移動される前に、ソース キャッシュが ArcGIS Server のアップロード ディレクトリにアップロードされます。

  • オン - タイルは最初にサーバーのアップロード ディレクトリに配置された後、サーバーのキャッシュ ディレクトリに移動されます。 [ソース キャッシュ タイプ] パラメーターが [タイル パッケージ] に設定されている場合は、デフォルトでこの設定が有効になります。
  • オフ - タイルは直接、サーバーのキャッシュ ディレクトリにインポートされます。 ArcGIS Server アカウントには、ソース キャッシュに対する読み取りアクセス権が必要です。
Boolean
縮尺
(オプション)

タイルをインポートする縮尺レベルのリスト。

デフォルトでは、ツール ダイアログ ボックスのリストには、サービスの最小と最大のキャッシュ縮尺の間にある縮尺が表示されます。 縮尺の範囲を更新するには、[サービス エディター] > [キャッシュ] タブの順に移動し、スライダーを使用して最小と最大のキャッシュ縮尺を更新します。

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

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

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

タイルをキャッシュにインポートする範囲を空間的に制限する対象エリアのポリゴン。 このパラメーターは、不規則な形状のエリアにタイルをインポートする場合に便利です。ツールはピクセル解像度でポリゴンと交差するキャッシュ データセットをクリップし、その結果をサービス キャッシュ ディレクトリにインポートします。

このパラメーターに値を指定しない場合は、[インポート範囲] パラメーターの値が使用されます。 デフォルトでは、マップの全範囲が使用されます。

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

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

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

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

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

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

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

派生した出力

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

出力 URL。

String

arcpy.management.ImportMapServerCache(input_service, source_cache_type, {source_cache_dataset}, {source_tile_package}, {upload_data_to_server}, {scales}, {num_of_caching_service_instances}, {area_of_interest}, {import_extent}, {overwrite})
名前説明データ タイプ
input_service

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

Image Service; Map Server
source_cache_type

サーバーで実行中のキャッシュされたマップまたはイメージ サービスにインポートされるキャッシュのタイプを指定します。

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

データ フレーム名に一致するキャッシュ フォルダーのパス。 登録済みのサーバー キャッシュ ディレクトリを指定する必要はありません。通常は、以前にタイルをエクスポートしたディスク上の場所を指定します。 このパラメーターには、ArcGIS Server アカウントがアクセスできる場所を指定します。 この場所へのアクセス権を ArcGIS Server アカウントに付与できない場合は、upload_data_to_server パラメーターを UPLOAD_DATA に設定します。

Raster Dataset
source_tile_package
(オプション)

インポートするタイル パッケージ (.tpk または .tpkx) のパス。 このパラメーターには、ArcGIS Server アカウントがアクセスできる場所を指定します。 タイル パッケージ ファイルをキャッシュされたマップまたはイメージ サービスにインポートする場合、upload_data_to_server パラメーターは無視され、自動的に UPLOAD_DATA に設定されます。

File
upload_data_to_server
(オプション)

タイルをサーバー キャッシュ ディレクトリに移動する方法を指定します。

ArcGIS Server アカウントにソース キャッシュに対する読み取りアクセス権がない場合は、このパラメーターを UPLOAD_DATA に設定します。 キャッシュが ArcGIS Server のキャッシュ ディレクトリに移動される前に、ソース キャッシュが ArcGIS Server のアップロード ディレクトリにアップロードされます。

  • UPLOAD_DATA—タイルは最初にサーバーのアップロード ディレクトリに配置された後、サーバーのキャッシュ ディレクトリに移動されます。 source_cache_type が TILE_PACKAGE に設定されている場合は、デフォルトでこの設定が有効になります。
  • DO_NOT_UPLOAD—タイルは直接、サーバーのキャッシュ ディレクトリにインポートされます。 ArcGIS Server アカウントには、ソース キャッシュに対する読み取りアクセス権が必要です。
Boolean
scales
[scales,...]
(オプション)

タイルをインポートする縮尺レベルのリスト。

Double
num_of_caching_service_instances
(オプション)

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

Long
area_of_interest
(オプション)

タイルをキャッシュにインポートする範囲を空間的に制限する対象エリアのポリゴン。 このパラメーターは、不規則な形状のエリアにタイルをインポートする場合に便利です。ツールはピクセル解像度でポリゴンと交差するキャッシュ データセットをクリップし、その結果をサービス キャッシュ ディレクトリにインポートします。

このパラメーターに値を指定しない場合は、import_extent パラメーターの値が使用されます。 デフォルトでは、マップの全範囲が使用されます。

Feature Set
import_extent
(オプション)

キャッシュにインポートするタイルを定義する矩形の範囲。 デフォルトでは、表示範囲は、インポートするマップ サービスの全体表示に設定されます。 オプションの [対象エリア] パラメーターを使用すると、不規則な形状を使用してインポート対象のタイルを空間的に制限できます。 両方のパラメーターに値を指定した場合は、[対象エリア] パラメーター値が使用されます。

キャッシュにインポートするタイルを定義する矩形の範囲。 デフォルトでは、表示範囲は、インポートするマップ サービスの全体表示に設定されます。 オプションの area_of_interest パラメーターを使用すると、不規則な形状を使用してインポート対象のタイルを空間的に制限できます。 両方のパラメーターに値を指定した場合は、area_of_interest パラメーター値が使用されます。

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

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

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

派生した出力

名前説明データ タイプ
out_job_url

出力 URL。

String

コードのサンプル

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

デフォルトの縮尺数でキャッシュ データセットをキャッシュされたサービスにインポートします。 インポート先のキャッシュ内にあるタイルは、インポートされるタイルによって上書きされます。

# Name: ImportMapServerCache.py
# Description: The following stand-alone script demonstrates how to import map
#               server cache from a source directory with CACHE_DATASET and
#               OVERWRITE existing cache on the service for the number
#               of scales specified without Uploading data to 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
sourceCacheType     = "CACHE_DATASET"
sourceCacheDataset  = "C:/data/destination_folder/Layers"
sourceTilePackage   = ""
uploadDataToServer  = "DO_NOT_UPLOAD"
scales              = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
areaOfInterest      = ""
importExtents       = ""
overwriteTiles      = "OVERWRITE"

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 "scales[0]","scales[-1]","scales[0:3]"

try:
    starttime = time.clock()
    result = arcpy.server.ImportMapServerCache(inputService, sourceCacheType,
                                               sourceCacheDataset,
                                               sourceTilePackage,
                                               uploadDataToServer, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest, importExtents,
                                               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("Imported Map server Cache Tiles successfully for" + serviceName + \
        " from" + sourceCacheDataset + "\n in " + str(elapsedtime)+ "sec 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("Imported Map server Cache Tiles ")

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

対象エリアのキャッシュ タイルをタイル パッケージからキャッシュ サービスにインポートします。

# Name: ImportMapServerCache.py
# Description: The following stand-alone script demonstrates how to import map
#               server cache from a source directory with Tile Package to an existing service for
#               the default number of scales specified using an AOI by uploading data to remote server
# To Import cache tiles for the scales specified for given feature class

# Requirements: os, sys, time and 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 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
sourceCacheType = "TILE_PACKAGE"
sourceCacheDataset = ""
sourceTilePackage = "C:\\data\\destination_folder\\TPK\\Rainfall.tpk"
uploadDataToServer = "UPLOAD_DATA"
scales = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
cacheDir = "c:\\arcgisserver\\arcgiscache"
areaOfInterest = "C:/data/101/Portland/Portland_Metro.shp"
importExtents = ""
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 "scales[0]","scales[-1]","scales[0:3]"

try:
    starttime = time.clock()
    result = arcpy.server.ImportMapServerCache(inputService, sourceCacheType,
                                               sourceCacheDataset,
                                               sourceTilePackage,
                                               uploadDataToServer, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest, importExtents,
					       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("Imported Map server Cache Tiles successfully for " + serviceName + \
        " from " + sourceTilePackage + " to " + cacheDir + "\n using "+ areaOfInterest + \
        " 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 2 \n" "Line %i" % tb.tb_lineno)
    report.write(str(e))

report.close()

print("Imported Map server Cache Tiles for the given feature class")

環境

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

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

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