マップ サービス キャッシュ タイル スキーマ → ポリゴン (Map Server Cache Tiling Scheme To Polygons) (カートグラフィ)

サマリー

既存のタイル スキーマに基づいて新しいポリゴン フィーチャクラスを作成します。

このツールは、既存のマップ サービス キャッシュ タイル スキーマと同じ縮尺を使用してマップ範囲を細分化します。また、大規模領域にスーパータイルと呼ばれるタイルを作成します。 スーパータイル範囲は、スキーム内に定義されている実際のタイルに比べて大規模です。そのため、[ラベル → タイル分割されたアノテーション (Tiled Labels To Annotation)] ツールへの入力として使用されたタイルに基づいて、ラベルを大規模領域に対応したアノテーションに一括変換できるようになっています。 このプロセスによって、タイル全体のアノテーションの複製が最小化されます。

使用法

  • 既存のタイル スキーマを読み込むためのオプションとして、次のものがあります。

    • ArcGIS Online、Google マップ、Bing Maps、Yahoo などのオンライン マッピング サービスからタイル スキーマを読み込みます。 これらのタイル スキーマは、ArcGIS Pro のインストール ディレクトリの Resources\TilingSchemes フォルダーにあります。
    • 既存のマップ サービス キャッシュからタイル スキーマ ファイルを読み込みます。 どのマップ キャッシュにも、キャッシュ ディレクトリ内にタイル スキーマ ファイル conf.xml があります (たとえば、C:\arcgisserver\arcgiscache\MyService\MyDataFrame\conf.xml)。
    • [マップ サービス キャッシュ タイル スキーマの生成 (Generate Map Server Cache Tiling Scheme)] ツールを使用して、独自のタイル スキーマ ファイルを生成します。

  • このツールからの出力フィーチャクラスは、[ラベル → タイル分割されたアノテーション (Tiled Labels to Annotation)] ツールで入力として使用できます。

  • [タイルを座標系の水平線上にクリップ] パラメーターで、特定の地理座標系または投影座標系の有効使用領域を、座標系の水平線として指定します。

パラメーター

ラベル説明データ タイプ
入力マップ

使用する現在のマップ。

Map
タイル スキーマ

定義済みタイル スキーマの .xml ファイル。

File
出力フィーチャクラス

出力ポリゴン フィーチャクラス。

Feature Class
マップ範囲と重なるポリゴンの生成

タイル スキーマ範囲全体にポリゴン フィーチャを作成するか、それともマップの全範囲と交差するタイルのみにポリゴン フィーチャを作成するかを選択します。

  • オン - マップの全範囲にポリゴン フィーチャを作成します。 これがデフォルトです。
  • オフ - タイル スキーマの全範囲にポリゴン フィーチャを作成します。
Boolean
タイルを座標系の水平線上にクリップ

マップの地理座標系、または投影座標系のどちらの有効使用領域に対して、ポリゴンを拘束するかを指定します。

  • オン - マップの地理座標系、または投影座標系の有効使用領域内にのみ、ポリゴン フィーチャを作成します。 タイル スキーマの範囲の内側 (ただし、座標系の水平線の範囲よりも外側) のタイルが、クリップ対象になります。 これがデフォルトです。
  • オフ - タイル スキーマの全範囲にポリゴン フィーチャを作成します。 各縮尺レベル内でポリゴンは一定のサイズになり、座標系の水平線ではクリップされません。 この結果、地理座標系または投影座標系の有効使用領域より外側に、データが作成されることがあります。 タイル スキーマ内の縮尺に基づいて生成されたタイルが、フィーチャクラスの空間ドメインに比べて大規模な場合、そのフィーチャに対しては NULL ジオメトリが作成されます。
Boolean
アンチエイリアスが有効化されたマップ サービス キャッシュと一致するポリゴンを生成
(オプション)

