Class MaplibreValhallaControl

Maplibre GL Terra Draw Measure Control

Hierarchy (View Summary)

MaplibreTerradrawControl
- MaplibreValhallaControl

Index

Constructors

constructor

new MaplibreValhallaControl(
options?: ValhallaControlOptions,
): MaplibreValhallaControl
Constructor
Parameters
- Optionaloptions: ValhallaControlOptions
  Plugin control options
Returns MaplibreValhallaControl
Overrides MaplibreTerradrawControl.constructor
- Defined in controls/MaplibreValhallaControl.ts:206

Properties

`Protected`_cssPrefix

_cssPrefix: string = ''

`Protected` `Optional`_fontGlyphs

_fontGlyphs?: string[]

`Protected`_isExpanded

_isExpanded: boolean = false

`Protected` `Optional`controlContainer

controlContainer?: HTMLElement

`Protected`defaultMode

defaultMode: string = 'render'

`Protected`events

events: { [key: string]: [(event: EventArgs) => void] } = {}

`Protected` `Optional`map

map?: Map$1

`Protected`modeButtons

modeButtons: { [key: string]: HTMLButtonElement } = {}

`Protected`options

options: TerradrawControlOptions

`Protected` `Optional`terradraw

terradraw?: TerraDraw

Accessors

`Protected`cssPrefix

get cssPrefix(): string
CSS prefix for the control buttons. Default is empty string

Returns string
Inherited from MaplibreTerradrawControl.cssPrefix
- Defined in controls/MaplibreTerradrawControl.ts:113

distanceIsochroneCostingModel

get distanceIsochroneCostingModel(): "auto" | "pedestrian" | "bicycle"
Get the means of transport for Valhalla distance isochrone api

Returns "auto" | "pedestrian" | "bicycle"
isochroneCostingModelType
Example
```
'pedestrian', 'bicycle', 'auto'
```
- Defined in controls/MaplibreValhallaControl.ts:126
set distanceIsochroneCostingModel(
value: "auto" | "pedestrian" | "bicycle",
): void
Set the means of transport for Valhalla distance isochrone api
Parameters
- value: "auto" | "pedestrian" | "bicycle"
  isochroneCostingModelType
Returns void
Example
```
'pedestrian', 'bicycle', 'auto'
```
- Defined in controls/MaplibreValhallaControl.ts:134

fontGlyphs

get fontGlyphs(): string[]
Get/Set font glyph for valhalla control layers

As default, this maesure control uses maplibre's default font glyphs(Open Sans Regular,Arial Unicode MS Regular) described at https://maplibre.org/maplibre-style-spec/layers/#text-font

If you are using your own maplibre style or different map privider, you probably need to set the font glyphs to match your maplibre style.

Font glyph availability depends on what types of glyphs are supported by your maplibre style (e.g., Carto, Openmap tiles, Protomap, Maptiler, etc.) Please make sure the font glyphs are available in your maplibre style.

Usage:
```
const drawControl = new MaplibreValhallaControl()
drawControl.fontGlyphs = ['Open Sans Italic']
map.addControl(drawControl)
```
Returns string[]
Overrides MaplibreTerradrawControl.fontGlyphs
- Defined in controls/MaplibreValhallaControl.ts:175
set fontGlyphs(fontNames: string[]): void
Get/Set font glyph for the TextMode label layer ({prefix}-text-labels).

As default, the TextMode label uses sans-serif so it is not constrained by the glyphs available in your maplibre style. See https://maplibre.org/maplibre-style-spec/layers/#text-font

If you are using your own maplibre style or a different map provider, you probably need to set the font glyphs to match glyphs available in your maplibre style.

Font glyph availability depends on what types of glyphs are supported by your maplibre style (e.g., Carto, Openmap tiles, Protomap, Maptiler, etc.). Please make sure the font glyphs are available in your maplibre style.

Usage:
```
const drawControl = new MaplibreTerradrawControl({ modes: ['text'] })
drawControl.fontGlyphs = ['Open Sans Italic']
map.addControl(drawControl)
```
Parameters
- fontNames: string[]
Returns void
Overrides MaplibreTerradrawControl.fontGlyphs
- Defined in controls/MaplibreValhallaControl.ts:183

isExpanded

get isExpanded(): boolean
get the state of whether the control is expanded or collapsed

