Connect to online API’s and pull in attribute tables

"type": "api-table"

ApiTableCatalogItemTraits

TraitTypeDefaultDescription
apisApiTableRequestTraits[]The apis to use to retrieve the data of the table. Note: you must define which columns to use from API response in the columns TableColumnTraits – for example [{name:"some-key-in-api-response", ...}]
idKeystringThe name of the id property shared between all APIs
shouldAppendNewDatastringtrueWhen true, new data received through APIs will be appended to existing data. If false, new data will replace existing data.
ApiRequestTraits
queryParametersQueryParamTraits[]Query parameters to supply to the API
updateQueryParametersQueryParamTraits[]Query parameters to supply to the API on subsequent calls after the first call.
requestDataanyJSON body to be sent with the HTTP request to the server. If provided, the request will be made as POST rather than a GET.
postRequestDataAsFormDatabooleanSend the request data as form data instead of a JSON body.
responseDataPathstringPath to relevent data in JSON response. eg: some.user.namesome.users[0].name or some.users[].name
AttributionTraits
attributionstringThe attribution to display with the data.
AutoRefreshingTraits
refreshIntervalnumberHow often the data in this model is refreshed, in seconds
refreshEnabledbooleantrueToggle for enabling auto refresh.
CatalogMemberTraits
namestringThe name of the catalog item.
descriptionstringThe description of the catalog item. Markdown and HTML may be used.
nameInCatalogstringThe name of the item to be displayed in the catalog, if it is different from the one to display in the workbench.
infoInfoSectionTraits[]Human-readable information about this dataset.
infoSectionOrderstring[]An array of section titles defining the display order of info sections. If this property is not defined, {@link DataPreviewSections}’s DEFAULT_SECTION_ORDER is used
isOpenInWorkbenchbooleantrueWhether the item in the workbench open or collapsed.
shortReportstringA short report to show on the now viewing tab.
shortReportSectionsShortReportTraits[]A list of collapsible sections of the short report
isExperiencingIssuesbooleanWhether the catalog item is experiencing issues which may cause its data to be unavailable
hideSourcebooleanIndicates that the source of this data should be hidden from the UI (obviously this isn’t super-secure as you can just look at the network requests).
metadataUrlsMetadataUrlTraits[]Metadata URLs to show in data catalog.
dataUrlsDataUrlTraits[]Data URLs to show in data catalog.
dataCustodianstringGets or sets a description of the custodian of this data item.
modelDimensionsEnumDimensionTraits[]This provides ability to set model JSON through SelectableDimensions (a dropdown). When an option is selected, the value property will be used to call updateModelFromJson(). All string properties support Mustache templates (with the catalog member as context)
disableAboutDatabooleanDisables the ‘About Data’ button in the workbench.
ChartPointOnMapTraits
chartPointOnMapLatLonHeightTraitsThe point on map where the current chart for the item was generated from. A marker will be shown at this point if the chart is active.
ChartTraits
chartTypestringType determines how the data availibility will be plotted on chart. eg: momentLines, momentPoints
chartDisclaimerstringA HTML string to show above the chart as a disclaimer
chartColorstringThe color to use when the data set is displayed on the chart. The value can be any html color string, eg: ‘cyan’ or ‘#00ffff’ or ‘rgba(0, 255, 255, 1)’ for the color cyan.
chartGlyphStylestringThe glyph style to use for points plotted on the chart. Allowed values include circle, cross, diamond, square, star, triangle, wye. Default is “circle”.
DiscretelyTimeVaryingTraits
fromContinuousstringnearestSpecifies how a continuous time (e.g. the timeline control) is mapped to a discrete time for this dataset. Valid values are:
nearest – the nearest available discrete time to the current continuous time is used.
next – the discrete time equal to or after the current continuous time is used.
previous – the discrete time equal to or before the current continuous time is used.
showInChartPanelbooleantrueWhether to plot data availability on a chart.
disableDateTimeSelectorbooleantrueWhen true, disables the date time selector in the workbench
multiplierDefaultDeltaStepnumber2The multiplierDefaultDeltaStep is used to set the default multiplier (see TimeVaryingTraits.multiplier trait) – it represents the average number of (real-time) seconds between (dataset) time steps. For example, a value of five would set the multiplier so that a new time step (of this dataset) would appear every five seconds (on average) if the timeline is playing. This trait will only take effect if multiplier is not explicitly set.
ExportableTraits
disableExportbooleanDisable user export functionality
LayerOrderingTraits
keepOnTopbooleanKeeps the layer on top of all other imagery layers.
supportsReorderingbooleantrueDoes this layer support reordering in the workbench.
LegendOwnerTraits
legendsLegendTraits[]The legends to display on the workbench.
legendBackgroundColorstringApply background color to all legends. This can be useful if legends are transparent and clash with Terria colours
hideLegendInWorkbenchbooleanWhether the legend is hidden in the workbench for this catalog member.
MappableTraits
rectangleRectangleTraitsThe bounding box rectangle that contains all the data in this catalog item.
idealZoomIdealZoomTraitsOverride default ideal zoom if the given values are valid.
disablePreviewbooleanDisables the preview on the Add Data panel. This is useful when the preview will be very slow to load.
disableZoomTobooleantrueDisables the zoom to (aka ‘Ideal Zoom’) button in the workbench.
zoomOnAddToWorkbenchbooleanZoom to dataset when added to workbench. Doesn’t work if disableZoomTo is true.
showbooleantrueShow or hide a workbench item. When show is false, a mappable item is removed from the map and a chartable item is removed from the chart panel.
initialMessageInitialMessageTraitsA message to show when the user adds the catalog item to the workbench. Useful for showing disclaimers.
featureInfoTemplateFeatureInfoTemplateTraitsA template object for formatting content in feature info panel
showStringIfPropertyValueIsNullstringIf the value of a property is null or undefined, show the specified string as the value of the property. Otherwise, the property name will not be listed at all.
maximumShownFeatureInfosnumberThe maximum number of “feature infos” that can be displayed in feature info panel.
OpacityTraits
opacitynumber0.8The opacity of the item.
disableOpacityControlbooleantrueWhen true, the user will be unable to change the opacity of the item
SplitterTraits
splitDirectionnumberThe side of the splitter to display this imagery layer on. Defaults to both sides.
disableSplitterbooleantrueIf true, splitter funcitonality will be hidden for this model.
TableTraits
showUnmatchedRegionsWarningbooleantrueTrue to show a warning when some of the region IDs in the CSV file could not be matched to a region. False to silently ignore unmatched regions.
columnsTableColumnTraits[]Options for individual columns/variables.
defaultColumnTableColumnTraitsThe default settings to use for all columns/variables
stylesTableStyleTraits[]The set of styles that can be used to visualize this dataset.
defaultStyleTableStyleTraitsThe default style to apply when visualizing any column/variable.
activeStylestringThe ID of the currently-selected style.
enableManualRegionMappingbooleanIf enabled, there will be controls to set region column/variable and region type.
showDisableStyleOptionbooleanIf enabled, there will be an option in styleDimension to disable styling.
showDisableTimeOptionbooleanIf enabled, there will be an checkbox to disable time.
columnTitlesstring[]An optional array of column/variable titles that override the individual TableColumnTraits.title setting.
columnUnitsstring[]An optional array of column/variable units that override the individual TableColumnTraits.unit setting.
removeDuplicateRowsbooleanIf two rows in the table are identical, only retain one copy. This could cause performance issues, and so should be used only when absolutely necessary.
TimeVaryingTraits
timeLabelstringTime label which is shown in workbench next to date/time selector (Will default to t(“dateTime.selectorLabel”) = “Time:”).
currentTimestringThe current time at which to show this dataset.
initialTimeSourcestringstartThe initial time to use if Current Time is not specified. Valid values are
start – the dataset’s start time
stop – the dataset’s stop time
now – the current system time. If the system time is after Stop TimeStop Time is used. If the system time is before Start TimeStart Time is used.
none – do not automatically set an initial time
This value is ignored if Current Time is specified.
startTimestringThe earliest time for which this dataset is available. This will be the start of the range shown on the timeline control.
stopTimestringThe latest time for which this dataset is available. This will be the end of the range shown on the timeline control.
multipliernumberThe multiplier to use in progressing time for this dataset. For example, 5.0 means that five seconds of dataset time will pass for each one second of real time.
isPausedbooleantrueTrue if time is currently paused for this dataset, or false if it is progressing.
dateFormatstringA dateformat string (using the dateformat package) used to adjust the presentation of the date in various spots in the UI for a catalog item.
For example, to just show the year set to ‘yyyy’. Used in places like the the Workbench Item and Bottom Dock
UrlTraits
urlstringThe base URL of the file or service.
forceProxybooleanForce the default proxy to be used for all network requests.
cacheDurationstringThe cache duration to use for proxied URLs for this catalog member. If undefined, proxied URLs are effectively cachable forever. The duration is expressed as a Varnish-like duration string, such as ‘1d’ (one day) or ‘10000s’ (ten thousand seconds).

