textVariableAnchorOffset

To increase the chance of placing high-priority labels on the map, you can provide an array of Property.TEXT_ANCHOR locations, each paired with an offset value. The renderer will attempt to place the label at each location, in order, before moving on to the next location+offset. Use `text-justify: auto` to choose justification based on anchor position. The length of the array must be even, and must alternate between enum and point entries. i.e., each anchor location must be accompanied by a point, and that point defines the offset when the corresponding anchor location is used. Positive offset values indicate right and down, while negative values indicate left and up. Anchor locations may repeat, allowing the renderer to try multiple offsets to try and place a label using the same anchor. When present, this property takes precedence over Property.TEXT_ANCHOR, textVariableAnchor, textOffset, and textRadialOffset. ```json { "text-variable-anchor-offset": ["top", [0, 4], "left", [3,0], "bottom", [1, 1]] } ``` When the renderer chooses the `top` anchor, `[0, 4]` will be used for textOffset; the text will be shifted down by 4 ems. When the renderer chooses the `left` anchor, `[3, 0]` will be used for textOffset; the text will be shifted right by 3 ems.

Parameters