ラベル → タイル分割されたアノテーション (Tiled Labels To Annotation) (カートグラフィ)—ArcGIS Pro

サマリー

ポリゴンインデックスレイヤーを基にして、ラベルをマップ内のレイヤーのアノテーションに変換します。

このツールでは、マップを複数のタイルに分割してから、各タイルのアノテーションを作成します。この方法は、多数のラベルをアノテーションに変換するときに便利です。ポリゴンインデックスレイヤーは、[マップサービスキャッシュタイルスキーマ → ポリゴン (Map Server Cache Tiling Scheme To Polygons)] ツールまたは [インデックスフィーチャ (格子状) の作成 (Grid Index Features)] ツール、あるいはアノテーションを作成する領域が含まれる任意のポリゴンフィーチャクラスを使用して生成されます。

使用法

ラベルを、単一レイヤーまたはマップ全体のアノテーションに変換できます。単一レイヤーのオプションを選択した場合、マップ内にあるレイヤーを指定する必要があります。
ラベルクラスの縮尺範囲が考慮されます。このツールで特定の基準縮尺のアノテーションを作成すると、その縮尺で表示がオンになっているラベルクラスのみが変換されます。
注意:
ラベルクラスの縮尺範囲は、ArcGIS Pro のレイヤーのプロパティで設定します。ラベルのプロパティを設定した後は、プロジェクトを保存してからこのツールを実行してください。
このツールを実行する前にタイルを選択すると、選択したタイルのみに対してアノテーションが作成されます。
ポリゴンインデックスレイヤー内の一部のタイルのみに対してアノテーションを更新するには、初めに、該当する TileID フィールドの値を持つアノテーションフィーチャを選択して削除します。次にポリゴンフィーチャを選択してツールを実行します。
このツールの出力の 1 つは、一連のグループレイヤーになります。 1 つのグループレイヤーには、アノテーションの作成対象となった各基準縮尺のグループレイヤーが含まれます。
[カタログ] ウィンドウか ModelBuilder で作業しているときに、[レイヤーファイルの保存 (Save To Layer File)] ツールを使用して出力グループレイヤーをレイヤーファイルに書き込むことができます。
同じレイヤー名が指定されるか、出力の上書きが明示的に許可された場合は、既存のグループレイヤーが上書きされます。
マップ内でフィーチャクラス名の重複が見つかった場合は、フィーチャクラス名に続くアノテーションに数字が追加されます (たとえば、Cities01Anno10000、Cities02Anno10000)。
アノテーションフィーチャクラスは、既存の接尾辞を指定しても上書きされません。その場合、アノテーションフィーチャクラスの接尾辞に数字が追加されます (たとえば、CitiesAnno10000、CitiesAnno10000_1 など)。
アノテーションフィーチャクラスの基準縮尺は、次のいずれかの方法で指定できます。
- ポリゴンインデックスレイヤーのフィールドを使用して、出力アノテーションフィーチャクラスの基準縮尺を決定します。この方法は、さまざまな縮尺レベルに対してアノテーションを作成する場合に使用します。
- 基準縮尺の値を明示的に指定します。すべてのアノテーションフィーチャクラスでこの基準縮尺が使用されます。基準縮尺がマップで設定されている場合は、その縮尺がツールに入力されるデフォルト値になります。基準縮尺がマップで設定されていない場合は、現在の縮尺がデフォルト値になります。
[マップサービスキャッシュタイルスキーマ → ポリゴン (Map Server Cache Tiling Scheme To Polygons)] ツールで作成したポリゴンインデックスレイヤーを使用している場合は、[基準縮尺フィールド] パラメーター値の Tile_Scale フィールドを使用します。レイヤーと Tile_Scale の組み合わせごとにアノテーションフィーチャクラスが作成されます。
異なる基準縮尺でアノテーションを作成する場合は、縮尺ごとにマップを設計し、基準縮尺を設定しないでください。
ポリゴンインデックスレイヤーの座標系フィールドが指定されている場合は、描画および配置の目的で、各タイルのアノテーションがその座標系に投影されます。
[フィーチャリンクアノテーションの作成] パラメーターがオフである場合、[ラベルをすべてのレイヤーから単一の出力フィーチャクラスに変換] パラメーターを使用して、マップ全体の単一のアノテーションフィーチャクラスを作成できます。
マップの単一のアノテーションフィーチャクラスを作成する場合、[類似するラベルクラスのマージ] パラメーターを使用して、類似するプロパティを持つラベルクラスを 1 つのアノテーションクラスにマージできます。
フィーチャリンクアノテーションは、ジオデータベースの別のフィーチャクラスに含まれている特定のフィーチャに関連付けられます。フィーチャリンクアノテーションフィーチャクラスを作成すると、リレーションシップクラスも自動的に生成されます。
フィーチャリンクアノテーションを作成するときは、出力ワークスペースを、リンク先のフィーチャクラスと同じものにする必要があります。
表示スペースが不足しているために、一部のラベルがマップ上に表示されない場合があります。これらのラベルを変換するには、[未配置アノテーションの生成] チェックボックスをオンにします。これにより、アノテーションフィーチャクラスの未配置のラベルを保存して、後から編集セッションで一度に配置することができます。
Memory ワークスペースと in_memory ワークスペースは、フィーチャリンクアノテーションをサポートしていません。
このツールは「アノテーションテキスト文字列フィールド長環境」に従います。設定すると、データベースで作成されたすべてのアノテーションフィーチャクラスの TextString フィールドでデフォルトのフィールド長をオーバーライドします。