Returns boolean
Inherited from MaplibreTerradrawControl.isExpanded
- Defined in controls/MaplibreTerradrawControl.ts:46
set isExpanded(value: boolean): void
set the state of the control either expanded or collapsed. terradraw mode will be reset if the state is changed. either expanded or collapsed event is dispatched when changed
Parameters
- value: boolean
Returns void
Inherited from MaplibreTerradrawControl.isExpanded
- Defined in controls/MaplibreTerradrawControl.ts:122

isochroneContours

get isochroneContours(): Contour[]
Get the list of contours for Valhalla isochrone api

Returns Contour[]
Contour[]
- Defined in controls/MaplibreValhallaControl.ts:143
set isochroneContours(value: Contour[]): void
Set the list of contours for Valhalla isochrone api
Parameters
- value: Contour[]
  Contour[]
Returns void
- Defined in controls/MaplibreValhallaControl.ts:151

routingCostingModel

get routingCostingModel(): "auto" | "pedestrian" | "bicycle"
Get the means of transport for Valhalla routing api

Returns "auto" | "pedestrian" | "bicycle"
costingModelType
Example
```
'pedestrian', 'bicycle', 'auto'
```
- Defined in controls/MaplibreValhallaControl.ts:71
set routingCostingModel(value: "auto" | "pedestrian" | "bicycle"): void
Set the means of transport for Valhalla routing api
Parameters
- value: "auto" | "pedestrian" | "bicycle"
  costingModelType
Returns void
Example
```
'pedestrian', 'bicycle', 'auto'
```
- Defined in controls/MaplibreValhallaControl.ts:79

routingDistanceUnit

get routingDistanceUnit(): "kilometers" | "miles"
Get the distance unit for Valhalla routing api

Returns "kilometers" | "miles"
routingDistanceUnitType
Example
```
'kilometers', 'miles'
```
- Defined in controls/MaplibreValhallaControl.ts:89
set routingDistanceUnit(value: "kilometers" | "miles"): void
Set the distance unit for Valhalla routing api
Parameters
- value: "kilometers" | "miles"
  routingDistanceUnitType
Returns void
Example
```
'kilometers', 'miles'
```
- Defined in controls/MaplibreValhallaControl.ts:98

settingDialog

get settingDialog(): ModalDialog
Get the dialog instance for settings

Returns ModalDialog
- Defined in controls/MaplibreValhallaControl.ts:192
set settingDialog(value: ModalDialog): void
Set the dialog instance for settings
Parameters
- value: ModalDialog
Returns void
- Defined in controls/MaplibreValhallaControl.ts:198

showDeleteConfirmation

get showDeleteConfirmation(): boolean
Show delete confirmation popup when deleting features if true. Default is false

Returns boolean
Inherited from MaplibreTerradrawControl.showDeleteConfirmation
- Defined in controls/MaplibreTerradrawControl.ts:159
set showDeleteConfirmation(value: boolean): void
Set show delete confirmation popup when deleting features if true. Default is false
Parameters
- value: boolean
Returns void
Inherited from MaplibreTerradrawControl.showDeleteConfirmation
- Defined in controls/MaplibreTerradrawControl.ts:166

timeIsochroneCostingModel

get timeIsochroneCostingModel(): "auto" | "pedestrian" | "bicycle"
Get the means of transport for Valhalla time isochrone api

Returns "auto" | "pedestrian" | "bicycle"
isochroneCostingModelType
Example
```
'pedestrian', 'bicycle', 'auto'
```
- Defined in controls/MaplibreValhallaControl.ts:108
set timeIsochroneCostingModel(value: "auto" | "pedestrian" | "bicycle"): void
Set the means of transport for Valhalla time isochrone api
Parameters
- value: "auto" | "pedestrian" | "bicycle"
  isochroneCostingModelType
Returns void
Example
```
'pedestrian', 'bicycle', 'auto'
```
- Defined in controls/MaplibreValhallaControl.ts:116

valhallaUrl

get valhallaUrl(): string
Get the URL of Valhalla API

Returns string
- Defined in controls/MaplibreValhallaControl.ts:51
set valhallaUrl(value: string): void
Set the URL of Valhalla API
Parameters
- value: string
  URL of Valhalla API
