Class MaplibreValhallaControl

Maplibre GL Terra Draw Measure Control

Hierarchy (View Summary)

MaplibreTerradrawControl
- MaplibreValhallaControl

Constructors

constructor

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

Properties

`Protected`_cssPrefix

_cssPrefix: 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 = defaultControlOptions

`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 src/lib/controls/MaplibreTerradrawControl.ts:42

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[]
- Defined in src/lib/controls/MaplibreValhallaControl.ts:182
set fontGlyphs(fontNames: string[]): void
Parameters
- fontNames: string[]
Returns void
- Defined in src/lib/controls/MaplibreValhallaControl.ts:190

isExpanded

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

Returns boolean
Inherited from MaplibreTerradrawControl.isExpanded
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:34
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 src/lib/controls/MaplibreTerradrawControl.ts:51

isochroneContours

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

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

isochroneContourType

get isochroneContourType(): "distance" | "time"
Get the contour type for Valhalla isochrone api

Returns "distance" | "time"
ContourType
Example
```
'time', 'distance'
```
- Defined in src/lib/controls/MaplibreValhallaControl.ts:107
set isochroneContourType(value: "distance" | "time"): void
Set the contour type for Valhalla isochrone api
Parameters
- value: "distance" | "time"
  ContourType
Returns void
Example
```
'time', 'distance'
```
- Defined in src/lib/controls/MaplibreValhallaControl.ts:115

isochroneCostingModel

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

Returns "auto" | "pedestrian" | "bicycle"
isochroneCostingModelType
Example
```
'pedestrian', 'bicycle', 'auto'
```
- Defined in src/lib/controls/MaplibreValhallaControl.ts:128
set isochroneCostingModel(value: "auto" | "pedestrian" | "bicycle"): void
Set the means of transport for Valhalla isochrone api
Parameters
- value: "auto" | "pedestrian" | "bicycle"
  isochroneCostingModelType
Returns void
Example
```
'pedestrian', 'bicycle', 'auto'
```
- Defined in src/lib/controls/MaplibreValhallaControl.ts:136

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 src/lib/controls/MaplibreValhallaControl.ts:64
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 src/lib/controls/MaplibreValhallaControl.ts:72

routingDistanceUnit

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

Returns "kilometers" | "miles"
routingDistanceUnitType
Example
```
'kilometers', 'miles'
```
- Defined in src/lib/controls/MaplibreValhallaControl.ts:85
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 src/lib/controls/MaplibreValhallaControl.ts:94

settingDialog

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

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

valhallaUrl

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

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

Methods

activate

activate(): void
Activate Terra Draw to start drawing

Returns void
Overrides MaplibreTerradrawControl.activate
- Defined in src/lib/controls/MaplibreValhallaControl.ts:306

`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 src/lib/controls/MaplibreValhallaControl.ts:734

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 src/lib/controls/MaplibreValhallaControl.ts:326

`Protected`clearExtendedFeatures

clearExtendedFeatures(sourceIds: string[], ids?: FeatureId[]): 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
  the array of feature ID. Optional, if undefined, delete all labels for source
Returns void
void
Inherited from MaplibreTerradrawControl.clearExtendedFeatures
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:610

deactivate

deactivate(): void
Deactivate Terra Draw to stop drawing

Returns void
Inherited from MaplibreTerradrawControl.deactivate
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:293

`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 src/lib/controls/MaplibreTerradrawControl.ts:266

getDefaultPosition

getDefaultPosition(): ControlPosition
Get the default control position

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

getFeatures

getFeatures(
onlySelected?: boolean,
): { features: GeoJSONStoreFeatures[]; type: string }
get GeoJSON features
Parameters
- onlySelected: boolean = false
  If true, returns only selected features. Default is false.
Returns { features: GeoJSONStoreFeatures[]; type: string }
FeatureCollection in GeoJSON format
Overrides MaplibreTerradrawControl.getFeatures
- Defined in src/lib/controls/MaplibreValhallaControl.ts:1127

getTerraDrawInstance

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

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

`Protected`handleDownload

handleDownload(): void
Download button click event handler

Returns void
Inherited from MaplibreTerradrawControl.handleDownload
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:534

`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 src/lib/controls/MaplibreTerradrawControl.ts:307

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 src/lib/controls/MaplibreTerradrawControl.ts:253

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 src/lib/controls/MaplibreTerradrawControl.ts:239

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 src/lib/controls/MaplibreValhallaControl.ts:288

onRemove

onRemove(): void
Remove the plugin control from maplibre

Returns void
void
Overrides MaplibreTerradrawControl.onRemove
- Defined in src/lib/controls/MaplibreValhallaControl.ts:298

resetActiveMode

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

Returns void
Inherited from MaplibreTerradrawControl.resetActiveMode
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:387

`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 src/lib/controls/MaplibreTerradrawControl.ts:328

`Protected`toggleButtonsWhenNoFeature

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

Returns void
Inherited from MaplibreTerradrawControl.toggleButtonsWhenNoFeature
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:549

`Protected`toggleDeleteSelectionButton

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

Returns void
Inherited from MaplibreTerradrawControl.toggleDeleteSelectionButton
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:573

`Protected`toggleEditor

toggleEditor(): void
Toggle editor control

Returns void
Inherited from MaplibreTerradrawControl.toggleEditor
- Defined in src/lib/controls/MaplibreTerradrawControl.ts:379

Class MaplibreValhallaControl

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns MaplibreValhallaControl

Properties

Protected_cssPrefix

Protected_isExpanded

Protected OptionalcontrolContainer

ProtecteddefaultMode

Protectedevents

Protected Optionalmap

ProtectedmodeButtons

Protectedoptions

Protected Optionalterradraw

Accessors

ProtectedcssPrefix

Returns string

fontGlyphs

Returns string[]

Parameters

Returns void

isExpanded

Returns boolean

Parameters

Returns void

isochroneContours

Returns Contour[]

Parameters

Returns void

isochroneContourType

Returns "distance" | "time"

Example

Parameters

Returns void

Example

isochroneCostingModel

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

Example

Parameters

Returns void

Example

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

valhallaUrl

Returns string

Parameters

Returns void

Methods

activate

Returns void

ProtectedaddTerradrawButton

Parameters

Returns void

cleanStyle

Parameters

OptionalexcludeTerraDrawLayers?: boolean

OptionalonlyTerraDrawLayers?: boolean

Returns StyleSpecification

ProtectedclearExtendedFeatures

`Protected`_cssPrefix

`Protected`_isExpanded

`Protected` `Optional`controlContainer

`Protected`defaultMode

`Protected`events

`Protected` `Optional`map

`Protected`modeButtons

`Protected`options

`Protected` `Optional`terradraw

`Protected`cssPrefix

`Protected`addTerradrawButton

`Optional`excludeTerraDrawLayers?: boolean

`Optional`onlyTerraDrawLayers?: boolean

`Protected`clearExtendedFeatures

`Protected`dispatchEvent

`Protected`handleDownload

`Protected`handleModeChange

`Protected`syncButtonStates

`Protected`toggleButtonsWhenNoFeature

`Protected`toggleDeleteSelectionButton

`Protected`toggleEditor