Конвертировать надписи в аннотации (Картография)

Краткая информация

Конвертирует надписи в аннотации для одного слоя или всей карты. Могут быть созданы и обычные, и объектно-связанные аннотации.

Использование

• Надписи можно конвертировать в аннотации для одного слоя или для целой карты. Если выбрана конвертация для одного слоя, этот слой должен быть указан и должен находиться на карте.

• Учитываются диапазоны масштабов класса надписей. Когда инструмент создает аннотации для определенного масштаба карты, конвертируются только классы надписей, которые включены и видимы в данном масштабе.

  Примечание:

  В ArcGIS Pro диапазоны масштабов классов надписей устанавливаются на вкладке Надписи.

• Классы объектов-аннотаций не будут перезаписываться, если будет указан уже существующий суффикс. В этом случае к суффиксу класса объектов-аннотаций будет добавлен номер (например, CitiesAnno, CitiesAnno_1 и т.д.). Полный формат имени является следующим:

  <layer name> <duplicate feature class count> <anno suffix> <running number>

• Если вы создаете аннотации для большого диапазона базовых масштабов, разрабатывайте оформление карты отдельно для каждого из этих масштабов и не устанавливайте базовый масштаб в карте. Затем можно конвертировать надписи в аннотации для каждого масштаба и назвать их соответственно, например, CitiesAnno_1000, CitiesAnno_100000 и т.д.

• Выходными данными для этого инструмента является составной слой. При работе в панели Каталог, окне Python или с автономным скриптом Python можно использовать инструмент Сохранить в файл слоя, чтобы записать выходной составной слой в файл слоя. При использовании ArcGIS Pro, инструмент добавляет составной слой на экран. Создаваемый составной слой является временным и не сохранится по окончании работы в программе, если проект не будет сохранен.

• Существующий составной слой будет перезаписан, если будет указано одинаковое имя слоя, и если явным образом указывается разрешение на перезапись выходных данных.

• Если параметр Создать объектно-связанную аннотацию не выбран, можно использовать параметр Конвертировать надписи из всех слоёв в один выходной класс пространственных объектов, чтобы создать один класс пространственных объектов аннотаций для всей карты.

  При создании одного класса пространственных объектов аннотаций для всей карты классы надписей со схожими свойствами могут быть объединены в один класс аннотаций, если выбрать параметр Объединить схожие классы надписей.

• Объектно-связанные аннотации связаны с определенными пространственными объектами в каком-либо классе объектов базы геоданных. Если отмечен параметр Создать объектно-связанные аннотации, то при создании выходного класса объектов-аннотаций автоматически будет создан класс отношений.

• При создании объектно-связанных аннотаций выходная рабочая область должна совпадать с рабочей областью классов пространственных объектов, с которыми связываются аннотации.

• Некоторые надписи могут не отображаться на карте, т.к. для них не хватает места. Для конвертации этих надписей отметьте параметр Конвертировать неразмещенные надписи в неразмещенные аннотации. Это сохранит неразмещенные надписи в классе объектов-аннотаций, что позволит позднее разместить их в сеансе редактирования ArcGIS Pro.

• Связанные с объектами аннотации не поддерживаются рабочими областями Memory и in_memory.

• Этот инструмент учитывает параметр среды Длина текстовой строки поля аннотации. Если он задан, то длина поля по умолчанию для поля TextString будет переопределяться в любых классах объектов аннотаций, созданных в базе данных.

Параметры

Диалог

