@urban-toolkit/autk-grammar 5.2.0 → 5.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -331,6 +331,67 @@ The camera turns around the point the map looks at, which the view that fits the
331
331
  map: { id: 'downtown', camera: { zoom: 15, pitch: 50, bearing: 30 }, layerRefs: [{ dataRef: 'buildings' }] }
332
332
  ```
333
333
 
334
+ ### `terrain`
335
+
336
+ A map's `terrain` raises its ground to the heights a raster band gives, through autk-map's terrain mode: the ground the raster covers rises to its heights, the map's flat layers are draped over it, and its buildings stand on it. The view fits the raster, and the map's `camera` moves from there.
337
+
338
+ | Field | Effect |
339
+ |---|---|
340
+ | `dataRef` | The raster table of heights, in the workspace's units: a `geotiff` source of an elevation model in meters, for example. It is a table of the map's workspace. A cell without a value lies at height 0. |
341
+ | `band` | The band of heights, by its id (`band_1`, ...) or its label, as a raster layer's `getFnv` names one. Defaults to the first band. |
342
+
343
+ A run refuses a `dataRef` that names no raster table of the map's workspace, and a `band` that names none of the bands of a raster of several.
344
+
345
+ ```ts
346
+ data: [
347
+ { type: 'geojson', outputTableName: 'neighborhoods', geojsonFileUrl: '/data/mnt_neighs.geojson' },
348
+ { type: 'geotiff', outputTableName: 'elevation', geotiffFileUrl: '/data/mnt_dem.tif', coordinateFormat: 'EPSG:3857' },
349
+ ],
350
+ map: { terrain: { dataRef: 'elevation' }, camera: { zoom: 10, pitch: 60, bearing: 30 }, layerRefs: [{ dataRef: 'neighborhoods' }] },
351
+ ```
352
+
353
+ ### `style`
354
+
355
+ A map's `style` names one of autk-map's styles, such as `apple`, its default, or `light`, and a name autk-map does not know draws in `apple`. It can also give the colors of a style of the spec's own, each `#rrggbb`: autk-map takes a style only whole, so a run refuses one that lacks any of the nine.
356
+
357
+ | Color | Effect |
358
+ |---|---|
359
+ | `background` | The map's background, where no layer is drawn. |
360
+ | `surface`, `parks`, `water`, `roads`, `buildings`, `points`, `polylines`, `polygons` | The layers of each of those types. |
361
+
362
+ A layer with a `color` is drawn in it instead, and a layer colored by value in its scheme.
363
+
364
+ ```ts
365
+ map: {
366
+ style: {
367
+ background: '#0b1a2a', surface: '#13263a', parks: '#1f4d3a', water: '#08121d', roads: '#3a5068',
368
+ buildings: '#5b7083', points: '#f2c14e', polylines: '#7f97ad', polygons: '#2a3d52',
369
+ },
370
+ layerRefs: [{ dataRef: 'downtown_surface' }, { dataRef: 'downtown_roads' }, { dataRef: 'downtown_buildings' }],
371
+ }
372
+ ```
373
+
374
+ ### `highlightColor` and `invalidValueColor`
375
+
376
+ | Key | Effect |
377
+ |---|---|
378
+ | `highlightColor` | The color of the features the map draws as picked: by the user, by a layer's `pickedComps`, by a link, or by a call such as `highlightOnMap`, `#rrggbb`. autk-map's is `#5dade2`. |
379
+ | `invalidValueColor` | The color of the features of a layer colored by value whose value autk-map cannot color: one without a value, or with one that is not on the layer's scale, `#rrggbb`. autk-map's is `#ffffff`. |
380
+
381
+ autk-map keeps both for each map, unlike autk-plot's mark and highlight colors, which are the page's: each map of a spec draws in its own.
382
+
383
+ ```ts
384
+ map: { highlightColor: '#ff7f0e', invalidValueColor: '#bfbfbf', layerRefs: [{ dataRef: 'parcels', getFnv: 'value', isPick: true }] }
385
+ ```
386
+
387
+ ### `showUi`
388
+
389
+ autk-map puts a menu of the map's layers at the map's top left and a legend at its bottom right. A map with `showUi: false` has neither; its "made with autark" credit stays. Without it, or with `true`, the map shows both.
390
+
391
+ ```ts
392
+ map: { showUi: false, layerRefs: [{ dataRef: 'parcels', getFnv: 'area' }] }
393
+ ```
394
+
334
395
  ## Layer styling
