Interface MeasureControlOptions

TerraDrawMaplibreGLAdapter options. Please refer the default adapter settings (BaseAdapterConfig) at the below TerraDraw code. https://github.com/JamesLMilner/terra-draw/blob/806e319d5680a3f69edeff7dd629da3f1b4ff9bf/src/adapters/common/base.adapter.ts#L28-L48

The precision of area value. Using setter to override the value if you want.

The unit of area can be metric (m², ha, km²) or imperial (acre, mi²). Default is metric

Compute elevation for each node in linestring measure mode. This is an optional parameter and default is False. If true, the property of elevation is added to TerraDraw feature. As default, an elevation is not shown in label if it is negative value (The data is added to the feature property though). If you wish to show negative value of altitude, you may need to edit your own lineLayerLabelSpec style spec.

If terrainSource is set, this feature uses queryTerrainElevation function of maplibre-gl, thus you have to add and enable raster-dem source in maplibre style in advance.

For instance, the below code is to add Terrarium source from AWS

map?.addSource('terrarium', {
  type: 'raster-dem',
  attribution: '&copy; <a href="https://github.com/tilezen/joerd/blob/master/docs/attribution.md" target="_blank" rel="noopener">Tilezen Joerd</a>',
  tiles: [
    'https://s3.amazonaws.com/elevation-tiles-prod/terrarium/{z}/{x}/{y}.png'
  ],
  minzoom:0, maxzoom: 5, tileSize: 256,
  encoding: 'terrarium',
  bounds: [-180, -90, 180, 90]
})
map?.setTerrain({source: 'terrarium', exaggeration: 1})
Copy

The plugin control is just querying elevation from maplibre style's DEM source. Hence, the elevation's accuracy may not be good and queried elevation might be different each zoom level.

If terrainSource is set to use either terrainRGB or terrarium source, the plugin will try to fetch elevation directly from DEM tiles.

The precision of distance value. It will be set different value dwhen distance unit is changed. Using setter to override the value if you want.

The unit of distance can be degrees, radians, miles, or kilometers (default 'kilometers')

Maplibre symbol layer specification (on line nodes) for line distance layer

Maplibre circle layer specification for visualizing node style of line distance layer

Overwrite Terra Draw mode options if you specified.

Terradraw modes added to the control. The mode will be added in the same order of the array. Default is all modes in the below order: ['render','point','linestring','polygon', 'rectangle','angled-rectangle','circle', 'freehand','sector','sensor', 'delete']

You can change the order of modes, or can get rid of some modes which you don't need for your app.

Open editor as default if true. Default is false

Maplibre symbol layer specification (on points) for point layer

Maplibre symbol layer specification (centroid) for polygon area layer

terrain source either terrain RGB or terrarium formats for computing elevation If undefined is set to this option, the plugin tries to fetch elevation enabled terrain of maplibre. As default, terrarium source from AWS is set.