ラベルをアノテーションに変換 (Convert Labels To Annotation) (カートグラフィ)—ArcGIS Pro

サマリー

ラベルを単一レイヤーまたはマップ全体のアノテーションに変換します。標準アノテーションおよびフィーチャリンクアノテーションの両方を作成できます。

使用法

ラベルを、単一レイヤーまたはマップ全体のアノテーションに変換できます。単一レイヤーのオプションを選択した場合、マップ内にあるレイヤーを指定する必要があります。
ラベルクラスの縮尺範囲が考慮されます。このツールで特定の縮尺のアノテーションを作成すると、その縮尺で表示がオンになっているラベルクラスのみが変換されます。
注意:
ラベルクラスの縮尺範囲は、ArcGIS Pro の [ラベリング] タブで設定します。
アノテーションフィーチャクラスは、既存の接尾辞を指定しても上書きされません。その場合、アノテーションフィーチャクラスの接尾辞に数字が追加されます (CitiesAnno、CitiesAnno_1 など)。名前の完全な形式は次のとおりです。
<layer name> <duplicate feature class count> <anno suffix> <running number>
異なる基準縮尺でアノテーションを作成する場合は、縮尺ごとにマップを設計し、マップには基準縮尺を設定しないでください。縮尺ごとにラベルをアノテーションに変換し、適切な名前 (CitiesAnno_1000、CitiesAnno_100000 など) を付けることができます。
このツールの 1 つの出力はグループレイヤーです。 [カタログ] ウィンドウ、[Python] ウィンドウ、またはスタンドアロン Python スクリプトで作業している場合、[レイヤーファイルの保存 (Save To Layer File)] ツールを使用して出力グループレイヤーをレイヤーファイルに書き込むことができます。 ArcGIS Pro を使用している場合、このツールはグループレイヤーを表示に追加します。作成されるグループレイヤーは一時的なもので、プロジェクトを保存しない限り、セッションの終了後は維持されません。
同じレイヤー名が指定され、出力の上書きが明示的に許可されている場合、既存のグループレイヤーが上書きされます。
[フィーチャリンクアノテーションの作成] パラメーターがオフである場合、[ラベルをすべてのレイヤーから単一の出力フィーチャクラスに変換] パラメーターを使用して、マップ全体の単一のアノテーションフィーチャクラスを作成できます。
マップの単一のアノテーションフィーチャクラスを作成する場合、[類似するラベルクラスのマージ] パラメーターを使用して、類似するプロパティを持つラベルクラスを 1 つのアノテーションクラスにマージできます。
フィーチャリンクアノテーションは、ジオデータベースの別のフィーチャクラスに含まれている特定のフィーチャに関連付けられます。 [フィーチャリンクアノテーションの作成] パラメーターをオンにした場合、出力アノテーションフィーチャクラスを作成するときに、リレーションシップクラスが自動的に生成されます。
フィーチャリンクアノテーションを作成するときは、出力ワークスペースを、リンク先のフィーチャクラスと同じものにする必要があります。
表示スペースが不足しているために、一部のラベルがマップ上に表示されない場合があります。これらのラベルを変換するには、[未配置ラベルをアノテーションに変換] パラメーターをオンにします。これにより、アノテーションフィーチャクラスの未配置のラベルを保存して、後から ArcGIS Pro の編集セッションで一度に配置することができます。
メモリワークスペースと in_memory ワークスペースは、フィーチャリンクアノテーションをサポートしていません。
このツールはアノテーションテキスト文字列フィールド長環境に従います。設定すると、データベースで作成されたすべてのアノテーションフィーチャクラスの TextString フィールドでデフォルトのフィールド長をオーバーライドします。

パラメーター