Returns void
- Defined in controls/MaplibreValhallaControl.ts:60

Methods

activate

activate(): void
Activate Terra Draw to start drawing

Returns void
Overrides MaplibreTerradrawControl.activate
- Defined in controls/MaplibreValhallaControl.ts:317

`Protected`addTerradrawButton

addTerradrawButton(mode: TerradrawMode): void
Add Terra Draw drawing mode button
Parameters
- mode: TerradrawMode
  Terra Draw mode name
Returns void
Overrides MaplibreTerradrawControl.addTerradrawButton
- Defined in controls/MaplibreValhallaControl.ts:739

`Protected`addTextFeaturesToSource

addTextFeaturesToSource(
    features: GeoJSONStoreFeatures<GeoJSONStoreGeometries>[],
    map: Map$1,
    styles?: TextModeStyling,
): void
Add Text Label Terradraw Features to the map
Parameters
- features: GeoJSONStoreFeatures<GeoJSONStoreGeometries>[]
- map: Map$1
- Optionalstyles: TextModeStyling
Returns void
Inherited from MaplibreTerradrawControl.addTextFeaturesToSource
- Defined in controls/MaplibreTerradrawControl.ts:985

`Protected`applyFontGlyphs

applyFontGlyphs(
fontNames: string[],
layers: (SymbolLayerSpecification | undefined)[],
): void
Apply the given font glyphs to the provided symbol layer specs and, when they already exist on the map, to their live layers via setLayoutProperty.

Shared by subclasses (e.g. MaplibreMeasureControl, MaplibreValhallaControl) so their fontGlyphs setters can reuse the same layer-update logic.
Parameters
- fontNames: string[]
  font glyph names to apply as text-font
- layers: (SymbolLayerSpecification | undefined)[]
  symbol layer specs to update (undefined entries are skipped)
Returns void
Inherited from MaplibreTerradrawControl.applyFontGlyphs
- Defined in controls/MaplibreTerradrawControl.ts:94

cleanStyle

cleanStyle(
    style: StyleSpecification,
    options?: {
        excludeTerraDrawLayers?: boolean;
        onlyTerraDrawLayers?: boolean;
    },
): StyleSpecification
clean maplibre style to filter only for terradraw related layers or without them. If options are not set, returns original style given to the function.

This can be useful incase users only want to get terradraw related layers or without it.

Usage: cleanStyle(map.getStyle, { excludeTerraDrawLayers: true}) cleanStyle(map.getStyle, { onlyTerraDrawLayers: true})
Parameters
- style: StyleSpecification
  maplibre style spec
- Optionaloptions: { excludeTerraDrawLayers?: boolean; onlyTerraDrawLayers?: boolean }
  - OptionalexcludeTerraDrawLayers?: boolean
    
    return maplibre style without terradraw layers and sources
  - OptionalonlyTerraDrawLayers?: boolean
    
    return maplibre style with only terradraw layers and sources
Returns StyleSpecification
Overrides MaplibreTerradrawControl.cleanStyle
- Defined in controls/MaplibreValhallaControl.ts:337

`Protected`clearExtendedFeatures

clearExtendedFeatures(sourceIds: string[], ids?: FeatureId[] | undefined): void
Clear GeoJSON feature related to extended control such as measure and valhalla by TerraDraw feature ID
Parameters
- sourceIds: string[]
  the array of source ID to delete
- ids: FeatureId[] | undefined = undefined
  the array of feature ID. Optional, if undefined, delete all labels for source
Returns void
void
Inherited from MaplibreTerradrawControl.clearExtendedFeatures
- Defined in controls/MaplibreTerradrawControl.ts:895

`Protected`clearTextLayers

clearTextLayers(): void
Remove the {prefix}-text-labels symbol layer and the {prefix}-text GeoJSON source from the map.

Called when all features are deleted via handleDeleteAllFeatures.

Returns void
Inherited from MaplibreTerradrawControl.clearTextLayers
- Defined in controls/MaplibreTerradrawControl.ts:1135

`Protected`createTerradrawTextLayer

createTerradrawTextLayer(map: Map$1, styles?: TextModeStyling): void
Create (or refresh) the MapLibre GL symbol layer used to render committed text labels from TerraDrawTextMode.

Called automatically by onAdd when the text mode is active, and again after every TerraDraw finish event so newly committed labels appear immediately.