ApiTableRequestTraits

TraitTypeDefaultDescription
kindstringPER_ROWDetermines how table rows are constructed from this API.

  • PER_ROW: Row major, values are specific to a row in the table eg. [{“col1”: 12, “col2”: 13}]
  • PER_ID: Values are the same for all objects with the same id.
  • COLUMN_MAJOR: API response is in a column major format, eg. [{“row1”: 12, “row2”: 13}]. The keys in each list item (eg. “row1”) will be used as the row id.
columnMajorColumnNamesstring[]valueUsed when kind is “COLUMN_MAJOR”. The name of each column in the order they appear in the API response.
ApiRequestTraits
queryParametersQueryParamTraits[]Query parameters to supply to the API
updateQueryParametersQueryParamTraits[]Query parameters to supply to the API on subsequent calls after the first call.
requestDataanyJSON body to be sent with the HTTP request to the server. If provided, the request will be made as POST rather than a GET.
postRequestDataAsFormDatabooleanSend the request data as form data instead of a JSON body.
responseDataPathstringPath to relevent data in JSON response. eg: some.user.namesome.users[0].name or some.users[].name
UrlTraits
urlstringThe base URL of the file or service.
forceProxybooleanForce the default proxy to be used for all network requests.
cacheDurationstringThe cache duration to use for proxied URLs for this catalog member. If undefined, proxied URLs are effectively cachable forever. The duration is expressed as a Varnish-like duration string, such as ‘1d’ (one day) or ‘10000s’ (ten thousand seconds).