パラメーター

ラベル	説明	データタイプ
入力マップ	アノテーションに変換するラベルが含まれるマップ。	Map
ポリゴンインデックスレイヤー	タイルフィーチャが含まれるポリゴンレイヤー。	Table View
出力ジオデータベース	出力フィーチャクラスが保存されるワークスペース。ワークスペースには、既存のジオデータベースまたは既存のフィーチャデータセットを指定できます。	Workspace; Feature Dataset
出力レイヤー	作成されるアノテーションを格納するグループレイヤー。 [レイヤーファイルの保存 (Save To Layer File)] ツールを使用して出力グループレイヤーをレイヤーファイルに書き込むことができます。	Group Layer
アノテーション接尾辞	新しいアノテーションフィーチャクラスのそれぞれに追加される接尾辞。この接尾辞は、新しいアノテーションフィーチャクラスのそれぞれのソースフィーチャクラスの名前に追加されます。この接尾辞の後に、アノテーションの基準縮尺が続きます。	String
基準縮尺値 (オプション)	アノテーションの基準として使用される縮尺値。これは、アノテーション内のすべてのシンボルサイズとテキストサイズの基準になる縮尺です。	Double
基準縮尺フィールド (オプション)	アノテーションの基準縮尺を決定するポリゴンインデックスレイヤーのフィールド。これは、アノテーション内のすべてのシンボルサイズとテキストサイズの基準になる縮尺です。	Field
タイル ID フィールド (オプション)	タイル分割された領域を一意に識別するポリゴンインデックスレイヤー内のフィールド。この値は、アノテーションフィーチャクラスの属性テーブルの「TileID」フィールドに入力されます。	Field
座標系フィールド (オプション)	各タイルの座標系情報が格納されるポリゴンインデックスレイヤーのフィールド。座標系情報を保存するフィールドには特定の長さが必要になるため、座標系フィールドが格納されるポリゴンインデックスレイヤーはジオデータベースのフィーチャクラスにする必要があります。	Field
マップの角度フィールド (オプション)	マップの回転に使用する角度が格納されるポリゴンインデックスレイヤーのフィールド。	Field
フィーチャリンクアノテーションの作成 (オプション)	出力アノテーションフィーチャクラスが別のフィーチャクラスのフィーチャにリンクされるかどうかを指定します。オフ - 出力アノテーションフィーチャクラスは別のフィーチャクラスのフィーチャにリンクされません。これがデフォルトです。オン - 出力アノテーションフィーチャクラスは別のフィーチャクラスのフィーチャにリンクされます。	Boolean
未配置ラベルをアノテーションに変換 (オプション)	未配置アノテーションが未配置ラベルから作成されるかどうかを指定します。オフ - 現在ラベルが配置されているフィーチャにのみアノテーションが作成されます。これがデフォルトです。オン - 未配置アノテーションがアノテーションフィーチャクラスに格納されます。このアノテーションのステータスフィールドは未配置に設定されます。	Boolean
変換 (オプション)	アノテーションがマップ内のすべてのレイヤーに対して変換されるのか、それとも単一レイヤーに対して変換されるのかを指定します。単一レイヤーを指定する必要があります。マップ内のすべてのレイヤー—ラベルが、マップ内のすべてのレイヤーのアノテーションに変換されます。これがデフォルトです。単一レイヤー—ラベルが、単一レイヤーのアノテーションに変換されます。レイヤーを指定する必要があります。	String
フィーチャレイヤー (オプション)	[変換] パラメーターが [単一レイヤー] に設定されている場合に変換されるアノテーションを含むレイヤー。このレイヤーがマップ内にある必要があります。	Feature Layer
シンボルテーブルからシンボルを選択 (オプション)	すべてのテキストシンボルプロパティを編集できるかどうかを指定します。オフ - すべてのテキストシンボルプロパティを編集できます。これがデフォルトです。オン - アノテーションフィーチャを有効化するシンボルプロパティのみを、コレクション内の関連先のテキストシンボルへの参照を維持するように編集できます。	Boolean
新規フィーチャの追加時にアノテーションを作成 (オプション)	[フィーチャリンクアノテーションの作成] パラメーターをオンにした場合、新しいフィーチャがリンクされたフィーチャクラスに追加されたときにアノテーションを作成するかどうかを指定します。オン - 新しいフィーチャがリンクされたフィーチャクラスに追加されたときに、フィーチャリンクアノテーションが作成されます。これがデフォルトです。オフ - 新しいフィーチャがリンクされたフィーチャクラスに追加されたときに、フィーチャリンクアノテーションが作成されません。	Boolean
フィーチャの形状が変更される際にアノテーションを更新 (オプション)	[フィーチャリンクアノテーションの作成] パラメーターがオンになっている場合に、リンクされたフィーチャの形状が変更されたときにアノテーションの位置を更新するかどうかを指定します。オン - リンクされたフィーチャの形状が変更されたときにアノテーションの位置を更新します。これがデフォルトです。オフ - リンクされたフィーチャの形状が変更されたときにアノテーションの位置を更新しません。	Boolean
ラベルをすべてのレイヤーから単一の出力フィーチャクラスに変換 (オプション)	ラベルを個別のアノテーションフィーチャクラスまたは単一のアノテーションフィーチャクラスのいずれに変換するかを指定します。単一のアノテーションフィーチャクラスに変換する場合、アノテーションをフィーチャリンクにすることはできません。オン - すべてのレイヤーのラベルが、単一のアノテーションフィーチャクラスに変換されます。オフ - ラベルが、それらのレイヤーに対応する個別のアノテーションフィーチャクラスに変換されます。これがデフォルトです。	Boolean
類似するラベルクラスのマージ (オプション)	[ラベルをすべてのレイヤーから単一の出力フィーチャクラスに変換] パラメーターをオンにした場合に、類似するラベルクラスをマージするかどうかを指定します。オン - 単一のフィーチャクラスに変換するときに、類似するプロパティを持つラベルクラスがマージされます。オフ - 類似するプロパティを持つラベルクラスはマージされません。これがデフォルトです。	Boolean