335
396
 
336
397
  Besides `dataRef`, a layer of `map.layerRefs` takes these styling options:
@@ -348,6 +409,8 @@ Besides `dataRef`, a layer of `map.layerRefs` takes these styling options:
348
409
  | `colorMapReverse` | On a raster layer, runs the color scale from the highest value to the lowest, or from `colorMapRange`'s high to its low. |
349
410
  | `transferFunction` | On a raster layer, how opaque its cells are by value: autk-map's transfer function (`mode`, `opacityMin`, `opacityMax`, `gamma`, `zeroCenter`). `{ opacityMin: 1, opacityMax: 1 }` draws every cell with a value fully opaque. |
350
411
 
412
+ On a raster layer, `getFnv` names the band to draw: by its id, such as a GeoTIFF's `band_24`, or by its label, such as `count.noise` for a heatmap's `count_noise`. Without it, the layer draws the first band. A run refuses a `getFnv` that names none of the bands of a raster of several, and a raster of one band draws that band.
413
+
351
414
  After a run, `grammar.mapLayer(dataRef)` finds the layer a map draws for a table: the `AutkMap` and the layer's id in it, the last map's when several maps draw the table. `grammar.mapLayers(dataRef)` lists every layer that draws it, in every map. `highlightOnMap`, `clearHighlightOnMap` and a plot's `mapRef` also name layers by their `dataRef` (see [Interactions](#interactions)).
352
415
 
353
416
  ```ts
@@ -366,6 +429,64 @@ const { map, layerId } = grammar.mapLayer('routes')!; // layerId is 'Fastest rou
366
429
  map.updateRenderInfo(layerId, { opacity: 0.5 });
367
430
  ```
368
431
 