アンチエイリアスが有効化されたマップ サービス キャッシュと一致するポリゴンを、生成するかどうかを指定します。 マップ サービス キャッシュのスーパータイルのサイズは 2048 x 2048 ピクセル (アンチエイリアスを使用)、または 4096 x 4096 ピクセル (アンチエイリアスを不使用) です。 アンチエイリアスが既存のキャッシュで使用されているかどうかを確認するには、conf.xml というタイル スキーマ ファイルを開いて、<Antialiasing> タグが true に設定されているかどうかを確認します。

  • オン - アンチエイリアスが有効化されたマップ サービス キャッシュのスーパータイル範囲と一致するように、ポリゴン タイルを生成します。
  • オフ - アンチエイリアスが有効化されていないマップ サービス キャッシュのスーパータイル範囲と一致するように、ポリゴン タイルを生成します。 これがデフォルトです。
Boolean
縮尺
(オプション)

ポリゴンを作成する縮尺レベル。 これらの縮尺レベルは、入力タイル スキーマの縮尺レベルに基づいて自動的に設定されます。 タイル スキーマに収録されている縮尺レベルの全部、または一部のみに対してポリゴンを作成できます。 しかし、別途に縮尺レベルを追加する場合は、タイル スキーマ ファイルを変更するか、新規に作成する必要があります。このツールでは [値の追加] ボタンは無効になるためです。

Double

arcpy.cartography.MapServerCacheTilingSchemeToPolygons(input_map, tiling_scheme, output_feature_class, use_map_extent, clip_to_horizon, {antialiasing}, {levels})
名前説明データ タイプ
input_map

使用する現在のマップ。

Map
tiling_scheme

定義済みタイル スキーマの .xml ファイル。

File
output_feature_class

出力ポリゴン フィーチャクラス。

Feature Class
use_map_extent

タイル スキーマ範囲全体にポリゴン フィーチャを作成するか、それともマップの全範囲と交差するタイルのみにポリゴン フィーチャを作成するかを選択します。

  • USE_MAP_EXTENTマップの全範囲にポリゴン フィーチャを作成します。 これがデフォルトです。
  • FULL_TILING_SCHEMEタイル スキーマの全範囲にポリゴン フィーチャを作成します。
Boolean
clip_to_horizon

マップの地理座標系、または投影座標系のどちらの有効使用領域に対して、ポリゴンを拘束するかを指定します。

  • CLIP_TO_HORIZONマップの地理座標系、または投影座標系の有効使用領域内にのみ、ポリゴン フィーチャを作成します。 タイル スキーマの範囲の内側 (ただし、座標系の水平線の範囲よりも外側) のタイルが、クリップ対象になります。 これがデフォルトです。
  • UNIFORM_TILE_SIZEタイル スキーマの全範囲にポリゴン フィーチャを作成します。 各縮尺レベル内でポリゴンは一定のサイズになり、座標系の水平線ではクリップされません。 この結果、地理座標系または投影座標系の有効使用領域より外側に、データが作成されることがあります。 タイル スキーマ内の縮尺に基づいて生成されたタイルが、フィーチャクラスの空間ドメインに比べて大規模な場合、そのフィーチャに対しては NULL ジオメトリが作成されます。
Boolean
antialiasing
(オプション)

アンチエイリアスが有効化されたマップ サービス キャッシュと一致するポリゴンを、生成するかどうかを指定します。 マップ サービス キャッシュのスーパータイルのサイズは 2048 x 2048 ピクセル (アンチエイリアスを使用)、または 4096 x 4096 ピクセル (アンチエイリアスを不使用) です。 アンチエイリアスが既存のキャッシュで使用されているかどうかを確認するには、conf.xml というタイル スキーマ ファイルを開いて、<Antialiasing> タグが true に設定されているかどうかを確認します。

  • ANTIALIASINGアンチエイリアスが有効化されたマップ サービス キャッシュのスーパータイル範囲と一致するように、ポリゴン タイルを生成します。
  • NONEアンチエイリアスが有効化されていないマップ サービス キャッシュのスーパータイル範囲と一致するように、ポリゴン タイルを生成します。 これがデフォルトです。