QueryParamTraits

TraitTypeDefaultDescription
namestringThe name of the query parameter.
valuestringThe value of the query parameter. Parameter values starting with DATE!, eg. DATE!HH:MM, will be replaced wih the current date and time, formatted according to the format string following the !. For more information on the format string format, see the dateformat library.

InfoSectionTraits

TraitTypeDefaultDescription
namestringThe name of the section.
contentstringThe content of the section, in Markdown and HTML format. Set this property to null to remove this section entirely.
contentAsObjectanyThe content of the section which is a JSON object. Set this property to null to remove this section entirely.
showbooleantrueIndicates if this info section showing (not collapsed).

ShortReportTraits

TraitTypeDefaultDescription
namestringThe name of the section.
contentstringThe content of the section.
showbooleantrueIndicates if this short report section showing.

MetadataUrlTraits

TraitTypeDefaultDescription
urlstringThe metadata URL of the file or service.
titlestringTitle used for metadata URL button.

DataUrlTraits

TraitTypeDefaultDescription
typestringType of data URL. This value will be used to provide context or instruction on how to use the data URL. For example wcs will provide a link to WCS docs. Current supported values are: – wfs = A Web Feature Service (WFS) base URL – wcs = A Web Coverage Service (WCS) base URL – wfs-complete = A complete, ready-to-use link to download features from a WCS server – wcs-complete = A complete, ready-to-use link to download features from a WFS server – direct = Direct URL to dataset (this is the default if no type is specified) – none = Hide data URL
MetadataUrlTraits
urlstringThe metadata URL of the file or service.
titlestringTitle used for metadata URL button.

EnumDimensionTraits

TraitTypeDefaultDescription
idstringDimension ID
namestringDimension name (human-readable)
optionsDimensionOptionTraits[]Dimension options
selectedIdstringSelected Option’s ID
allowUndefinedbooleanAllow dimension to be undefined
disablebooleanHides dimension

DimensionOptionTraits

TraitTypeDefaultDescription
idstringOption ID
namestringOption name (human-readable)
valueanyValue (if this is undefined, id will be used)

LatLonHeightTraits

TraitTypeDefaultDescription
latitudenumberLatitude in degrees
longitudenumberLongitude in degrees
heightnumberHeight above ellipsoid in metres

LegendTraits

TraitTypeDefaultDescription
titlestringA title to be displayed above the legend.
urlstringThe URL of the legend image. If the URL suffix isn’t one of the following png|jpg|jpeg|gif|svg, then urlMimeType must be defined – otherwise a hyperlink will be shown.
imageScalingnumber1Scaling of the legend. For example, a high DPI legend may have scaling = 0.5, so it will be scaled down 50%
urlMimeTypestringThe MIME type of the URL legend image. For example "image/png"
itemsLegendItemTraits[]
backgroundColorstringApply background color to entire legend. This can be useful if legend is transparent and clashes with Terria colours. This will override legendBackgroundColor.

LegendItemTraits