ラベル	説明	データタイプ
入力マップ	入力マップ。	Map
変換縮尺	ラベル変換時の縮尺。マップで基準縮尺が設定されている場合、その基準縮尺がシンボルサイズ設定およびアノテーションフィーチャクラス作成に使用されますが、この縮尺で変換が発生します。	Double
出力ジオデータベース	出力フィーチャクラスが保存されるワークスペース。ワークスペースには、既存のジオデータベースまたは既存のフィーチャデータセットを指定できます。このワークスペースが、マップ内のすべてのレイヤーによって使用されているのと同じデータベースではない場合、フィーチャリンクオプションが無効になります。	Workspace; Feature Dataset
アノテーション接尾辞 (オプション)	新しいアノテーションフィーチャクラスのそれぞれに追加される接尾辞。この接尾辞は、新しいアノテーションフィーチャクラスのそれぞれのソースフィーチャクラスの名前に追加されます。	String
範囲 (オプション)	アノテーションに変換するラベルが含まれる範囲を指定します。 [現在の表示範囲] - 範囲は、アクティブなマップまたはシーンに基づきます。このオプションは、アクティブなマップが存在する場合にのみ使用できます。 [レイヤーの範囲] - 範囲は、アクティブなマップレイヤーに基づきます。ドロップダウンリストを使用して使用可能なレイヤーを選択するか、[すべてのレイヤーのデータの範囲] オプションを使用して、ベースマップを除くすべてのアクティブなマップレイヤーを組み合わせた範囲を取得します。このオプションは、レイヤーを含むアクティブなマップが存在する場合にのみ使用できます。 [参照] - 範囲は、既存のデータに基づきます。 [入力データの共通領域] - 範囲は、すべての入力データの最小範囲または共通範囲に基づきます。重なり合う入力データがない場合は、すべてゼロの null 範囲が生成されます。 [入力データのすべての領域] - この範囲は、すべての入力データの最大範囲または結合された範囲に基づきます。 [範囲をリセット] - 範囲はデフォルト値にリセットされます。手動入力した座標値 - 座標値は数値であり、アクティブなマップの座標系で表示する必要があります。マップで異なる表示単位が使用されていることがあります	Extent
未配置ラベルをアノテーションに変換 (オプション)	未配置アノテーションが未配置ラベルから作成されるかどうかを指定します。オフ - 現在ラベルが配置されているフィーチャにのみアノテーションが作成されます。これがデフォルトです。オン - 未配置アノテーションがアノテーションフィーチャクラスに格納されます。これらのアノテーションのステータスフィールドは [未配置] に設定されます。	Boolean
シンボルテーブルからシンボルを選択 (オプション)	編集可能なテキストシンボルプロパティが制限されるかどうかを指定します。オフ - すべてのテキストシンボルプロパティを編集できます。これがデフォルトです。オン - アノテーションフィーチャを有効化するシンボルプロパティのみを、コレクション内の関連先のテキストシンボルへの参照を維持するように編集できます。	Boolean
フィーチャリンクアノテーションの作成 (オプション)	注意: このパラメーターは ArcGIS Desktop Standard および ArcGIS Desktop Advanced ライセンスでのみ利用可能です。出力アノテーションフィーチャクラスが別のフィーチャクラスのフィーチャにリンクされるかどうかを指定します。オフ - 出力アノテーションフィーチャクラスは別のフィーチャクラスのフィーチャにリンクされません。これがデフォルトです。オン - 出力アノテーションフィーチャクラスは別のフィーチャクラスのフィーチャにリンクされます。	Boolean
新規フィーチャの追加時にアノテーションを作成 (オプション)	[フィーチャリンクアノテーションの作成] パラメーターをオンにした場合、新しいフィーチャがリンクされたフィーチャクラスに追加されたときにアノテーションを作成するかどうかを指定します。オン - 新しいフィーチャがリンクされたフィーチャクラスに追加されたときに、フィーチャリンクアノテーションが作成されます。これがデフォルトです。オフ - 新しいフィーチャがリンクされたフィーチャクラスに追加されたときに、フィーチャリンクアノテーションが作成されません。	Boolean
フィーチャの形状が変更される際にアノテーションを更新 (オプション)	[フィーチャリンクアノテーションの作成] パラメーターをオンにした場合、リンクされたフィーチャの形状が更新されたときにアノテーションの位置を更新するかどうかを指定します。オン - リンクされたフィーチャの形状が変更されたときにアノテーションの位置を更新します。これがデフォルトです。オフ - リンクされたフィーチャの形状が変更されたときにアノテーションの位置を更新しません。	Boolean
出力レイヤー (オプション)	作成されるアノテーションを格納するグループレイヤー。 [カタログ] ウィンドウで作業しているときに、[レイヤーファイルの保存 (Save To Layer File)] ツールを使用して出力グループレイヤーをレイヤーファイルに書き込むことができます。 ArcGIS Pro を使用してマップを開いている場合は、ジオプロセシングオプションでこのオプションをオンにしておくと、ツールによってグループレイヤーが表示に追加されます。作成されるグループレイヤーは一時的なもので、プロジェクトを保存しない限り、セッションの終了後は維持されません。	Group Layer
変換 (オプション)	アノテーションがマップ内のすべてのレイヤーに対して変換されるのか、それとも単一レイヤーに対して変換されるのかを指定します。単一レイヤーを指定する必要があります。マップ内のすべてのレイヤー—ラベルが、マップ内のすべてのレイヤーのアノテーションに変換されます。これがデフォルトです。単一レイヤー—ラベルが、単一レイヤーのアノテーションに変換されます。レイヤーを指定する必要があります。	String
フィーチャレイヤー (オプション)	[変換] パラメーターが [単一レイヤー] に設定された場合に変換するアノテーションを含むレイヤー。このレイヤーがマップ内にある必要があります。	Feature Layer
ラベルをすべてのレイヤーから単一の出力フィーチャクラスに変換 (オプション)	ラベルを個別のアノテーションフィーチャクラスまたは単一のアノテーションフィーチャクラスのいずれに変換するかを指定します。単一のアノテーションフィーチャクラスに変換する場合、アノテーションをフィーチャリンクにすることはできません。オン - すべてのレイヤーのラベルが、単一のアノテーションフィーチャクラスに変換されます。オフ - ラベルが、それらのレイヤーに対応する個別のアノテーションフィーチャクラスに変換されます。これがデフォルトです。	Boolean
類似するラベルクラスのマージ (オプション)	[ラベルをすべてのレイヤーから単一の出力フィーチャクラスに変換] パラメーターをオンにした場合に、類似するラベルクラスをマージするかどうかを指定します。オン - [ラベルをすべてのレイヤーから単一の出力フィーチャクラスに変換] パラメーターをオンにした場合に、類似するプロパティを持つラベルクラスがマージされます。オフ - [ラベルをすべてのレイヤーから単一の出力フィーチャクラスに変換] パラメーターをオンにした場合に、ラベルクラスがマージされません。これがデフォルトです。	Boolean