派生した出力

ラベル	説明	データタイプ
出力ジオデータベース	出力フィーチャクラスが保存されるワークスペース。	Workspace; Feature Dataset

arcpy.cartography.TiledLabelsToAnnotation(input_map, polygon_index_layer, out_geodatabase, out_layer, anno_suffix, {reference_scale_value}, {reference_scale_field}, {tile_id_field}, {coordinate_sys_field}, {map_rotation_field}, {feature_linked}, {generate_unplaced_annotation}, {which_layers}, {single_layer}, {require_symbol_id}, {auto_create}, {update_on_shape_change}, {multiple_feature_classes}, {merge_label_classes})

名前	説明	データタイプ
input_map	アノテーションに変換するラベルが含まれるマップ。	Map
polygon_index_layer	タイルフィーチャが含まれるポリゴンレイヤー。	Table View
out_geodatabase	出力フィーチャクラスが保存されるワークスペース。ワークスペースには、既存のジオデータベースまたは既存のフィーチャデータセットを指定できます。	Workspace; Feature Dataset
out_layer	作成されるアノテーションを格納するグループレイヤー。 [レイヤーファイルの保存 (Save To Layer File)] ツールを使用して出力グループレイヤーをレイヤーファイルに書き込むことができます。	Group Layer
anno_suffix	新しいアノテーションフィーチャクラスのそれぞれに追加される接尾辞。この接尾辞は、新しいアノテーションフィーチャクラスのそれぞれのソースフィーチャクラスの名前に追加されます。この接尾辞の後に、アノテーションの基準縮尺が続きます。	String
reference_scale_value (オプション)	アノテーションの基準として使用される縮尺値。これは、アノテーション内のすべてのシンボルサイズとテキストサイズの基準になる縮尺です。	Double
reference_scale_field (オプション)	アノテーションの基準縮尺を決定するポリゴンインデックスレイヤーのフィールド。これは、アノテーション内のすべてのシンボルサイズとテキストサイズの基準になる縮尺です。	Field
tile_id_field (オプション)	タイル分割された領域を一意に識別するポリゴンインデックスレイヤー内のフィールド。この値は、アノテーションフィーチャクラスの属性テーブルの「TileID」フィールドに入力されます。	Field
coordinate_sys_field (オプション)	各タイルの座標系情報が格納されるポリゴンインデックスレイヤーのフィールド。座標系情報を保存するフィールドには特定の長さが必要になるため、座標系フィールドが格納されるポリゴンインデックスレイヤーはジオデータベースのフィーチャクラスにする必要があります。	Field
map_rotation_field (オプション)	マップの回転に使用する角度が格納されるポリゴンインデックスレイヤーのフィールド。	Field
feature_linked (オプション)	出力アノテーションフィーチャクラスが別のフィーチャクラスのフィーチャにリンクされるかどうかを指定します。 STANDARD—出力アノテーションフィーチャクラスは別のフィーチャクラスのフィーチャにリンクされません。これがデフォルトです。 FEATURE_LINKED—出力アノテーションフィーチャクラスは別のフィーチャクラスのフィーチャにリンクされます。	Boolean
generate_unplaced_annotation (オプション)	未配置アノテーションが未配置ラベルから作成されるかどうかを指定します。 NOT_GENERATE_UNPLACED_ANNOTATION—アノテーションは、現在ラベルが配置されているフィーチャに対してのみ作成されます。これがデフォルトです。 GENERATE_UNPLACED_ANNOTATION—未配置アノテーションがアノテーションフィーチャクラスに格納されます。このアノテーションのステータスフィールドは未配置に設定されます。	Boolean
which_layers (オプション)	アノテーションがマップ内のすべてのレイヤーに対して変換されるのか、それとも単一レイヤーに対して変換されるのかを指定します。単一レイヤーを指定する必要があります。 ALL_LAYERS—ラベルが、マップ内のすべてのレイヤーのアノテーションに変換されます。これがデフォルトです。 SINGLE_LAYER—ラベルが、単一レイヤーのアノテーションに変換されます。レイヤーを指定する必要があります。	String
single_layer (オプション)	which_layers パラメーターが SINGLE_LAYER に設定されている場合に変換されるアノテーションを含むレイヤー。このレイヤーがマップ内にある必要があります。	Feature Layer
require_symbol_id (オプション)	すべてのテキストシンボルプロパティを編集できるかどうかを指定します。 NO_REQUIRE_ID—すべてのテキストシンボルプロパティを編集できます。これがデフォルトです。 REQUIRE_ID—アノテーションフィーチャを有効化するシンボルプロパティのみを、コレクション内の関連先のテキストシンボルへの参照を維持するように編集できます。	Boolean
auto_create (オプション)	feature_linked パラメーターを FEATURE_LINKED に設定した場合、新しいフィーチャがリンクされたフィーチャクラスに追加されたときにアノテーションを作成するかどうかを指定します。 AUTO_CREATE—新しいフィーチャがリンクされたフィーチャクラスに追加されたときに、フィーチャリンクアノテーションが作成されます。これがデフォルトです。 NO_AUTO_CREATE—新しいフィーチャがリンクされたフィーチャクラスに追加されたときに、フィーチャリンクアノテーションが作成されません。	Boolean
update_on_shape_change (オプション)	feature_linked パラメーターが FEATURE_LINKED に設定されている場合に、リンクされたフィーチャの形状が変更されたときにアノテーションの位置を更新するかどうかを指定します。 SHAPE_UPDATE—リンクされたフィーチャの形状が変更されたときにアノテーションの位置を更新します。これがデフォルトです。 NO_SHAPE_UPDATE—リンクされたフィーチャの形状が変更されたときにアノテーションの位置を更新しません。	Boolean
multiple_feature_classes (オプション)	ラベルを個別のアノテーションフィーチャクラスまたは単一のアノテーションフィーチャクラスのいずれに変換するかを指定します。単一のアノテーションフィーチャクラスに変換する場合、アノテーションをフィーチャリンクにすることはできません。 SINGLE_FEATURE_CLASS—すべてのレイヤーのラベルが、単一のアノテーションフィーチャクラスに変換されます。 FEATURE_CLASS_PER_FEATURE_LAYER—ラベルが、それらのレイヤーに対応する個別のアノテーションフィーチャクラスに変換されます。これがデフォルトです。	Boolean
merge_label_classes (オプション)	multiple_feature_classes パラメーターを SINGLE_FEATURE_CLASS に設定した場合に、類似するラベルクラスをマージするかどうかを指定します。 MERGE_LABEL_CLASS—単一のフィーチャクラスに変換するときに、類似するプロパティを持つラベルクラスがマージされます。 NO_MERGE_LABEL_CLASS—類似するプロパティを持つラベルクラスはマージされません。これがデフォルトです。	Boolean

