Надписи листов в аннотации (Инструменты Картография)

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

Конвертирует надписи в аннотации для слоев в карте, основываясь на полигональном индексном слое.

Инструмент разделяет карту на листы и создает поочередно аннотации для каждого листа. Такой подход может быть полезным для конвертации в аннотации большого количества надписей. Индексный слой полигонов может быть создан инструментом [Сохранить схему листов кэша картографического сервиса как полигоны], инструментом [Класс объектов индексной сетки] или любым другим классом полигональных пространственных объектов, покрывающим территорию, для которой вы хотите создать аннотацию.

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

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

Примечание:

Диапазоны масштабов классов надписей устанавливаются в свойствах слоя в ArcGIS Pro. После настройки свойств надписей сохраните проект перед запуском инструмента.
Если вы выберете листы до запуска данного инструмента, аннотации будут созданы только для выбранных листов.
Для того чтобы обновить аннотации только для некоторых листов полигонального индексного слоя, сначала выберете объекты аннотаций с конкретным значением поля TileID и удалите их. Затем выберите полигональные объекты и снова запустите инструмент.
Выходными данными инструмента являются наборы составных слоев. Каждый составной слой содержит составные слои для всех масштабов, для которых были созданы аннотации.
Во время работы в панели Каталог или в ModelBuilder вы можете использовать инструмент Сохранить в файл слоя, чтобы записать этот выходной составной слой в файл слоя.
Составной слой будет записан поверх существующего, если будет указано одинаковое имя слоя, и если явным образом указывается разрешение на перезапись.
Если во фрейме данных обнаружены дублирующиеся названия классов пространственных объектов, к тексту аннотации после имени класса объектов будет добавлен номер (например, Cities01Anno10000, Cities02Anno10000 и т.д.).
Классы объектов-аннотаций не будут перезаписываться, если будет указан уже существующий суффикс. В этом случае к суффиксу класса объектов-аннотаций будет добавлен номер (например, CitiesAnno10000, CitiesAnno10000_1 и т.д.).
Базовый масштаб для класса объектов аннотаций может быть задан одним из следующих двух способов:
- Использовать поле из полигонального индексного слоя для определения базового масштаба выходного класса объектов-аннотаций. Используйте этот способ в случае, если вы будете создавать аннотации для нескольких масштабных уровней.
- Точно указать значение базового масштаба. Все классы объектов аннотаций будут использовать это значение базового масштаба. Если базовый масштаб карты задан, он будет использоваться в качестве входного значения по умолчанию для инструмента. Если базовый масштаб карты не задан, значением по умолчанию будет текущий масштаб карты.
Если вы работаете с полигональным индексным слоем, созданным с помощью инструмента Сохранить схему листов кэша картографического сервиса как полигоны, используйте поле Tile_Scale в качестве Поля базового масштаба. Будет создан класс объектов аннотаций для каждого сочетания layer-Tile_Scale.
Если вы создаете аннотации для разных базовых масштабов, оформите карту отдельно для каждого из этих масштабов, и не задавайте базовый масштаб.
Если указано поле системы координат полигонального слоя индекса, аннотации для каждого листа будут перенесены в соответствующую систему координат с целью их корректного отображения и размещения.
Если параметр Создать объектно-связанную аннотацию не отмечен, можно использовать параметр Конвертировать надписи из всех слоёв в один выходной класс пространственных объектов, чтобы создать отдельный класс пространственных объектов аннотаций для всей карты.

При создании отдельного класса пространственных объектов аннотаций для всей карты классы надписей со схожими свойствами могут быть объединены в один класс аннотаций, если выбрать параметр Объединить схожие классы надписей.
Объектно-связанные аннотации связаны с определенными пространственными объектами в каком-либо классе объектов базы геоданных. Когда вы создаете класс объектно-связанных аннотаций, автоматически будет создан так же класс отношений.
При создании объектно-связанных аннотаций выходная рабочая область должна совпадать с рабочей областью классов пространственных объектов, с которыми связываются аннотации.
Некоторые надписи могут не отображаться на карте, т.к. для них не хватает места. Чтобы конвертировать эти надписи, отметьте опцию Построить неразмещенные аннотации. Неразмещенные надписи будут сохранены в классе объектов-аннотаций, что позволит позднее разместить их во время сеанса редактирования .
Memory и рабочие области in_memory не поддерживают связанные с объектами аннотации.
Этот инструмент учитывает параметр среды Длина текстовой строки поля аннотации. Если он задан, то длина поля по умолчанию для поля TextString будет переопределяться в любых классах объектов аннотаций, созданных в базе данных.