Boolean
levels
[level,...]
(オプション)

ポリゴンを作成する縮尺レベル。 タイル スキーマに収録されているすべての縮尺レベルでポリゴンを作成する場合は、このパラメーターを空白のままにしてください。 タイル スキーマに収録されている縮尺レベルの全部、または一部のみに対してポリゴンを作成できます。 しかし、別途に縮尺レベルを追加する場合は、タイル スキーマ ファイルを変更するか、新規に作成する必要があります。

Double

コードのサンプル

MapServerCacheTilingSchemeToPolygons (マップ サービス キャッシュ タイル スキーマ → ポリゴン) の例 1 (Python ウィンドウ)

次のスタンドアロン スクリプトで、MapServerCacheTilingSchemeToPolygons 関数を使用する方法を示します。


import arcpy
import os

arcpy.env.workspace = "C:/data/data.gdb"
arcpy.MapServerCacheTilingSchemeToPolygons_cartography(
      "C:/data/Annotation.mxd", os.path.join(arcpy.GetInstallInfo()['InstallDir'], 
                                             'Resources\\TilingSchemes\\WGS84_Geographic_Coordinate_System_V2.xml'), 
      "Tiles", "USE_MAP_EXTENT", "CLIP_TO_HORIZON", "NONE")
MapServerCacheTilingSchemeToPolygons (マップ サービス キャッシュ タイル スキーマ → ポリゴン) の例 2 (ワークフロー スクリプト)

次のスクリプトは、MapServerCacheTilingSchemeToPolygons 関数と TiledLabelsToAnnotation 関数を使用するワークフローを示しています。

# Name: MapServerCacheTilingSchemeToPolygons_Example2.py
# Description: Create a tile feature class and use those tiles to create annotation.
# Requirements: ArcGIS Desktop Advanced license

# Import system modules
import arcpy
import os

# Set environment settings
arcpy.env.workspace = "C:/data/data.gdb"

# Set local variables
inMapDocument = "C:/data/Annotation.mxd"
# Change path below to match your system
inTilingScheme = os.path.join(arcpy.GetInstallInfo()['InstallDir'], 
                              'Resources\\TilingSchemes\\ArcGIS_Online_Bing_Maps_Google_Maps.xml'),
outFeatureClass = "C:/data/data.gdb/Tiles"
inTileExtent = "USE_MAP_EXTENT"
inClipping = "CLIP_TO_HORIZON"
inAntialiasing = "NONE"
inScales = ""

# Execute MapServerCacheTilingSchemeToPolygons
arcpy.MapServerCacheTilingSchemeToPolygons_cartography(
    inMapDocument, inTilingScheme, outFeatureClass, 
    inTileExtent, inClipping, inAntialiasing, inScales)

# Set local variables
inMapDocument = "C:/data/Annotation.mxd"
inPolygonIndexLayer = "Tiles"
inOutGeodatabase = "C:/data/data.gdb"
outOutLayer = "GroupAnno"
inAnnoSuffix = "Anno"
inRefScaleValue = ""
inRefScaleField = "Tile_Scale"
inTileIDField = "OID"
inCoordSysField = ""
inMapRotationField = ""
inFeatureLinked = "STANDARD"
inGenerateUnplaced = "GENERATE_UNPLACED_ANNOTATION"

# Execute TiledLabelsToAnnotation
arcpy.TiledLabelsToAnnotation_cartography(
    inMapDocument, inPolygonIndexLayer, inOutGeodatabase, 
    outOutLayer, inAnnoSuffix, inRefScaleValue, inRefScaleField, 
    inTileIDField, inCoordSysField, inMapRotationField,inFeatureLinked, 
    inGenerateUnplaced)

環境

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

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック