Аннотации для выбранных объектов (Картография)

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

Создает аннотации для выбранных объектов слоя. Используются свойства надписей, заданные в свойствах класса аннотаций указанных классов объектов-аннотаций.

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

  • Пространственные объекты, для которых создаются аннотации, определяются по выборке, применяемой к слою. Выборка должна быть задана в предыдущем шаге с помощью инструментов Выбрать в слое по атрибуту или Выбрать в слое по расположению, или путем запроса к слою карты в ArcGIS AllSource.

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

  • Входной слой должен содержать выборку, в противном случае инструмент Аннотации для выбранных объектов работать не будет.

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

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

Параметры

ПодписьОписаниеТип данных
Входная карта

Входная карта.

Map
Входные объекты

Слой, для выбранных объектов которого создаются аннотации.

Feature Layer
Слои аннотаций

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

Value Table
Конвертировать неразмещенные надписи в неразмещенные аннотации
(Дополнительный)

Устанавливает, будут ли создаваться неразмещенные аннотации из неразмещенных надписей.

  • Не отмечено – аннотации будут создаваться только для надписанных объектов. Это значение по умолчанию
  • Отмечено – неразмещенные аннотации сохраняются в класс объектов аннотаций. Устанавливается значение Unplaced в поле статуса таких аннотаций.

Boolean

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

ПодписьОписаниеТип данных
Выходные слои аннотаций

Выходной слой аннотаций.

Annotation Layer

arcpy.cartography.AnnotateSelectedFeatures(in_map, in_layer, anno_layers, {generate_unplaced})
ИмяОписаниеТип данных
in_map

Входная карта.

Map
in_layer

Слой, для выбранных объектов которого создаются аннотации.

Feature Layer
anno_layers
[[annotation_layer, sublayer;sublayer],...]

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

Value Table
generate_unplaced
(Дополнительный)

Устанавливает, будут ли создаваться неразмещенные аннотации из неразмещенных надписей.

  • ONLY_PLACEDАннотации будут создаваться только для надписанных объектов. Это значение по умолчанию
  • GENERATE_UNPLACEDНеразмещенные аннотации сохраняются в класс объектов аннотаций. Устанавливается значение Unplaced в поле статуса таких аннотаций.
Boolean

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

ИмяОписаниеТип данных
out_anno_layers

Выходной слой аннотаций.

Annotation Layer

Пример кода

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

Следующий скрипт окна Python показывает, как использовать инструмент AnnotateSelectedFeatures в режиме прямого запуска.


import arcpy
arcpy.env.workspace = "c:/data/Canada.gdb"
arcpy.management.SelectLayerByAttribute("cities", 'NEW_SELECTION', 
                                        "County = 'Northumberland'")
arcpy.cartography.AnnotateSelectedFeatures("Map", 'cities', 
                                           "citiesAnno 'Class 1;Class 2'; citiesAltAnno 'Class 1'", 
                                           "GENERATE_UNPLACED")
AnnotateSelectedFeatures , пример 2 (автономный скрипт)

Автономный скрипт, который создает аннотации для выбранных объектов слоя, используя функцию AnnotateSelectedFeatures.

# Name: AnnotateSelectedFeatures.py
# Description: Annotate features based on a selection in a map 

# Import system modules
import arcpy

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

# Execute Annotate Selected Features
p = arcpy.mp.ArcGISProject("C:\\data\\Northumberland.aprx")
for m in p.listMaps():
    arcpy.cartography.AnnotateSelectedFeatures(m, 'Wells', "WellsAnno 'Class 1'", 
                                               'GENERATE_UNPLACED')

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

Этот инструмент не использует параметры среды геообработки