派生した出力

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

arcpy.cartography.ConvertLabelsToAnnotation(input_map, conversion_scale, output_geodatabase, {anno_suffix}, {extent}, {generate_unplaced}, {require_symbol_id}, {feature_linked}, {auto_create}, {update_on_shape_change}, {output_group_layer}, {which_layers}, {single_layer}, {multiple_feature_classes}, {merge_label_classes})

名前	説明	データタイプ
input_map	入力マップ。	Map
conversion_scale	ラベル変換時の縮尺。マップで基準縮尺が設定されている場合、その基準縮尺がシンボルサイズ設定およびアノテーションフィーチャクラス作成に使用されますが、この縮尺で変換が発生します。	Double
output_geodatabase	出力フィーチャクラスが保存されるワークスペース。ワークスペースには、既存のジオデータベースまたは既存のフィーチャデータセットを指定できます。このワークスペースが、マップ内のすべてのレイヤーによって使用されているのと同じデータベースではない場合、フィーチャリンクオプションが無効になります。	Workspace; Feature Dataset
anno_suffix (オプション)	新しいアノテーションフィーチャクラスのそれぞれに追加される接尾辞。この接尾辞は、新しいアノテーションフィーチャクラスのそれぞれのソースフィーチャクラスの名前に追加されます。	String
extent (オプション)	アノテーションに変換するラベルが含まれる範囲を指定します。 MAXOF - すべての入力データの最大範囲が使用されます。 MINOF - すべての入力データに共通する最小領域が使用されます。 DISPLAY - 範囲は、表示範囲と同じになります。レイヤー名 - 指定されたレイヤーの範囲が使用されます。 Extent オブジェクト - 指定されたオブジェクトの範囲が使用されます。スぺース区切りの座標文字列 - 指定された文字列の範囲が使用されます。座標値は、x-min、y-min、x-max、y-max という順序で表記されます。範囲値が設定されていない場合、範囲はすべての関連する入力データの最大範囲に基づきます。これがデフォルトです。	Extent
generate_unplaced (オプション)	未配置アノテーションが未配置ラベルから作成されるかどうかを指定します。 ONLY_PLACED—アノテーションは、現在ラベルが配置されているフィーチャに対してのみ作成されます。これがデフォルトです。 GENERATE_UNPLACED—未配置アノテーションがアノテーションフィーチャクラスに格納されます。これらのアノテーションのステータスフィールドは [未配置] に設定されます。	Boolean
require_symbol_id (オプション)	編集可能なテキストシンボルプロパティが制限されるかどうかを指定します。 NO_REQUIRE_ID—すべてのテキストシンボルプロパティを編集できます。これがデフォルトです。 REQUIRE_ID—アノテーションフィーチャを有効化するシンボルプロパティのみを、コレクション内の関連先のテキストシンボルへの参照を維持するように編集できます。	Boolean
feature_linked (オプション)	ライセンス: このパラメーターは ArcGIS Desktop Standard および ArcGIS Desktop Advanced ライセンスでのみ利用可能です。出力アノテーションフィーチャクラスが別のフィーチャクラスのフィーチャにリンクされるかどうかを指定します。 STANDARD—出力アノテーションフィーチャクラスは別のフィーチャクラスのフィーチャにリンクされません。これがデフォルトです。 FEATURE_LINKED—出力アノテーションフィーチャクラスは別のフィーチャクラスのフィーチャにリンクされます。	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
output_group_layer (オプション)	作成されるアノテーションを格納するグループレイヤー。 [レイヤーファイルの保存 (Save To Layer File)] ツールを使用して出力グループレイヤーをレイヤーファイルに書き込むことができます。	Group Layer
which_layers (オプション)	アノテーションがマップ内のすべてのレイヤーに対して変換されるのか、それとも単一レイヤーに対して変換されるのかを指定します。単一レイヤーを指定する必要があります。 ALL_LAYERS—ラベルが、マップ内のすべてのレイヤーのアノテーションに変換されます。これがデフォルトです。 SINGLE_LAYER—ラベルが、単一レイヤーのアノテーションに変換されます。レイヤーを指定する必要があります。	String
single_layer (オプション)	which_layers パラメーターが SINGLE_LAYER に設定された場合に変換するアノテーションを含むレイヤー。このレイヤーがマップ内にある必要があります。	Feature Layer
multiple_feature_classes (オプション)	ラベルを個別のアノテーションフィーチャクラスまたは単一のアノテーションフィーチャクラスのいずれに変換するかを指定します。単一のアノテーションフィーチャクラスに変換する場合、アノテーションをフィーチャリンクにすることはできません。 SINGLE_FEATURE_CLASS—すべてのレイヤーのラベルが、単一のアノテーションフィーチャクラスに変換されます。 FEATURE_CLASS_PER_FEATURE_LAYER—ラベルが、それらのレイヤーに対応する個別のアノテーションフィーチャクラスに変換されます。これがデフォルトです。	Boolean
merge_label_classes (オプション)	multiple_feature_classes パラメーターを SINGLE_FEATURE_CLASS に設定した場合に、類似するラベルクラスをマージするかどうかを指定します。 MERGE_LABEL_CLASS—multiple_feature_classes パラメーターを SINGLE_FEATURE_CLASS に設定した場合に、類似するプロパティを持つラベルクラスがマージされます。 NO_MERGE_LABEL_CLASS—multiple_feature_classes パラメーターを SINGLE_FEATURE_CLASS に設定した場合に、ラベルクラスがマージされません。これがデフォルトです。	Boolean