派生した出力

名前	説明	データタイプ
out_workspace	出力フィーチャクラスが保存されるワークスペース。	Workspace; Feature Dataset

コードのサンプル

TiledLabelsToAnnotation の例 (Python ウィンドウ)

ポリゴンインデックスレイヤーを基にして、ラベルをマップ内の単一レイヤーのアノテーションに変換する TiledLabelsToAnnotation 関数の Python サンプルです。

import arcpy
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.cartography.TiledLabelsToAnnotation("Map1", "Tiles", "data.gdb", 
                                          "GroupAnno", "Anno", "", "Tile_Scale",  
                                          "OID", "", "", "FEATURE_LINKED", 
                                          "GENERATE_UNPLACED_ANNOTATION", 
                                          "SINGLE_LAYER", "Towns", 
																																										"REQUIRE_ID", "AUTO_CREATE", 
                                          "SHAPE_UPDATE", "", "")

TiledLabelsToAnnotation の例 2 (ワークフロースクリプト)

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

# Name: TiledLabelsToAnnotation_Example2.py
# Description: Create a tile feature class and use those tiles to create annotation.

# Import system modules
import arcpy
import os

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

# Set local variables
aprx = arcpy.mp.ArcGISProject(r"C:/data/Annotation.aprx")
inMap = aprx.listMaps("Map")[0]
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 = []