Подпись	Описание	Тип данных
Входная карта	Входная карта.	Map
Масштаб конвертации	Масштаб, в котором надписи будут конвертироваться. Если на карте задан базовый масштаб, он будет использоваться для изменения размеров символов и создания классов объектов-аннотаций, и конвертация будет происходить в этом масштабе.	Double
Выходная база геоданных	Рабочая область, в которой будут сохранены выходные классы пространственных объектов. Рабочая область может представлять собой существующую базу геоданных или существующий набор классов объектов. Если это не та же самая база данных, что используется всеми слоями карты, опция создания объектно-связанных аннотаций будет неактивна.	Workspace; Feature Dataset
Суффикс аннотации (Дополнительный)	Суффикс, который добавляется к каждому классу объектов аннотаций. Суффикс будет добавлен к имени исходного класса пространственных объектов для каждого нового класса объектов аннотаций.	String
Экстент (Дополнительный)	Задает экстент, который содержит надписи, конвертируемые в аннотации. Текущий экстент отображения — Экстент будет основан на активной карте или сцене. Эта опция доступна только при наличии активной карты. Нарисовать экстент - экстент будет основан прямоугольнике, нарисованном на карте или сцене. Эта опция создает класс пространственных объектов в базе геоданных проекта и добавляет слой на карту. Класс объектов будет иметь ту же систему координат, что и карта. Примечание: Данная опция не доступна в диалоговом окне Параметры среды. Он доступен только из параметра инструмента, с экстентом в качестве типа данных, или на вкладке Параметры среды диалогового окна инструмента. Примечание: Если включена опция Включать и отключать редактирование на вкладке Редактирование, вы должны включить редактирование на вкладке ленты Редактирование, чтобы нарисовать экстент. Экстент слоя — Экстент будет основан на активном слое карты. Используйте раскрывающийся список, чтобы выбрать доступный слой, или используйте опцию Экстент данных во всех слоях, чтобы получить объединенный экстент всех активных слоев карты, за исключением базовой карты. Эта опция доступна только при наличии активной карты со слоями. У каждого слоя карте есть следующие опции: Все объекты - экстент всех объектов слоя. Выбранные объекты - экстент всех выбранных объектов слоя. Отображаемые объекты - экстент всех отображаемых объектов слоя. Примечание: Экстенты опций Выбранные объекты и Отображаемые объекты доступны только для векторных слоев. Обзор — Экстент будет основан на существующем наборе данных. Пересечение входных данных — Экстент будет основан на минимальном или пересекающемся экстенте всех входных данных. Если никакие входные данные не перекрываются, получится пустой экстент со всеми нулями. Объединение входных данных — Экстент будет основан на максимальном или объединенном экстенте всех входных данных. Буфер обмена - экстент может быть скопирован в буфер обмена и из него. Копировать экстент - копирует координаты экстента и систему координат в буфер обмена. Вставить экстент - вставляет координаты экстента и, дополнительно, систему координат из буфера обмена. Если значения буфера обмена не содержат систему координат, экстент будет использовать систему координат карты. Примечание: Координаты экстента копируются в буфер обмена и вставляются из него с использованием того же форматирования и порядка, что и для объекта ArcPy Extent: x-min, y-min, x-max, y-max и пространственная привязка. Сбросить экстент — Экстент будет сброшен до значения по умолчанию. Координаты, введенные вручную – Координаты должны быть числовыми значениями и находиться в системе координат активной карты. Внимание: На карте могут использоваться единицы отображения, отличные от введенных координат. Использование направления по сторонам света (N, S, E, W) не поддерживается. Используйте знак отрицательного значения для координат юга и запада.	Extent
Конвертировать неразмещенные надписи в неразмещенные аннотации (Дополнительный)	Указывает, будут ли создаваться неразмещенные аннотации из неразмещенных надписей. Не отмечено – аннотации будут создаваться только для надписанных объектов. Это значение по умолчанию Отмечено – неразмещенная аннотация будет храниться в классе объектов-аннотаций. Для такой аннотации в поле статуса установлено Unplaced (не размещена).	Boolean
Необходимо, чтобы символ был выбран из таблицы символов (Дополнительный)	Указывает, можно ли редактировать все свойства текстовых символов. Не отмечено – все свойства текстовых символов можно редактировать. Это значение по умолчанию Отмечено – можно редактировать только те свойства символов, которые позволяют объектам аннотаций сохранять ссылку на связанный с ними текстовый символ в коллекции.	Boolean
Создать объектно-связанную аннотацию (Дополнительный)	Выберите, будет ли выходной класс объектов-аннотаций связан с пространственными объектами другого класса пространственных объектов. Не отмечено – выходной класс объектов аннотаций не будет связан с объектами в другом классе пространственных объектов. Это значение по умолчанию Отмечено – выходной класс объектов-аннотаций будет связан с объектами в другом классе пространственных объектов.	Boolean
Создавать аннотацию при добавлении нового объекта (Дополнительный)	Указывает, будет ли создаваться аннотация при добавлении нового объекта в класс связанных пространственных объектов, если включен параметр Создать объектно-связанные аннотации. Отмечено – при добавлении новых объектов в класс связанных пространственных объектов будут создаваться объектно-связанные аннотации. Это значение по умолчанию Не отмечено – при добавлении новых объектов в класс связанных пространственных объектов объектно-связанные аннотации создаваться не будут.	Boolean
Обновлять аннотацию при изменении формы объекта (Дополнительный)	Указывает, будет ли обновляться положение аннотации, если изменяется форма связанного пространственного объекта, если включен параметр Создать объектно-связанные аннотации. Отмечено – положение аннотации при изменении формы связанного пространственного объекта будет обновлено. Это значение по умолчанию Отмечено – положение аннотации при изменении формы связанного пространственного объекта не будет обновлено.	Boolean
Выходной слой (Дополнительный)	Составной слой, содержащий созданные аннотации. Во время работы Каталоге вы можете использовать инструмент Сохранить в файл слоя, чтобы записать выходной составной слой в файл слоя. При использовании ArcGIS Pro с открытой картой, инструмент добавляет составной слой к отображению, если опция отмечена в опциях геообработки. Создаваемый составной слой является временным и не сохранится по окончании работы в программе, если проект не будет сохранен.	Group Layer
Конвертировать (Дополнительный)	Указывает, будет ли аннотации сконвертированы для всех слоев карты или для одного слоя. Необходимо указать Один слой. Все слои в карте—Надписи будут конвертированы в аннотации для всех слоев карты. Это значение по умолчанию Один слой—Надписи будут конвертированы в аннотации для одного слоя. Необходимо указать этот слой.	String
Векторный слой (Дополнительный)	Слой с аннотациями, которые будут конвертированы, если для параметра Конвертировать задано значение Один слой. Этот слой должен быть на карте.	Feature Layer
Конвертировать надписи из всех слоев в один выходной класс пространственных объектов (Дополнительный)	Определяет, будут ли конвертированы надписи в отдельные классы объектов-аннотаций либо в один такой класс. При преобразовании в один класс объектов-аннотаций аннотации не могут быть связаны с объектами. Отмечено – надписи из всех слоев будут преобразованы в один класс объектов-аннотаций. Не отмечено - надписи будут преобразованы в отдельные слои объектов-аннотаций, соответствующие слоям. Это значение по умолчанию	Boolean
Объединить схожие классы надписей (Дополнительный)	Определяет, будут ли сходные классы надписей объединяться, если отмечен параметр Конвертировать надписи всех слоев в один выходной класс объектов . Отмечено - классы надписей с аналогичными свойствами будут объединены при конвертированы в один класс пространственных объектов. Не отмечено - классы надписей со сходными свойствами не будут объединяться. Это значение по умолчанию	Boolean