432
+ ### `buildingsZeroHeight`
433
+
434
+ autk-map leaves out a building part that has no height: none of `height`, `building:height`, `levels` and `building:levels`. A buildings layer with `buildingsZeroHeight: true` draws each such part with a random height of 3 to 7 floors of 3.4 m, from 10.2 to 23.8 m, so a city whose map data gives few heights is not left half empty. The heights are drawn again at each run. A part with one of those keys whose height is not above its minimum, such as `height: 0`, is still left out. Other layers ignore it.
435
+
436
+ ```ts
437
+ map: { layerRefs: [{ dataRef: 'downtown_buildings', buildingsZeroHeight: true }] }
438
+ ```
439
+
440
+ ### `legend`
441
+
442
+ A map's legend shows the color scale of one layer: the last layer whose colors autk-map set, about the last layer colored by value. A layer with `legend: true` is the one it shows, and on a raster layer, whose legend autk-map hides without a scale of its own, it shows it. Picking stays as the layers' `isPick` sets it: autk-map's own legend choice, `changeActiveLayer`, would also make the layer the only one of the map that picks.
443
+
444
+ A run refuses `legend` on two layers of a map, on a layer drawn in one color, and on a map whose `showUi` is `false`, which has no legend.
445
+
446
+ ```ts
447
+ map: { layerRefs: [{ dataRef: 'income', getFnv: 'median', legend: true }, { dataRef: 'schools', getFnv: 'enrollment', isPick: true }] }
448
+ ```
449
+
450
+ ### `skippedComps`
451
+
452
+ A layer's `skippedComps` lists the features it hides, by their positions among those it draws, as `map:picking` events and `highlightOnMap` give them: a filter the map applies as it is drawn. It hides features of every layer of polygons, lines, points or buildings. A run refuses it on a raster layer, and a position that is not a whole number from 0 or is past the last feature the layer draws. With autk-map 4.1.1, a hidden feature of a polygons or buildings layer can still be picked.
453
+
454
+ ```ts
455
+ map: { layerRefs: [{ dataRef: 'parcels', skippedComps: [2, 5] }] }
456
+ ```
457
+
458
+ ### `widthBy`
459
+
460
+ A roads layer draws each line as wide as autk-map draws its kind of road, and `width` gives every line one width. A roads layer's `widthBy` is the dot path to each line's own width, relative to `feature.properties`, in the map's planar units: autk-map's widths by feature. A line without a positive number there keeps the width of its kind of road.
461
+
462
+ autk-map draws every line of a polylines layer at one width, which wins over widths by feature, so a run refuses `widthBy` on a polylines layer: draw the table as roads, with `layerType: 'roads'`. A run also refuses `widthBy` with `width`, and a path that gives no line of the layer a width.
463
+
464
+ ```ts
465
+ map: { layerRefs: [{ dataRef: 'segments', layerType: 'roads', widthBy: 'compute.width', getFnv: 'traffic' }] }
466
+ ```
467
+
468
+ ### `layerType`
469
+
470
+ A layer draws its table as the table's own type, which its source or compute pass gave it. A layer's `layerType` draws the table as another type of its kind of geometry, in that type's color of the map's style and the way autk-map draws that type:
471
+
472
+ | Table | `layerType` |
473
+ |---|---|
474
+ | Polygons, and the surface, parks, water and buildings tables | `polygons`, `surface`, `parks`, `water`, or `buildings`, raised by each feature's height |
475
+ | Lines, and the roads tables | `polylines`, or `roads`, each line as wide as its kind of road |
476
+ | Points | `points` |
477
+ | A raster | `raster` |
478
+
479
+ A run refuses a type of another kind of geometry, for which autk-map would draw nothing. autk-map draws surface, parks, water and roads layers below every other layer, in that order, whatever the order of `layerRefs`.
480
+
481
+ ```ts
482
+ map: {
483
+ layerRefs: [
484
+ { dataRef: 'green_space', layerType: 'parks' }, // a polygons table, in the style's parks color
485
+ { dataRef: 'downtown_buildings', layerType: 'polygons' }, // the footprints, flat
486
+ ],
487
+ }
488
+ ```
489
+
369
490
  ## Plots and links
370
491
 
371
492
  A plot reads only its table's properties, so it also draws a table without a geometry, such as a CSV or JSON table loaded without `geometryColumns`.
@@ -515,6 +636,16 @@ A plot's `selection` lists the rows selected as it is drawn, by their feature id
515
636
  plot: { id: 'sizes', dataRef: 'parcels', mark: 'scatter', axis: ['area', 'perimeter'], mapRef: 'parcels', selection: [0, 4] }
516
637
  ```
517
638
 
639
+ ### `pickedComps`
640
+
641
+ A layer's `pickedComps` lists the features drawn as picked as the map is drawn, in the map's highlight color, as if the user had picked them: their positions among those the layer draws, as `map:picking` events and `highlightOnMap` give them. The run applies it once the plots and their links exist, as `highlightOnMap` does for that one layer: the layer highlights the features, and the plots linked to it select the same rows. No `map:picking` event reports it.
642
+
643
+ autk-map draws picked features only on the layer of a map that picks, and lets one layer of a map pick: the last that sets `isPick`, unless a link or a plot's `mapRef` makes another layer pick. So a layer with `pickedComps` sets `isPick: true`, and a run refuses `pickedComps` on a layer without it, or on a layer a later layer of its map, a link or a plot's `mapRef` takes picking from. A run also refuses it on a raster layer, on a layer linked to a plot that sets `selection`, and a position that is not a whole number from 0 or is past the last feature the layer draws.
644
+
645
+ ```ts
646
+ map: { layerRefs: [{ dataRef: 'parcels', isPick: true, pickedComps: [0, 4] }] }
647
+ ```
648
+
518
649
  ## Page layout
519
650
 
520
651
  A spec's `layout` says how its maps and plots are arranged on the page. The grammar's run never reads it: the page that hosts the views does, when it makes their canvases and elements, with `arrangeViews(spec)` (see [For hosts](#for-hosts)), so every host arranges a spec's views alike.
@@ -583,6 +714,8 @@ if (spec.workspaces) db = await adapter.resolveWorkspaces(db, spec.workspaces);
583
714
  for (const source of spec.data ?? []) db = await adapter.resolveSource(db, source);
584
715
  ```