# Run MapServerCacheTilingSchemeToPolygons
arcpy.cartographyMapServerCacheTilingSchemeToPolygons(
    inMap, inTilingScheme, outFeatureClass, inTileExtent, inClipping, 
    inAntialiasing, inScales)

# Set local variables
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"
inWhichLayers = "ALL_LAYERS"
inSingleLayer = ""
inRequireSymbolID = ""
inAutoCreate = ""
inUpdateOnShapeChange = ""
inMultipleFeatureClasses = "SINGLE_FEATURE_CLASS"
inMergeFeatureClasses = "MERGE_LABEL_CLASS"
 
# Run TiledLabelsToAnnotation
arcpy.cartography.TiledLabelsToAnnotation(
    inMap, inPolygonIndexLayer, inOutGeodatabase, outOutLayer, inAnnoSuffix, 
    inRefScaleValue, inRefScaleField, inTileIDField, inCoordSysField, 
    inMapRotationField, inFeatureLinked, inGenerateUnplaced, inWhichLayers, 
    inSingleLayer, inRequireSymbolID, inAutoCreate, inUpdateOnShapeChange, 
    inMultipleFeatureClasses, inMergeFeatureClasses)

環境

基準縮尺, アノテーションのテキスト文字列フィールド長

ライセンス情報

Basic: Yes
Standard: Yes
Advanced: Yes

サマリー

使用法

注意:

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容