TraitTypeDefaultDescription
titlestringThe title to display next to this legend item.
multipleTitlesstringMultiple titles to display next to this legend item.
maxMultipleTitlesShowedstring10Maximum number of multiple titles to display next to this legend item. (Default is 10)
titleAbovestringThe title to display above this legend item, i.e. marking the top of a box on the legend.
titleBelowstringThe title to display below this legend item, i.e. marking the bottom of a box on the legend.
colorstringThe CSS color to display for this item. This property is ignored if Legend URL is specified.
outlineColorstringThe CSS color with which to outline this item.
outlineWidthnumberThe width of outline in pixels
multipleColorsstring[]Multiple colors to show with this item in a grid arrangement.
imageUrlstringThe URL of an image to display with this item.
markerstringMaki marker ID to display with this item (eg “circle”).
rotationnumberThe degrees to rotate legend item.
addSpacingAbovebooleanTrue to add a bit of extra spacing above this item in order to separate it visually from the rest of the legend.
imageHeightnumber20The height of the legend image.
imageWidthnumber20The width of the legend image.

RectangleTraits

TraitTypeDefaultDescription
westnumberThe westernmost longitude in degrees.
southnumberThe southernmost longitude in degrees.
eastnumberThe easternmost longitude in degrees.
northnumberThe northernmost longitude in degrees.
CameraTraits
positionVectorTraitsPosition of the camera in the Earth-centered Fixed frame in meters.
directionVectorTraitsThe look direction of the camera in the Earth-centered Fixed frame.
upVectorTraitsThe up vector direction of the camera in the Earth-centered Fixed frame.

VectorTraits

TraitTypeDefaultDescription
xnumberX component of vector in the Earth-centered Fixed frame.
ynumberY component of vector in the Earth-centered Fixed frame.
znumberZ component of vector in the Earth-centered Fixed frame.

IdealZoomTraits

TraitTypeDefaultDescription
lookAtLookAtTraitsParameters for camera to look at a target.
cameraCameraTraitsUse camera position, direction and up if fully defined. Otherwise use rectangle if fully defined.

LookAtTraits

TraitTypeDefaultDescription
targetLongitudenumberTarget longitude on the WGS84 ellipsoid in degrees
targetLatitudenumberTarget latitude on the WGS84 ellipsoid in degrees
targetHeightnumber100Target height in meters. Treat it as camera height. A positive value is above the WGS84 ellipsoid. Default to 100 meters.
headingnumberHeading in degrees. Treat it as camera bearing. North is 0. A positive value rotates clockwise, negative anti-clockwise. Default to 0.
pitchnumber45Pitch in degrees. Treat it as camera pitch. A positive value is to look down, negative up. Default to 45.
rangenumber500The range in meters. It is the distance between the target position and camera position projected onto the local plane. Not negative and default to 500.

CameraTraits

TraitTypeDefaultDescription
positionVectorTraitsPosition of the camera in the Earth-centered Fixed frame in meters.
directionVectorTraitsThe look direction of the camera in the Earth-centered Fixed frame.
upVectorTraitsThe up vector direction of the camera in the Earth-centered Fixed frame.
RectangleTraits
westnumberThe westernmost longitude in degrees.
southnumberThe southernmost longitude in degrees.
eastnumberThe easternmost longitude in degrees.
northnumberThe northernmost longitude in degrees.

InitialMessageTraits

TraitTypeDefaultDescription
titlestringThe title of the message.
contentstringThe content of the message.
keystringIdentifier. If multiple messages with the same key are triggered, only the first will be displayed.
confirmationbooleanWhether the message requires confirmation.
confirmTextstringIf confirmation is true, the text to put on the confirmation button.
widthnumberWidth of the message.
heightnumberHeight of the message.

FeatureInfoTemplateTraits

TraitTypeDefaultDescription
namestringA mustache template string for formatting name
templatestring{{terria.timeSeries.chart}}A Mustache template string for formatting description
showFeatureInfoDownloadWithTemplatebooleantrueShow feature info download if a template has been provided. If no template is provided, then download will always show.
partialsanyAn object, mapping partial names to a template string. Defines the partials used in Template.
formatsanyAn object, mapping field names to formatting options.

TableColumnTraits

TraitTypeDefaultDescription
namestringThe name of the column.
titlestringThe displayed title of the column.
unitsstringThe units for the column values.
transformationColumnTransformationTraitsTransformation to apply to this column
typestringThe type of the column. If not specified, the type is guessed from the column’s name and values. Valid types are:

  • 0
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • longitude
  • latitude
  • height
  • time
  • scalar
  • enum
  • region
  • text
  • address
  • hidden
regionTypestringThe type of region referenced by the values in this column. If Type is not defined and this value can be resolved, the column Type will be region.
regionDisambiguationColumnstringThe name of the column to use to disambiguate region matches in this column.
replaceWithZeroValuesstring[]Values of the column to replace with 0.0, such as -.
replaceWithNullValuesstring[]Values of the column to replace with null, such as NA.
formatanyThe formatting options to pass to toLocaleString when formatting the values of this column for the legend and feature information panels. See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/toLocaleString and https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat

ColumnTransformationTraits