Подпись	Объяснение	Тип данных
Входная карта	Карта, которая содержит надписи, конвертируемые в аннотации.	Map
Полигональный индексный слой	Полигональный слой, содержащий объекты листов.	Table View
Выходная база геоданных	Рабочая область, в которой будут сохранены выходные классы пространственных объектов. Рабочая область может представлять собой существующую базу геоданных или существующий набор классов объектов.	Workspace; Feature Dataset
Выходной слой	Составной слой, содержащий созданные аннотации. Можно использовать инструмент Сохранить в файл слоя, чтобы записать выходной составной слой в файл слоя.	Group Layer
Суффикс аннотации	Суффикс, который добавляется к каждому классу объектов аннотаций. Суффикс будет добавлен к имени исходного класса пространственных объектов для каждого нового класса объектов аннотаций. За этим суффиксом следует значение базового масштаба.	String
Значение базового масштаба (Дополнительный)	Значение масштаба, который будет использоваться в качестве базового для аннотации. Этот масштаб будет основой для всех размеров символов и текстов в аннотации.	Double
Поле базового масштаба (Дополнительный)	Поле полигонального слоя индекса, определяющее базовый масштаб для аннотаций. Этот масштаб будет основой для всех размеров символов и текстов в аннотации.	Field
Поле ID листа (Дополнительный)	Поле полигонального слоя индекса, значение в котором позволяет уникально идентифицировать территорию листа. Этими значениями заполняется поле `TileID` атрибутивной таблицы класса объектов аннотаций.	Field
Поле системы координат (Дополнительный)	Поле полигонального слоя индекса, в котором содержится информация о координатной системе каждого листа. Из-за требований, предъявляемых к длине поля, которая необходима для хранения информации о системе координат, полигональный индексный слой, содержащий поле, должен являться классом пространственных объектов базы геоданных.	Field
Поле поворота карты (Дополнительный)	Поле полигонального слоя индекса, содержащее значения угла, на который будет повернута карта.	Field
Создать объектно-связанную аннотацию (Дополнительный)	Выберите, будет ли выходной класс объектов-аннотаций связан с пространственными объектами другого класса пространственных объектов. Отмечено–Выходной класс объектов-аннотаций будет связан с объектами в другом классе пространственных объектов. Не отмечено–Выходной класс объектов-аннотаций не будет связан с объектами в другом классе пространственных объектов. Используется по умолчанию.	Boolean
Конвертировать неразмещенные надписи в неразмещенные аннотации (Дополнительный)	Указывает, будут ли создаваться неразмещенные аннотации из неразмещенных надписей. Отмечено–Неразмещенная аннотация будет храниться в классе объектов-аннотаций. Для данной аннотации установлено поле статуса Unplaced (не размещена). Не отмечено–Аннотации будут создаваться только для надписанных объектов. Используется по умолчанию.	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	Составной слой, содержащий созданные аннотации. Можно использовать инструмент Сохранить в файл слоя, чтобы записать выходной составной слой в файл слоя.	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 (Дополнительный)	Выберите, будет ли выходной класс объектов-аннотаций связан с пространственными объектами другого класса пространственных объектов. `FEATURE_LINKED`–Выходной класс объектов-аннотаций будет связан с объектами в другом классе пространственных объектов. `STANDARD`–Выходной класс объектов-аннотаций не будет связан с объектами в другом классе пространственных объектов. Используется по умолчанию.	Boolean
generate_unplaced_annotation (Дополнительный)	Указывает, будут ли создаваться неразмещенные аннотации из неразмещенных надписей. `GENERATE_UNPLACED_ANNOTATION`–Неразмещенная аннотация будет храниться в классе объектов-аннотаций. Для данной аннотации установлено поле статуса Unplaced (не размещена). `NOT_GENERATE_UNPLACED_ANNOTATION`–Аннотации будут создаваться только для надписанных объектов. Используется по умолчанию.	Boolean
which_layers (Дополнительный)	Указывает, будет ли аннотации сконвертированы для всех слоев карты или для одного слоя. Необходимо указать Один слой. `ALL_LAYERS`–Подписи будут конвертированы в аннотации для всех слоев карты. Используется по умолчанию. `SINGLE_LAYER`–Надписи будут конвертированы в аннотации для одного слоя. Необходимо указать этот слой.	String
single_layer (Дополнительный)	Слой с аннотацией, которая будет конвертирована, когда для параметра `which_layers` будет задано значение `SINGLE_LAYER`. Этот слой должен быть на карте.	Feature Layer
require_symbol_id (Дополнительный)	Указывает, можно ли редактировать все свойства текстовых символов. `REQUIRE_ID`–Можно редактировать только те свойства символов, которые позволяют объектам аннотаций сохранять ссылку на связанный с ними текстовый символ в коллекции. `NO_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, пример 1 (окно Python)

Пример Python для функции TiledLabelsToAnnotation, который конвертирует надписи в аннотации для отдельного слоя карты на основе полигонального индексного слоя.

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: Да
Standard: Да
Advanced: Да

Надписи листов в аннотации (Инструменты Картография)

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

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

Примечание:

Параметры

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

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

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

Связанные разделы