585
716
 
717
+ The data adapter of either entry notes the coordinate system of each GeoJSON source it puts in its cache, and the two entries keep their notes in one place on the page. So a host may load a spec's tables with the data adapter of `./data` and run its passes with the compute adapter of the main entry, handing it that cache as `sources`: its passes read the sources' features as the grammar's do.
718
+
586
719
  ### Arranging the views
587
720
 
588
721
  `arrangeViews(spec)` returns:
@@ -1957,11 +1957,13 @@
1957
1957
  "MapLayerSpec": {
1958
1958
  "description": "One layer drawn by a map.",
1959
1959
  "if": {
1960
- "required": [
1961
- "colorMapRange"
1962
- ]
1960
+ "type": "object"
1963
1961
  },
1964
1962
  "properties": {
1963
+ "buildingsZeroHeight": {
1964
+ "description": "Draw the parts of a buildings layer that have no height, each with a random height of 3 to 7 floors of 3.4 m (10.2 to 23.8 m), rather than leave them out: autk-map's `buildingsZeroHeight`. A part has no height when it has none of `height`, `building:height`, `levels` and `building:levels`; a part with one of them whose height is not above its minimum, such as `0`, is still left out. The heights change at each run. Read by the Autark adapter for buildings layers; other layers and the deck.gl adapter ignore it.",
1965
+ "type": "boolean"
1966
+ },
1965
1967
  "catchAllCategory": {
1966
1968
  "type": "string"
1967
1969
  },
@@ -1985,7 +1987,7 @@
1985
1987
  "description": "Color scheme used when `isColorMap` is set."
1986
1988
  },
1987
1989
  "colorMapLabels": {
1988
- "description": "Legend labels. Read by the deck.gl adapter; the Autark adapter ignores it.",
1990
+ "description": "Legend labels. Neither adapter reads it.",
1989
1991
  "items": {
1990
1992
  "type": "string"
1991
1993
  },
@@ -2024,7 +2026,7 @@
2024
2026
  ]
2025
2027
  },
2026
2028
  "getFnv": {
2027
- "description": "Dot path to the thematic value, relative to `feature.properties` (for example `tags.highway` or `compute.result`).",
2029
+ "description": "Dot path to the thematic value, relative to `feature.properties` (for example `tags.highway` or `compute.result`). On a raster layer, the band to draw, by its id (`band_1`, ...) or its label (`count.noise` for a heatmap band labeled `count_noise`), the first band without it; on a raster of several bands, one that names none of them is refused.",
2028
2030
  "type": "string"
2029
2031
  },
2030
2032
  "getFnvType": {
@@ -2040,13 +2042,21 @@
2040
2042
  "type": "boolean"
2041
2043
  },
2042
2044
  "isPick": {
2043
- "description": "Allow picking features on this layer.",
2045
+ "description": "Allow picking features on this layer. autk-map lets one layer of a map pick: the last layer that sets it, unless a link or a plot's `mapRef` makes another layer of the map pick.",
2044
2046
  "type": "boolean"
2045
2047
  },
2046
2048
  "isSkip": {
2047
2049
  "description": "Load the layer without drawing it.",
2048
2050
  "type": "boolean"
2049
2051
  },