What this method does
1. Reads all committed text features from the TerraDraw snapshot (features where properties.mode === 'text' and properties.text is non-empty).
2. If the {prefix}-text GeoJSON source already exists, calls setData to update it in place (no layer teardown/rebuild).
3. If the source does not yet exist, adds the source and a {prefix}-text-labels symbol layer with defaults for text-field, text-size, text-font, text-color, and text-halo-*.
4. Calls map.moveLayer('{prefix}-text-labels') to ensure the symbol layer renders above all other TerraDraw layers.
The {prefix} comes from adapterOptions.prefixId (default 'td'), so with the default prefix the layer id is td-text-labels.
Parameters
- map: Map$1
  The MapLibre GL Map instance.
- Optionalstyles: TextModeStyling
  Optional style overrides forwarded to the MapLibre symbol layer.
Returns void
Inherited from MaplibreTerradrawControl.createTerradrawTextLayer
- Defined in controls/MaplibreTerradrawControl.ts:956

deactivate

deactivate(): void
Deactivate Terra Draw to stop drawing

Returns void
Inherited from MaplibreTerradrawControl.deactivate
- Defined in controls/MaplibreTerradrawControl.ts:392

`Protected`deleteSelectedTextSymbolLayer

deleteSelectedTextSymbolLayer(
selectedFeatures: GeoJSONStoreFeatures<GeoJSONStoreGeometries>[],
): void
Handle deletion of symbol text layer when mode === 'text'
Parameters
- selectedFeatures: GeoJSONStoreFeatures<GeoJSONStoreGeometries>[]
Returns void
Inherited from MaplibreTerradrawControl.deleteSelectedTextSymbolLayer
- Defined in controls/MaplibreTerradrawControl.ts:797

`Protected`dispatchEvent

dispatchEvent(event: EventType, args?: { [key: string]: unknown }): void
Dispatch an event. Pass the current snapshot of features and mode
Parameters
- event: EventType
  event type
- Optionalargs: { [key: string]: unknown }
  additional arguments
Returns void
Inherited from MaplibreTerradrawControl.dispatchEvent
- Defined in controls/MaplibreTerradrawControl.ts:365

getDefaultPosition

getDefaultPosition(): ControlPosition
Get the default control position

Returns ControlPosition
default control position. Default is 'top-right'
Inherited from MaplibreTerradrawControl.getDefaultPosition
- Defined in controls/MaplibreTerradrawControl.ts:212

getFeatures

getFeatures(
    onlySelected?: boolean,
):
    | {
        features: GeoJSONStoreFeatures<GeoJSONStoreGeometries>[];
        type: string;
    }
    | undefined
get GeoJSON features
Parameters
- onlySelected: boolean = false
  If true, returns only selected features. Default is false.
Returns
    | {
        features: GeoJSONStoreFeatures<GeoJSONStoreGeometries>[];
        type: string;
    }
    | undefined
FeatureCollection in GeoJSON format
Inherited from MaplibreTerradrawControl.getFeatures
- Defined in controls/MaplibreTerradrawControl.ts:637

getTerraDrawInstance

getTerraDrawInstance(): TerraDraw | undefined
Get the Terra Draw instance. For the Terra Draw API, please refer to https://terradraw.io/#/api

Returns TerraDraw | undefined
Terra Draw instance with additional extensions for the plugin control
Inherited from MaplibreTerradrawControl.getTerraDrawInstance
- Defined in controls/MaplibreTerradrawControl.ts:460

`Protected`getTextModeStyling

getTextModeStyling(): Partial<TextModeStyling>
Resolve text mode styles by merging defaults and user overrides.

Returns Partial<TextModeStyling>
Inherited from MaplibreTerradrawControl.getTextModeStyling
- Defined in controls/MaplibreTerradrawControl.ts:1033

`Protected`handleDeleteAllFeatures

handleDeleteAllFeatures(): void
Delete all features from the store

Returns void
Inherited from MaplibreTerradrawControl.handleDeleteAllFeatures
- Defined in controls/MaplibreTerradrawControl.ts:734

`Protected`handleDeleteSelectedFeatures

handleDeleteSelectedFeatures(): void
Delete selected features from the store.

Valhalla result features created from the same operation share properties.groupId (isochrone contour polygons of one request, or a route line and its node points). The selection is expanded to the whole group so that e.g. deleting one contour polygon removes its siblings, and deleting a route line removes its node points as well.

Returns void
Overrides MaplibreTerradrawControl.handleDeleteSelectedFeatures
- Defined in controls/MaplibreValhallaControl.ts:891

`Protected`handleDownload

handleDownload(): void
Download button click event handler

Returns void
Inherited from MaplibreTerradrawControl.handleDownload
- Defined in controls/MaplibreTerradrawControl.ts:819

`Protected`handleHistoryChange

handleHistoryChange(event: { redoSize: number; undoSize: number }): void
Handle the history event from TerraDraw to update undo/redo button states
Parameters
- event: { redoSize: number; undoSize: number }
  HistoryEvent from TerraDraw
Returns void
Inherited from MaplibreTerradrawControl.handleHistoryChange
- Defined in controls/MaplibreTerradrawControl.ts:485

`Protected`handleModeChange

handleModeChange(mode: string, target: TerraDraw): void
Handle mode change operations that should be executed after setMode is called
Parameters
- mode: string
  The active mode name
- target: TerraDraw
  The Terra Draw instance
Returns void
The result of the setMode operation
Inherited from MaplibreTerradrawControl.handleModeChange
- Defined in controls/MaplibreTerradrawControl.ts:406

off

off(event: EventType, callback: (event: EventArgs) => void): void
Unregister an event for the plugin
Parameters
- event: EventType
  event type
- callback: (event: EventArgs) => void
Returns void
Inherited from MaplibreTerradrawControl.off
- Defined in controls/MaplibreTerradrawControl.ts:352

on

on(event: EventType, callback: (event: EventArgs) => void): void
Register an event for the plugin
Parameters
- event: EventType
  event type
- callback: (event: EventArgs) => void
Returns void
Inherited from MaplibreTerradrawControl.on
- Defined in controls/MaplibreTerradrawControl.ts:338

onAdd

onAdd(map: Map$1): HTMLElement
add the plugin control to maplibre
Parameters
- map: Map$1
  Maplibre Map object
Returns HTMLElement
HTML Element
Overrides MaplibreTerradrawControl.onAdd
- Defined in controls/MaplibreValhallaControl.ts:299

onRemove

onRemove(): void
Remove the plugin control from maplibre

Returns void
void
Overrides MaplibreTerradrawControl.onRemove
- Defined in controls/MaplibreValhallaControl.ts:309

resetActiveMode

resetActiveMode(): void
Reset active mode to back to render mode

Returns void
Inherited from MaplibreTerradrawControl.resetActiveMode
- Defined in controls/MaplibreTerradrawControl.ts:516

`Protected`resetTextLabelLayer

resetTextLabelLayer(): void
Restore the default paint properties on the {prefix}-text-labels layer after a text feature is deselected.

Resets text-color, text-halo-color, and text-halo-width from TextModeStyling defaults. Also refreshes the GeoJSON source to clear the TerraDraw selected flag from the feature data.

Called automatically on terradraw.on('deselect').

Returns void
Inherited from MaplibreTerradrawControl.resetTextLabelLayer
- Defined in controls/MaplibreTerradrawControl.ts:1108

`Protected`selectTextLabelLayer

selectTextLabelLayer(featureId: FeatureId): void
Apply highlighted styles to the {prefix}-text-labels layer when a text feature is selected via TerraDrawSelectMode.

Refreshes the GeoJSON source so the TerraDraw selected property is current, then sets data-driven text-size and text-halo-color expressions that make the selected label slightly larger and give it a white halo. If the selected feature is not a text feature, delegates to resetTextLabelLayer instead.

Called automatically on terradraw.on('select').
Parameters
- featureId: FeatureId
  The TerraDraw feature ID that was selected.
Returns void
Inherited from MaplibreTerradrawControl.selectTextLabelLayer
- Defined in controls/MaplibreTerradrawControl.ts:1060

`Protected`showDeleteConfirmationDialog

showDeleteConfirmationDialog(
    onConfirm: () => void,
    title?: string,
    message?: string,
): void
Show delete confirmation dialog.
Parameters
- onConfirm: () => void
  Callback function that will be invoked when the user confirms deletion by clicking the "Delete" button in the dialog; typically used to delete all features before the dialog is closed.