TraitTypeDefaultDescription
expressionstringTransformation expression used to change column values (row-by-row). This uses http://bugwheels94.github.io/math-expression-evaluator . For example x*3 will multiply all column values by 3, x*columnA will multiple this column with columnA (note – columnA must be in dependencies array).
dependenciesstring[]Array of column names which are ‘injected’ in to the expression. For example, to use the expression x*columnA (where columnA is the name of another column), dependencies must include 'columnA'

TableStyleTraits

TraitTypeDefaultDescription
idstringThe ID of the style.
titlestringThe human-readable title of the style. Set this to null to remove the style entirely.
regionColumnstringThe column to use for region mapping.
latitudeColumnstringThe column to use for the latitude of points. If Region Column is specified, this property is ignored.
longitudeColumnstringThe column to use for the longitude of points. If Region Column is specified, this property is ignored.
colorTableColorStyleTraitsOptions for controlling the color of points or regions.
pointTablePointStyleTraitsOptions for controlling the symbolization. This excludes color (see TableColorStyleTraits) and pointSize (see TablePointSizeStyleTraits).
outlineTableOutlineStyleTraitsOptions for controlling the symbolization. This excludes color (see TableColorStyleTraits) and pointSize (see TablePointSizeStyleTraits).
trailTableTrailStyleTraitsOptions for controlling the trail or path behind a time-series point.
labelTableLabelStyleTraitsOptions for controlling the labels.
pointSizeTablePointSizeStyleTraitsOptions for controlling the size of points. This property is ignored for regions. This will override TablePointStyleTraits marker width/height if pointSize.column can be resolved to scalar column
chartTableChartStyleTraitsOptions for controlling the chart created from this CSV.
timeTableTimeStyleTraitsOptions for controlling how the visualization changes with time.
hiddenbooleanHide style from “Display Variable” drop-down in workbench. It is hidden by default if number of colors (enumColors or numberOfBins) is less than 2 – as a ColorMap with a single color isn’t super useful

TableColorStyleTraits