2052
+ "layerType": {
2053
+ "$ref": "#/definitions/LayerType",
2054
+ "description": "How the map draws the layer's table, in place of the table's own type, among the types of its kind of geometry: a table of polygons as `polygons`, `surface`, `parks`, `water` or `buildings` (raised by its heights), a table of lines as `polylines` or `roads`, a table of points as `points`, and a raster as `raster`. autk-map draws surface, parks, water and roads layers below the others, in that order, whatever the order of `layerRefs`. Read by the Autark adapter; the deck.gl adapter ignores it."
2055
+ },
2056
+ "legend": {
2057
+ "description": "Show this layer's color scale in the map's legend, which otherwise shows the last layer whose colors autk-map set, about the last layer colored by value. One layer of a map at most; a layer colored by value, or a raster, whose legend it shows; and a map that shows its controls. The layers pick as their `isPick` says. Read by the Autark adapter; the deck.gl adapter ignores it.",
2058
+ "type": "boolean"
2059
+ },
2050
2060
  "normalization": {
2051
2061
  "description": "How values are rescaled before coloring.",
2052
2062
  "properties": {
@@ -2074,8 +2084,11 @@
2074
2084
  "type": "boolean"
2075
2085
  },
2076
2086
  "pickedComps": {
2077
- "description": "Feature ids drawn as picked. Read by the deck.gl adapter; the Autark adapter ignores it.",
2087
+ "description": "Features drawn as picked from the start, in the map's highlight color, as if the user had picked them: their positions among the features the layer draws, as `map:picking` events give them. autk-map draws picked features only on the layer of a map that picks, so the layer sets `isPick: true`, and no later layer of its map sets it, nor does a link or a plot's `mapRef` make another layer of its map pick. The plots linked to the layer select the same rows. Read by the Autark adapter; the deck.gl adapter ignores it.",
2078
2088
  "items": {
2089
+ "description": "A row of a table as a view draws it: its position among the rows the view draws, from 0.",
2090
+ "minimum": 0,
2091
+ "multipleOf": 1,
2079
2092
  "type": "number"
2080
2093
  },
2081
2094
  "type": "array"
@@ -2093,6 +2106,16 @@
2093
2106
  "minItems": 1,
2094
2107
  "type": "array"
2095
2108
  },
2109
+ "skippedComps": {
2110
+ "description": "Features the layer hides, by their positions among the features it draws, as `map:picking` events give them. A hidden feature of a polygons or buildings layer can still be picked with autk-map 4.1.1. Read by the Autark adapter; the deck.gl adapter ignores it.",
2111
+ "items": {
2112
+ "description": "A row of a table as a view draws it: its position among the rows the view draws, from 0.",
2113
+ "minimum": 0,
2114
+ "multipleOf": 1,
2115
+ "type": "number"
2116
+ },
2117
+ "type": "array"
2118
+ },
2096
2119
  "stroke": {
2097
2120
  "anyOf": [
2098
2121
  {
@@ -2115,20 +2138,69 @@
2115
2138
  "description": "How opaque a raster layer's cells are by value, as autk-map's transfer function: for example `{ opacityMin: 1, opacityMax: 1 }` draws every cell with a value fully opaque. Read by the Autark adapter for raster layers; other layers and the deck.gl adapter ignore it."
2116
2139
  },
2117
2140
  "width": {
2118
- "description": "Width of the lines of a polylines or roads layer, in the map's planar units (about meters). It replaces the widths a roads layer gives each kind of road. Read by the Autark adapter; the deck.gl adapter ignores it.",
2141
+ "description": "Width of the lines of a polylines or roads layer, in the map's planar units (about meters). It replaces the widths a roads layer gives each kind of road. Not with `widthBy`. Read by the Autark adapter; the deck.gl adapter ignores it.",
2119
2142
  "exclusiveMinimum": 0,
2120
2143
  "type": "number"
2144
+ },
2145
+ "widthBy": {
2146
+ "description": "Dot path to the width of each line of a roads layer, relative to `feature.properties`, in the map's planar units (about meters), as `width` gives every line one: autk-map's widths by feature. A line without a positive number there keeps the width of its kind of road. autk-map draws every line of a polylines layer at one width, so a table of lines takes it drawn as roads, with `layerType: 'roads'`. Not with `width`. Read by the Autark adapter; the deck.gl adapter ignores it.",
2147
+ "minLength": 1,
2148
+ "type": "string"
2121
2149
  }
2122
2150
  },
2123
2151
  "required": [
2124
2152
  "dataRef"
2125
2153
  ],
2126
2154
  "then": {
2127
- "not": {
2128
- "required": [
2129
- "colorMapDomain"
2130
- ]
2131
- }
2155
+ "allOf": [
2156
+ {
2157
+ "if": {
2158
+ "required": [
2159
+ "colorMapRange"
2160
+ ]
2161
+ },
2162
+ "then": {
2163
+ "not": {
2164
+ "required": [
2165
+ "colorMapDomain"
2166
+ ]
2167
+ }
2168
+ }
2169
+ },
2170
+ {
2171
+ "if": {
2172
+ "required": [
2173
+ "pickedComps"
2174
+ ]
2175
+ },
2176
+ "then": {
2177
+ "not": {
2178
+ "properties": {
2179
+ "isPick": {
2180
+ "const": false
2181
+ }
2182
+ }
2183
+ },
2184
+ "required": [
2185
+ "isPick"
2186
+ ]
2187
+ }
2188
+ },
2189
+ {
2190
+ "if": {
2191
+ "required": [
2192
+ "widthBy"
2193
+ ]
2194
+ },
2195
+ "then": {
2196
+ "not": {
2197
+ "required": [
2198
+ "width"
2199
+ ]
2200
+ }
2201
+ }
2202
+ }
2203
+ ]
2132
2204
  },
2133
2205
  "type": "object"
2134
2206
  },
@@ -2139,11 +2211,19 @@
2139
2211
  "$ref": "#/definitions/CameraSpec",
2140
2212
  "description": "Where the map looks from."
2141
2213
  },
