マップサービスキャッシュタイルスキーマの生成 (Generate Map Server Cache Tiling Scheme) (サーバー)—ArcGIS Pro

サマリー

Web タイルレイヤーの縮尺レベル、タイルサイズ、およびその他のプロパティを定義する、カスタムタイルスキーマファイルを生成します。

タイルスキーマは、キャッシュ内のタイルの参照方法を示し、ソースマップドキュメントの空間参照とタイルグリッドの間のマッピングを行います。タイルグリッドは、スキーマに参照付けられた詳細レベル (縮尺)、行、および列を使用します。スキーマは、キャッシュのタイルの縮尺レベル (詳細レベル)、タイルのサイズ (ピクセル単位)、および最もよく表示されるタイルの画面解像度も定義します。タイルスキーマは、マップキャッシュを生成するために必要です。

使用法

デフォルトでは、タイル原点は、サービスのソースマップドキュメントによって使用される座標系の左上隅が開始場所になっています。
[すぐに利用できる形式] パラメーターがオンの場合、キャッシュコンテンツスキーマは、開いているタイルパッケージ仕様を使用して生成されます。

パラメーター

ラベル	説明	データタイプ
マップドキュメント	タイルスキーマに使用される現在のマップまたは既存の .mxd ファイル。	Map
タイルの原点 (マップ単位)	ソースデータフレームの空間参照座標でのタイルスキーマの原点 (左上隅)。	Point
出力タイルスキーマ	作成されるタイルスキーマファイルのパスとファイル名。	File
縮尺レベル数	タイルスキーマに含める縮尺レベルの数。	Long
縮尺	タイルスキーマに含める縮尺レベル。これらは分数としては表されません。代わりに、500 を使用して 1:500 などの目盛を表します。	Value Table
解像度 (DPI または PPI)	対象となる出力デバイスの 1 インチあたりのドット数 (DPI)。指定した DPI が出力デバイスの解像度と一致していない場合、その縮尺のマップタイルは正しく表示されません。デフォルト値は 96 です。	Long
タイルサイズ	ピクセル単位でキャッシュタイルの幅と高さを指定します。パフォーマンスと管理容易性の最適なバランスを得るには、256 x 256 または 512 x 512 の標準寸法から外れないようにしてください。 128 x 128—キャッシュタイルの幅と高さは 128 x 128 ピクセルです。 256 x 256—キャッシュタイルの幅と高さは 256 x 256 ピクセルです。これがデフォルトです。 512 x 512 ピクセル—キャッシュタイルの幅と高さは 512 x 512 ピクセルです。 1024 x 1024—キャッシュタイルの幅と高さは 1024 x 1024 ピクセルです。	String
すぐに利用できる形式 (オプション)	使用されるキャッシュスキーマのファイル形式、および開いているタイルパッケージ仕様を使用して生成するかどうかを指定します。オン - キャッシュスキーマは、開いているタイルパッケージ仕様を使用して JSON 形式で生成されます。出力フォルダーは [出力フォルダー] パラメーターで指定されている必要があります。オフ - キャッシュスキーマは、XML 形式で生成されます。これがデフォルトです。	Boolean
出力フォルダー (オプション)	キャッシュスキーマと iteminfo ファイルが JSON 形式で作成されるフォルダーの場所。	Folder

arcpy.server.GenerateMapServerCacheTilingScheme(in_map, tile_origin, output_tiling_scheme, num_of_scales, scales, dots_per_inch, tile_size, {ready_to_serve_format}, {output_folder})