TraitTypeDefaultDescription
mapTypestringThe type of style map. Valid values are “continuous”, “enum”, “bin”, “constant”
colorColumnstringThe column to use to color points or regions.
nullColorstringThe color to use when the value is null, specified as a CSS color string.
outlierColorstringThe color to use when the value is lies outside minimumValue and maximumValue (and therefore not shown on color scale), specified as a CSS color string. This only applies to ContinuousColorMap
regionColorstring#02528dThe color to use when the styling the region, specified as a CSS color string.
nullLabelstringThe label to use in the legend for null values.
outlierLabelstringThe label to use in the legend for outlier values.
minimumValuenumberThe minimum value to use when creating ColorMaps. This is only applied for scalar columns.
maximumValuenumberThe maximum value to use when creating ColorMaps. This is only applied for scalar columns.
numberOfBinsnumberThe number of different colors to bin the data into. This property is ignored if Bin Maximums is specified for a scalar column or Enum Colors is specified for an enum column.
binMaximumsnumber[]The maximum values of the bins to bin the data into, specified as an array of numbers. The first bin extends from the dataset’s minimum value to the first value in this array. The second bin extends from the first value in this array to the second value in this array. And so on. If the maximum value of the dataset is greater than the last value in this array, an additional bin is added automatically. This property is ignored if the Color Column is not a scalar.
binColorsstring[]The colors to use for the bins, each specified as a CSS color string. If there are more colors than bins, the extra colors are ignored. If there are more bins than colors, the colors are repeated as necessary.
enumColorsEnumColorTraits[]The colors to use for enumerated values. This property is ignored if the Color Column type is not enum.
colorPalettestringThe name of a ColorBrewer palette to use when mapping values to colors. This property is ignored if Bin Colors is defined and has enough colors for all bins, or if Enum Colors is defined. The default value depends on the type of the Color Column and on the data. Scalar columns that cross zero will use the diverging purple-to-orange palette PuOr. Scala columns that do not cross zero will use the sequential Red palette Reds. All other scenarios will use the 21 color HighContrast palette. D3 color schemes are also supported (https://github.com/d3/d3-scale-chromatic) – but without scheme or interpolate string (for example – to use interpolateViridis – set colorPalette = Viridis). This is case sensitive.
legendTicksnumber7The number of tick marks (in addition to the top and bottom) to show on the legend for Continuous color scales
legendLegendTraitsThe legend to show with this style. If not specified, a suitable is created automatically from the other parameters.
zScoreFilternumberTreat values outside of specified z-score as outliers, and therefore do not include in color scale. This value is magnitude of z-score – it will apply to positive and negative z-scores. For example a value of 2 will treat all values that are 2 or more standard deviations from the mean as outliers. This must be defined for it to be enabled. This will be ignored if minimumValue or maximumValue have been set
zScoreFilterEnabledbooleanTrue, if z-score filter is enabled.
rangeFilternumber0.3This is applied after the zScoreFilter. It is used to effectively ‘disable’ the zScoreFilter if it doesn’t cut at least the specified percentage of the range of values (for both minimum and maximum value). For example if rangeFilter = 0.2, then the zScoreFilter will only be effective if it cuts at least 20% of the range of values from the minimum and maximum value

EnumColorTraits

TraitTypeDefaultDescription
valuestringThe enumerated value to map to a color.
colorstringThe CSS color to use for the enumerated value.

TablePointStyleTraits

TraitTypeDefaultDescription
enumEnumPointSymbolTraits[]The point style to use for enumerated values.
binBinPointSymbolTraits[]The point style to use for bin values.
nullPointSymbolTraitsThe default point style.
TableStyleMapTraits
enabledbooleantrueTrue to enable.
mapTypestringThe type of style map. Valid values are “continuous”, “enum”, “bin”, “constant”
columnstringThe column to use for styling.

EnumPointSymbolTraits

TraitTypeDefaultDescription
EnumStyleTraits
valuestringThe enumerated value to map to a style.
PointSymbolTraits
markerstringpointMarker used to symbolize points. Default is “point”/”circle”. This can be data URI or one of the supported Maki icons (eg “hospital”)
rotationnumberRotation of marker in degrees (clockwise).
pixelOffsetnumber[]Pixel offset in screen space from the origin. [x, y] format
heightnumber16Height of the marker (in pixels).
widthnumber16Width of the marker (in pixels).
TableStyleMapSymbolTraits
legendTitlestringThe enumerated value to map to a color.

BinPointSymbolTraits

TraitTypeDefaultDescription
BinStyleTraits
maxValuenumberThe maximum value of the bin for a given style.
PointSymbolTraits
markerstringpointMarker used to symbolize points. Default is “point”/”circle”. This can be data URI or one of the supported Maki icons (eg “hospital”)
rotationnumberRotation of marker in degrees (clockwise).
pixelOffsetnumber[]Pixel offset in screen space from the origin. [x, y] format
heightnumber16Height of the marker (in pixels).
widthnumber16Width of the marker (in pixels).
TableStyleMapSymbolTraits
legendTitlestringThe enumerated value to map to a color.

PointSymbolTraits

TraitTypeDefaultDescription
markerstringpointMarker used to symbolize points. Default is “point”/”circle”. This can be data URI or one of the supported Maki icons (eg “hospital”)
rotationnumberRotation of marker in degrees (clockwise).
pixelOffsetnumber[]Pixel offset in screen space from the origin. [x, y] format
heightnumber16Height of the marker (in pixels).
widthnumber16Width of the marker (in pixels).
TableStyleMapSymbolTraits
legendTitlestringThe enumerated value to map to a color.

TableOutlineStyleTraits

TraitTypeDefaultDescription
enumEnumOutlineSymbolTraits[]The outline style to use for enumerated values.
binBinOutlineSymbolTraits[]The outline style to use for bin values.
nullOutlineSymbolTraitsThe default outline style.
TableStyleMapTraits
enabledbooleantrueTrue to enable.
mapTypestringThe type of style map. Valid values are “continuous”, “enum”, “bin”, “constant”
columnstringThe column to use for styling.

EnumOutlineSymbolTraits

TraitTypeDefaultDescription
EnumStyleTraits
valuestringThe enumerated value to map to a style.
OutlineSymbolTraits
colorstringOutline color.
widthnumber1Outline width (in pixels).
TableStyleMapSymbolTraits
legendTitlestringThe enumerated value to map to a color.

BinOutlineSymbolTraits

TraitTypeDefaultDescription
BinStyleTraits
maxValuenumberThe maximum value of the bin for a given style.
OutlineSymbolTraits
colorstringOutline color.
widthnumber1Outline width (in pixels).
TableStyleMapSymbolTraits
legendTitlestringThe enumerated value to map to a color.

OutlineSymbolTraits

TraitTypeDefaultDescription
colorstringOutline color.
widthnumber1Outline width (in pixels).
TableStyleMapSymbolTraits
legendTitlestringThe enumerated value to map to a color.

TableTrailStyleTraits

TraitTypeDefaultDescription
enabledbooleanTrue to enable. False by default
materialTypestringsolidColorThe type of material to use. Possible values: solidColor and polylineGlow. Default is solidColor
enumEnumTrailSymbolTraits[]The colors to use for enumerated values. This property is ignored if the Color Column type is not enum.
binBinTrailSymbolTraits[]The colors to use for enumerated values. This property is ignored if the Color Column type is not enum.
nullTrailSymbolTraitsThe colors to use for enumerated values. This property is ignored if the Color Column type is not enum.
TableStyleMapTraits
mapTypestringThe type of style map. Valid values are “continuous”, “enum”, “bin”, “constant”
columnstringThe column to use for styling.

EnumTrailSymbolTraits

TraitTypeDefaultDescription
EnumStyleTraits
valuestringThe enumerated value to map to a style.
PolylineMaterialTraits
polylineGlowPolylineGlowMaterialTraitsPolyline glow material. Must also set materialType = "polylineGlow"
solidColorSolidColorMaterialTraitsSolid color material.
TableStyleMapSymbolTraits
legendTitlestringThe enumerated value to map to a color.
TrailSymbolTraits
leadTimenumberThe number of seconds in front of the object to show.
trailTimenumber10The number of seconds behind the object to show.
widthnumber1The width in pixels.
resolutionnumber60The maximum number of seconds to step when sampling the position.
POLYLINEGLOWMATERIALTRAITS
TraitTypeDefaultDescription
colorstring#ffffffThe color.
glowPowernumber0.25The strength of the glow, as a percentage of the total line width.
taperPowernumber1The strength of the glow tapering effect, as a percentage of the total line length. If 1.0 or higher, no taper effect is used.
SOLIDCOLORMATERIALTRAITS
TraitTypeDefaultDescription
colorstring#ffffffThe color.

BinTrailSymbolTraits

TraitTypeDefaultDescription
BinStyleTraits
maxValuenumberThe maximum value of the bin for a given style.
PolylineMaterialTraits
polylineGlowPolylineGlowMaterialTraitsPolyline glow material. Must also set materialType = "polylineGlow"
solidColorSolidColorMaterialTraitsSolid color material.
TableStyleMapSymbolTraits
legendTitlestringThe enumerated value to map to a color.
TrailSymbolTraits
leadTimenumberThe number of seconds in front of the object to show.
trailTimenumber10The number of seconds behind the object to show.
widthnumber1The width in pixels.
resolutionnumber60The maximum number of seconds to step when sampling the position.

TrailSymbolTraits

TraitTypeDefaultDescription
leadTimenumberThe number of seconds in front of the object to show.
trailTimenumber10The number of seconds behind the object to show.
widthnumber1The width in pixels.
resolutionnumber60The maximum number of seconds to step when sampling the position.
PolylineMaterialTraits
polylineGlowPolylineGlowMaterialTraitsPolyline glow material. Must also set materialType = "polylineGlow"
solidColorSolidColorMaterialTraitsSolid color material.
TableStyleMapSymbolTraits
legendTitlestringThe enumerated value to map to a color.

TableLabelStyleTraits

TraitTypeDefaultDescription
enabledbooleanTrue to enable. False by default
enumEnumLabelSymbolTraits[]The colors to use for enumerated values. This property is ignored if the Color Column type is not enum.
binBinLabelSymbolTraits[]The colors to use for enumerated values. This property is ignored if the Color Column type is not enum.
nullLabelSymbolTraitsThe colors to use for enumerated values. This property is ignored if the Color Column type is not enum.
TableStyleMapTraits
mapTypestringThe type of style map. Valid values are “continuous”, “enum”, “bin”, “constant”
columnstringThe column to use for styling.

EnumLabelSymbolTraits

TraitTypeDefaultDescription
EnumStyleTraits
valuestringThe enumerated value to map to a style.
LabelSymbolTraits
labelColumnstringID of column to use as label
fontstring30px sans-serifFont CSS string. Default is 30px sans-serif.
stylestringFILLLabel style. Possible values are "FILL""OUTLINE" and "FILL_AND_OUTLINE". Default is "FILL".
scalenumber1The scale of the label. The scale is multiplied with the pixel size of the label’s text.
fillColorstring#ffffffThe fill color of the label.
outlineColorstring#000000The outline color of the label.
outlineWidthnumber1The outline width of the label.
pixelOffsetnumber[]0,0The number of pixels up and to the right to place the label.
horizontalOriginstringLEFTThe horizontal location of an origin relative to an object. For example, LEFT will place the label on the right of the point. Possible values are "LEFT""CENTER" and "RIGHT". Default is "RIGHT".
verticalOriginstringCENTERThe vertical location of an origin relative to an object. For example, TOP will place the label above the point. Possible values are "TOP""CENTER""BASELINE" and "BOTTOM". Default is "CENTER".
TableStyleMapSymbolTraits
legendTitlestringThe enumerated value to map to a color.

BinLabelSymbolTraits

TraitTypeDefaultDescription
BinStyleTraits
maxValuenumberThe maximum value of the bin for a given style.
LabelSymbolTraits
labelColumnstringID of column to use as label
fontstring30px sans-serifFont CSS string. Default is 30px sans-serif.
stylestringFILLLabel style. Possible values are "FILL""OUTLINE" and "FILL_AND_OUTLINE". Default is "FILL".
scalenumber1The scale of the label. The scale is multiplied with the pixel size of the label’s text.
fillColorstring#ffffffThe fill color of the label.
outlineColorstring#000000The outline color of the label.
outlineWidthnumber1The outline width of the label.
pixelOffsetnumber[]0,0The number of pixels up and to the right to place the label.
horizontalOriginstringLEFTThe horizontal location of an origin relative to an object. For example, LEFT will place the label on the right of the point. Possible values are "LEFT""CENTER" and "RIGHT". Default is "RIGHT".
verticalOriginstringCENTERThe vertical location of an origin relative to an object. For example, TOP will place the label above the point. Possible values are "TOP""CENTER""BASELINE" and "BOTTOM". Default is "CENTER".
TableStyleMapSymbolTraits
legendTitlestringThe enumerated value to map to a color.

LabelSymbolTraits

TraitTypeDefaultDescription
labelColumnstringID of column to use as label
fontstring30px sans-serifFont CSS string. Default is 30px sans-serif.
stylestringFILLLabel style. Possible values are "FILL""OUTLINE" and "FILL_AND_OUTLINE". Default is "FILL".
scalenumber1The scale of the label. The scale is multiplied with the pixel size of the label’s text.
fillColorstring#ffffffThe fill color of the label.
outlineColorstring#000000The outline color of the label.
outlineWidthnumber1The outline width of the label.
pixelOffsetnumber[]0,0The number of pixels up and to the right to place the label.
horizontalOriginstringLEFTThe horizontal location of an origin relative to an object. For example, LEFT will place the label on the right of the point. Possible values are "LEFT""CENTER" and "RIGHT". Default is "RIGHT".
verticalOriginstringCENTERThe vertical location of an origin relative to an object. For example, TOP will place the label above the point. Possible values are "TOP""CENTER""BASELINE" and "BOTTOM". Default is "CENTER".
TableStyleMapSymbolTraits
legendTitlestringThe enumerated value to map to a color.

TablePointSizeStyleTraits

TraitTypeDefaultDescription
pointSizeColumnstringThe column to use to size points. This column must be of type scalar
nullSizenumber9The point size, in pixels, to use when the column has no value.
sizeFactornumber14The size, in pixels, of the point is: Normalized Value * Size Factor + Size Offset where the Normalized Value is a value in the range 0 to 1 with 0 representing the lowest value in the column and 1 representing the highest.
sizeOffsetnumber10The size, in pixels, of the point is: Normalized Value * Size Factor + Size Offset where the Normalized Value is a value in the range 0 to 1 with 0 representing the lowest value in the column and 1 representing the highest.

TableChartStyleTraits

TraitTypeDefaultDescription
xAxisColumnstringThe column to use as the X-axis.
linesTableChartLineStyleTraits[]Lines on the chart, each of which is formed by plotting a column as the Y-axis.

TableChartLineStyleTraits

TraitTypeDefaultDescription
namestringChart line name (will replace y-column name).
yAxisColumnstringThe column to use as the Y-axis.
yAxisMinimumnumberThe minimum value to show on the Y axis of the chart.
yAxisMaximumnumberThe maximum value to show on the Y axis of the chart.
colorstringThe color of the line. If not specified, a unique color will be assigned automatically.
isSelectedInWorkbenchbooleantrueThe selection state of the line in the workbench.

TableTimeStyleTraits

TraitTypeDefaultDescription
timeColumnstringThe column that indicates the time of a sample or the start time of an interval.
endTimeColumnstringThe column that indicates the end time of an interval.
idColumnsstring[]The columns that identify an entity as it changes over time.
isSampledbooleanTrue if the rows in this CSV correspond to “sampled” data, and so the feature position, color, and size should be interpolated to produce smooth animation of the features over time. If False, then times are treated as the start of discrete periods and feature positions, colors, and sizes are kept constant until the next time. This value is ignored if the CSV does not have both a time column and an ID column.
displayDurationnumberDisplay duration for each row in the table, in minutes.
spreadStartTimebooleanIndicates if start time of feature should be “spread” so that all features are displayed at the earliest time step. This is useful for non-contiguous sensor data. If true, the earliest time step will display the earliest values for all features (eg sensor IDs) – even if the time value is after the earliest time step. This means that at time step 0, all features will be displayed.
spreadFinishTimebooleanIndicates if finish time of feature should be “spread” so that all features are displayed at the latest time step. See also spreadStartTime.