2214
+ "highlightColor": {
2215
+ "$ref": "#/definitions/HexColor",
2216
+ "description": "The color of the features the map draws as picked, by the user, a layer's `pickedComps`, a link or a call such as `highlightOnMap`, `#rrggbb`. Each map has its own; autk-map's is `#5dade2`. Read by the Autark adapter; the deck.gl adapter ignores it."
2217
+ },
2142
2218
  "id": {
2143
2219
  "description": "Name of the map, which a link in `links` uses as its `target`. Unique among the ids of the maps and plots.",
2144
2220
  "minLength": 1,
2145
2221
  "type": "string"
2146
2222
  },
2223
+ "invalidValueColor": {
2224
+ "$ref": "#/definitions/HexColor",
2225
+ "description": "The color of the features of a layer colored by value whose value autk-map cannot color: one without a value, or with one that is not on the layer's scale, `#rrggbb`. Each map has its own; autk-map's is `#ffffff`. Read by the Autark adapter; the deck.gl adapter ignores it."
2226
+ },
2147
2227
  "layerRefs": {
2148
2228
  "description": "Layers to draw, bottom first. Each names a table with `dataRef`.",
2149
2229
  "items": {
@@ -2151,9 +2231,24 @@
2151
2231
  },
2152
2232
  "type": "array"
2153
2233
  },
2234
+ "showUi": {
2235
+ "description": "Whether autk-map shows its floating controls on the map: the menu of its layers and the legend. `false` hides them, and the \"made with autark\" credit stays. Defaults to `true`. Read by the Autark adapter; the deck.gl adapter ignores it.",
2236
+ "type": "boolean"
2237
+ },
2154
2238
  "style": {
2155
- "description": "Map style.",
2156
- "type": "string"
2239
+ "anyOf": [
2240
+ {
2241
+ "type": "string"
2242
+ },
2243
+ {
2244
+ "$ref": "#/definitions/MapStyleColors"
2245
+ }
2246
+ ],
2247
+ "description": "Map style: the name of one of autk-map's styles, such as `apple`, its default, or `light` (a name autk-map does not know draws in `apple`), or the colors of a style of the spec's own. A layer with a `color` is drawn in it instead, and a layer colored by value in its scheme. Read by the Autark adapter; the deck.gl adapter ignores it."
2248
+ },
2249
+ "terrain": {
2250
+ "$ref": "#/definitions/TerrainSpec",
2251
+ "description": "A 3D ground from an elevation raster: autk-map raises the ground the raster covers to its heights, drapes the map's flat layers over it, stands its buildings on it, and fits the view to it, from which `camera` moves. Read by the Autark adapter; the deck.gl adapter ignores it."
2157
2252
  },