名前	説明	データタイプ
in_map	タイルスキーマに使用される現在のマップまたは既存の .mxd ファイル。	Map
tile_origin	ソースデータフレームの空間参照座標でのタイルスキーマの原点 (左上隅)。	Point
output_tiling_scheme	作成されるタイルスキーマファイルのパスとファイル名。	File
num_of_scales	タイルスキーマに含める縮尺レベルの数。	Long
scales [scales,...]	タイルスキーマに含める縮尺レベル。これらは分数としては表されません。代わりに、500 を使用して 1:500 などの目盛を表します。	Value Table
dots_per_inch	対象となる出力デバイスの 1 インチあたりのドット数 (DPI)。指定した DPI が出力デバイスの解像度と一致していない場合、その縮尺のマップタイルは正しく表示されません。デフォルト値は 96 です。	Long
tile_size	ピクセル単位でキャッシュタイルの幅と高さを指定します。パフォーマンスと管理容易性の最適なバランスを得るには、256 x 256 または 512 x 512 の標準寸法から外れないようにしてください。 128 x 128—キャッシュタイルの幅と高さは 128 x 128 ピクセルです。 256 x 256—キャッシュタイルの幅と高さは 256 x 256 ピクセルです。これがデフォルトです。 512 x 512—キャッシュタイルの幅と高さは 512 x 512 ピクセルです。 1024 x 1024—キャッシュタイルの幅と高さは 1024 x 1024 ピクセルです。	String
ready_to_serve_format (オプション)	使用されるキャッシュスキーマのファイル形式、および開いているタイルパッケージ仕様を使用して生成するかどうかを指定します。 READY_TO_SERVE_FORMAT—キャッシュスキーマは、開いているタイルパッケージ仕様を使用して JSON 形式で生成されます。出力フォルダーは output_folder パラメーターで指定されている必要があります。 NON_READY_TO_SERVE_FORMAT—キャッシュスキーマは、XML 形式で生成されます。これがデフォルトです。	Boolean
output_folder (オプション)	キャッシュスキーマと iteminfo ファイルが JSON 形式で作成されるフォルダーの場所。	Folder

コードのサンプル

GenerateMapServerCacheTilingScheme の例 1 (XML 形式)

次の例では、XML 形式でマップキャッシュタイルスキーマを作成します。

# Name: GeneateMapServerCacheTilingScheme.py
# Description: The following stand-alone script demonstrates how to create map
#               server cache schema using a given map document at a given
#               "pathForOutputXml"
# Requirements: os, sys, time & 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 = "E:/path/to/myfolder"

# List of input variables for map service properties

# Reference map to use for cache tiling sceheme generation
aprx = arcpy.mp.ArcGISProject(r"E:\Data\path\to\myAPRX.aprx")
mapDocument = aprx.listMaps("myMapName")[0]
outputTilingScheme = "E:/path/to/myschema.xml"
tileOrigin = ""
numOfScales = "4"
scales = "4000000,2000000,100000,50000"
tileSize = "256 x 256"
dotsPerInch = "96"

# print results of the script to a report

file = r'E:\path\to\myreport.txt'
report = open(file,'w')

try:
    #starttime = time.clock()
    result = arcpy.server.GenerateMapServerCacheTilingScheme(mapDocument,
                                                             tileOrigin, outputTilingScheme,
                                                             numOfScales, scales,
                                                             dotsPerInch, tileSize)

    #print messages to a file
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print(" Created MapServer cache tiling schema successfully using" + \
        mapDocument + " at "+ outputTilingScheme )

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("Created Map server Cache Tiling schema ")

report.close()

GenerateMapServerCacheTilingScheme の例 2 (JSON 形式)

次の例では、JSON 形式でマップキャッシュタイルスキーマを作成します。

# Name: GeneateMapServerCacheTilingScheme.py
# Description: The following stand-alone script demonstrates how to create map
#               server cache schema in ready to serve format using a given map document at a given
#               folder
# Requirements: os, sys, time & 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 = "E:/path/to/myfolder"

# List of input variables for map service properties

# Reference map to use for cache tiling sceheme generation
aprx = arcpy.mp.ArcGISProject(r"E:\Data\path\to\myAPRX.aprx")
mapDocument = aprx.listMaps("myMapName")[0]
outputTilingScheme = "None"
tileOrigin = ""
numOfScales = "4"
scales = "4000000,2000000,100000,50000"
tileSize = "256 x 256"
dotsPerInch = "96"
ready_to_serve_format = "READY_TO_SERVE_FORMAT"
output_folder = "E:\path\to\myfolder"

# print results of the script to a report

file = r'E:\path\to\myreport.txt'
report = open(file,'w')

try:
    #starttime = time.clock()
    result = arcpy.server.GenerateMapServerCacheTilingScheme(mapDocument,
                                                             tileOrigin, outputTilingScheme,
                                                             numOfScales, scales,
                                                             dotsPerInch, tileSize,
                                                             ready_to_serve_format,
                                                             output_folder)

    #print messages to a file
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print(" Created MapServer cache tiling schema successfully using" + \
        mapDocument + " at "+ outputTilingScheme )

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("Created Map server Cache Tiling schema ")

report.close()

環境

現在のワークスペース

ライセンス情報

Basic: Yes
Standard: Yes
Advanced: Yes

サマリー

使用法

パラメーター

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容