派生した出力

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

コードのサンプル

ConvertLabelsToAnnotation (ラベルをアノテーションに変換) の例 (Python ウィンドウ)

ConvertLabelsToAnnotation 関数のこの Python サンプルは、ラベルをマップ内の単一レイヤーのアノテーションに変換します。


import arcpy
arcpy.cartography.ConvertLabelsToAnnotation(
    'Map1', 10000, 'D:/data/Cobourg.gdb', 'Anno', 'MAXOF', 'ONLY_PLACED', 
    'REQUIRE_ID', 'STANDARD', '', '', 'AnnoLayer', 'SINGLE_LAYER', 'Schools', '', '')

ConvertLabelsToAnnotation (ラベルをアノテーションに変換) の例 2 (スタンドアロンスクリプト)

このスタンドアロンスクリプトは、ConvertLabelsToAnnotation 関数を使用してラベルをマップのアノテーションに変換します。アノテーションが単一のアノテーションフィーチャクラスに変換され、類似するラベルクラスがマージされます。

# Name: ConvertLabelsToAnnotation.py
# Description: Find all the maps in the project and
#              convert labels to annotation for each map

# import system modules

import arcpy

# Loop through the project, find all the maps, and
#   convert labels to annotation for each map,
#   using the name of the map as part of the annotation suffix 
project = arcpy.mp.ArcGISProject("D:\\data\\myproject.aprx")
for mp in project.listMaps():
    print("Converting labels to annotation for: " + mp.name)
    arcpy.cartography.ConvertLabelsToAnnotation(
            mp, 10000, 'D:/data/Cobourg.gdb', 'Anno_' + mp.name, 'MAXOF', 
            'ONLY_PLACED', 'REQUIRE_ID', 'STANDARD', '', '', 
            'AnnoLayers_' + mp.name, 'ALL_LAYERS', '', 'SINGLE_FEATURE_CLASS', 
            'MERGE_LABEL_CLASS')

環境

出力データのコンフィグレーションキーワード, アノテーションのテキスト文字列フィールド長

ライセンス情報

Basic: Yes
Standard: Yes
Advanced: Yes

サマリー

使用法

注意:

パラメーター

注意:

派生した出力

ライセンス:

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容