- title: string = 'Delete All Features'
  Optional dialog title. Defaults to 'Delete All Features'.
- message: string = 'Are you sure you want to delete all features?'
  Optional dialog message. Defaults to 'Are you sure you want to delete all features?'.
Returns void
Inherited from MaplibreTerradrawControl.showDeleteConfirmationDialog
- Defined in controls/MaplibreTerradrawControl.ts:689

`Protected`syncButtonStates

syncButtonStates(mode: string): void
Synchronize button states with the current Terra Draw mode
Parameters
- mode: string
  The active mode name
Returns void
Inherited from MaplibreTerradrawControl.syncButtonStates
- Defined in controls/MaplibreTerradrawControl.ts:427

`Protected`toggleButtonsWhenNoFeature

toggleButtonsWhenNoFeature(): void
Toggle the state of buttons when there is no features

Returns void
Inherited from MaplibreTerradrawControl.toggleButtonsWhenNoFeature
- Defined in controls/MaplibreTerradrawControl.ts:834

`Protected`toggleDeleteSelectionButton

toggleDeleteSelectionButton(): void
Toggle the state of delete-select button

Returns void
Inherited from MaplibreTerradrawControl.toggleDeleteSelectionButton
- Defined in controls/MaplibreTerradrawControl.ts:858

`Protected`toggleEditor

toggleEditor(): void
Toggle editor control

Returns void
Inherited from MaplibreTerradrawControl.toggleEditor
- Defined in controls/MaplibreTerradrawControl.ts:508

Class MaplibreValhallaControl

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns MaplibreValhallaControl

Properties

Protected_cssPrefix

Protected Optional_fontGlyphs

Protected_isExpanded

Protected OptionalcontrolContainer

ProtecteddefaultMode

Protectedevents

Protected Optionalmap

ProtectedmodeButtons

Protectedoptions

Protected Optionalterradraw

Accessors

ProtectedcssPrefix

Returns string

distanceIsochroneCostingModel

Returns "auto" | "pedestrian" | "bicycle"

Example

Parameters

Returns void

Example

fontGlyphs

Returns string[]

Parameters

Returns void

isExpanded

Returns boolean

Parameters

Returns void

isochroneContours

Returns Contour[]

Parameters

Returns void

routingCostingModel

Returns "auto" | "pedestrian" | "bicycle"

Example

Parameters

Returns void

Example

routingDistanceUnit

Returns "kilometers" | "miles"

Example

Parameters

Returns void

Example

settingDialog

Returns ModalDialog

Parameters

Returns void

showDeleteConfirmation

Returns boolean

Parameters

Returns void

timeIsochroneCostingModel

Returns "auto" | "pedestrian" | "bicycle"

Example

Parameters

Returns void

Example

valhallaUrl

Returns string

Parameters

Returns void

Methods

activate

Returns void

ProtectedaddTerradrawButton

Parameters

Returns void

ProtectedaddTextFeaturesToSource

`Protected`_cssPrefix

`Protected` `Optional`_fontGlyphs

`Protected`_isExpanded

`Protected` `Optional`controlContainer

`Protected`defaultMode

`Protected`events

`Protected` `Optional`map

`Protected`modeButtons

`Protected`options

`Protected` `Optional`terradraw

`Protected`cssPrefix

`Protected`addTerradrawButton

`Protected`addTextFeaturesToSource

`Protected`applyFontGlyphs

`Optional`excludeTerraDrawLayers?: boolean

`Optional`onlyTerraDrawLayers?: boolean

`Protected`clearExtendedFeatures

`Protected`clearTextLayers

`Protected`createTerradrawTextLayer

`Protected`deleteSelectedTextSymbolLayer

`Protected`dispatchEvent

Returns
| {
features: GeoJSONStoreFeatures<GeoJSONStoreGeometries>[];
type: string;
}
| undefined

`Protected`getTextModeStyling

`Protected`handleDeleteAllFeatures

`Protected`handleDeleteSelectedFeatures

`Protected`handleDownload

`Protected`handleHistoryChange

`Protected`handleModeChange

`Protected`resetTextLabelLayer

`Protected`selectTextLabelLayer

`Protected`showDeleteConfirmationDialog

`Protected`syncButtonStates