2158
2253
  "workspace": {
2159
2254
  "$ref": "#/definitions/WorkspaceName",
@@ -2165,6 +2260,59 @@
2165
2260
  ],
2166
2261
  "type": "object"
2167
2262
  },
2263
+ "MapStyleColors": {
2264
+ "description": "The colors of a map style of the spec's own, each `#rrggbb`: the background, and the color of each kind of layer drawn in one color. autk-map takes a style only whole, so each of the nine is given. Read by the Autark adapter; the deck.gl adapter ignores it.",
2265
+ "properties": {
2266
+ "background": {
2267
+ "$ref": "#/definitions/HexColor",
2268
+ "description": "The map's background, where no layer is drawn."
2269
+ },
2270
+ "buildings": {
2271
+ "$ref": "#/definitions/HexColor",
2272
+ "description": "Buildings layers."
2273
+ },
2274
+ "parks": {
2275
+ "$ref": "#/definitions/HexColor",
2276
+ "description": "Parks layers."
2277
+ },
2278
+ "points": {
2279
+ "$ref": "#/definitions/HexColor",
2280
+ "description": "Points layers."
2281
+ },
2282
+ "polygons": {
2283
+ "$ref": "#/definitions/HexColor",
2284
+ "description": "Polygons layers."
2285
+ },
2286
+ "polylines": {
2287
+ "$ref": "#/definitions/HexColor",
2288
+ "description": "Polylines layers."
2289
+ },
2290
+ "roads": {
2291
+ "$ref": "#/definitions/HexColor",
2292
+ "description": "Roads layers."
2293
+ },
2294
+ "surface": {
2295
+ "$ref": "#/definitions/HexColor",
2296
+ "description": "Surface layers: the ground of an area."
2297
+ },
2298
+ "water": {
2299
+ "$ref": "#/definitions/HexColor",
2300
+ "description": "Water layers."
2301
+ }
2302
+ },
2303
+ "required": [
2304
+ "background",
2305
+ "surface",
2306
+ "parks",
2307
+ "water",
2308
+ "roads",
2309
+ "buildings",
2310
+ "points",
2311
+ "polylines",
2312
+ "polygons"
2313
+ ],
2314
+ "type": "object"
2315
+ },
2168
2316
  "MultiLineString": {
2169
2317
  "description": "MultiLineString geometry object. https://tools.ietf.org/html/rfc7946#section-3.1.5",
2170
2318
  "properties": {
@@ -3616,6 +3764,25 @@
3616
3764
  ],
3617
3765
  "type": "object"
3618
3766
  },
3767
+ "TerrainSpec": {
3768
+ "description": "The ground of a map in 3D, raised to the heights a raster band gives. Read by the Autark adapter; the deck.gl adapter ignores it.",
3769
+ "properties": {
3770
+ "band": {
3771
+ "description": "The band of heights, by its id (`band_1`, ...) or its label, as a raster layer's `getFnv` names one. Defaults to the first band. On a raster of several bands, a band that names none of them is refused.",
3772
+ "minLength": 1,
3773
+ "type": "string"
3774
+ },
3775
+ "dataRef": {
3776
+ "description": "Name of the raster table whose band gives the ground's height in each of its cells, in the workspace's units, such as a `geotiff` source of an elevation model in meters. It is a table of the map's workspace. A cell without a value lies at height 0.",
3777
+ "minLength": 1,
3778
+ "type": "string"
3779
+ }
3780
+ },
3781
+ "required": [
3782
+ "dataRef"
3783
+ ],
3784
+ "type": "object"
3785
+ },
3619
3786
  "UpdateSourceSpec": {
3620
3787
  "description": "Replaces or changes the rows of a table already loaded, with rows given inline: a FeatureCollection for a table with a geometry, an array of objects for a table without one. Read by the Autark adapter only.",
3621
3788
  "else": {