Производные выходные данные

Подпись	Описание	Тип данных
Обновленная база геоданных	Рабочая область, в которой будут сохранены выходные классы пространственных объектов.	Workspace

Python

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—Неразмещенная аннотация будет храниться в классе объектов-аннотаций. Для такой аннотации в поле статуса установлено Unplaced (не размещена).	Boolean
require_symbol_id (Дополнительный)	Указывает, можно ли редактировать все свойства текстовых символов. NO_REQUIRE_ID—Все свойства текстовых символов можно редактировать. Это значение по умолчанию REQUIRE_ID—Можно редактировать только те свойства символов, которые позволяют объектам аннотаций сохранять ссылку на связанный с ними текстовый символ в коллекции.	Boolean
feature_linked (Дополнительный)	Выберите, будет ли выходной класс объектов-аннотаций связан с пространственными объектами другого класса пространственных объектов. 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 (Дополнительный)	Составной слой, содержащий созданные аннотации. Можно использовать инструмент Сохранить в файл слоя, чтобы записать выходной составной слой в файл слоя.	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—Классы надписей с аналогичными свойствами будут объединены при конвертации в один класс пространственных объектов. NO_MERGE_LABEL_CLASS—Классы надписей со сходными свойствами не будут объединяться. Это значение по умолчанию	Boolean

Производные выходные данные

Имя	Описание	Тип данных
updated_geodatabase	Рабочая область, в которой будут сохранены выходные классы пространственных объектов.	Workspace

Пример кода

ConvertLabelsToAnnotation, пример (окно Python).

Этот пример Python для функции ConvertLabelsToAnnotation конвертирует надписи в аннотации для одного слоя карты.

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')

Параметры среды

Выходное ключевое слово CONFIG, Длина текстовой строки поля аннотации

Информация о лицензиях

• Basic: Да
• Standard: Да
• Advanced: Да