Labeling Results

The labeling results are emitted out of the MapTextLabeller via a set of output ports.

For FME 2025 and newer
A fixed set of output ports are shown on the MapTextLabeller named Text, Leader, Symbol, and Unplaced.  All placed text is emitted via the Text port.  All placed leaders are emitted via the Leader port.  All placed symbols are emitted via the Symbol port.  For any feature whose label could not be placed, that feature is output on the Unplaced port.  Each output feature on Unplaced possesses an additional attribute named _ez_unlabeled_reason that stores the reason for failure.  Possible values for this attribute are Suppressed, Excluded and Unplaced.

All output text, leaders, symbols, and unplaced text possess an additional exposed attribute named MTL_LAYERNAME.  This stores the name of the FME layer with which the label part is associated.  For example, if a label part was placed for a feature that came from an input named “Tester_PASSED”, then the MTL_LAYERNAME for this label part will store “Tester_PASSED”.  If any of the output port pull-downs is revealed, the MTL_LAYERNAME will be visible.  This attribute is available on subsequent transformers to participate in processing.  For example, to filter out the text from the Text port whose MTL_LAYERNAME is “Tester_PASSED”, then set up a Tester transformer and specify the expression query for Passed to be “MTL_LAYERNAME = Tester_PASSED”

These output ports can be connected to Writers or other transformers such as an Inspector.

For FME 2024
For each map layer possessing a label definition (a dot shown in its Labeled cell in the Rule Configurations table), up to four output ports are created by the transformer named as <map layer>_TXT, <map layer>_UNL, <map layer>_SYM, and <map layer>_LDR.  The output port <map layer>_TXT emits all placed text.  The output port <map layer>_SYM emits all placed symbols (like road shields).  The output port <map layer>_LDR emits all placed leaders.  For any feature whose label could not be placed, that feature is output on the <map layer>_UNL port.  Each output feature on <map layer>_UNL possesses an additional attribute named _ez_unlabeled_reason that stores the reason for failure.  Possible values for this attribute are Suppressed, Excluded and Unplaced.

These output ports can be connected to Writers or other transformers such as an Inspector.