Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

An indicator represents a phenomenon that can be displayed on a map. It allows the user to configure how the phenomenon will be displayed. Indicator has a reference to a metric, which is a mathematical expression of the phenomenon. Indicators are further analysed in indicator drills, with whom they are paired with and displayed in a dashboard.

...

KeyTypeOptionalityDescriptionConstraints
metricstring
Status
colourRed
titlerequired
URL link to the metric object/rest/projects/$projectId/md/metrics?name={metricName}
scalestring
Status
colourGreen
titleoptional

sets the scale coloring, see the examples below

default = standard

[standard, positive, negative, inverse, binaryStandard, binaryNegative, divergingStandard, divergingNegative, divergingWithZeroStandard, divergingWithZeroNegative, heat, heatmap, traffic, trafficInverse, magma, viridis]

distributionstring
Status
colourGreen
titleoptional

defines the distribution of the indicator values

default = geometric

[geometric, uniform]
visualizationsobject
Status
colourGreen
titleoptional
object specifying available visualizations of the indicator
formatobject
Status
colourGreen
titleoptional
object specifying formatting of the indicator value
relationsobject
Status
colourGreen
titleoptional
object specifying the relations of the indicator's metric
scaleOptionsobject
Status
colourGreen
titleoptional
object specifying the scale options

...

  • standard scale has 5 segments and is generally used for any indicator, e.g. average purchase value
  • positive scale has 5 segments and is generally used for positive indicators, e.g. increase of customers
  • negative scale has 5 segments and is generally used for negative indicators, e.g. decrease of customers
  • inverse scale has 5 segments and is the same as standard, but the colors are flipped, it can be used to identify e.g. white spots on a map
  • binaryStandard scale has 2 segments and is used the same way as standard, but just for binary values, e.g. to indicate if there is a shop in the area, or not
  • binaryNegative scale has 2 segments and is used the same way as negative, but just for binary values, e.g. to indicate if the area had a decrease of customers, or not
  • divergingStandard scale has 6 segments and is used for indicators that can positive and negative values, e.g. turnover value difference
  • divergingNegative is used the same way as divergingStandard scale, but the colors are flipped, it can be used to indicate e.g. competition turnover value difference
  • divergingWithZeroStandarddivergingWithZeroNegative scales have 5 segments, with a neutral middle segment
  • heat, heatmap, traffic, trafficInverse, magma, viridis scales have 5 segments

...

  • areas (based on geometryPolygon subtype dataset)
  • grid (based on geometryPolygon subtype dataset)
  • zones (based on geometryPolygon subtype dataset)
  • heatmap (based on geometryPoint subtype dataset)
  • dotmap (based on geometryPoint subtype dataset)
  • line (based on geometryLine subtype dataset)
areasgridzonesheatmapdotmapline

This object also allows to enable the Dominance visualization in the Compare tool ().

...

KeyTypeOptionalityDescriptionConstraints
globalarray

Status
colourGreen
titleoptional

array of distribution break values (integer or decimal)

these breaks will be applied when no object is selected

size = 4 (standard, positive, negative, inverse, heat, heatmap, traffic, trafficInverse, magma and viridis scalescales)

size = 1 (binaryStandard and binaryNegative scalescales)

size = 5 (divergingStandard and divergingNegative scale, divergingNegative, divergingWithZeroStandard and divergingWithZeroNegative scales)

selectionarray
Status
colourGreen
titleoptional

array of distribution break values (integer or decimal)

these breaks will be applied when an object is selected (area or a marker)

size = 4 (standard, positive, negative and inverse scalescales)

size = 1 (binaryStandard and binaryNegative scalescales)

size = 5 (divergingStandard and divergingNegative scale, divergingNegative, divergingWithZeroStandard and divergingWithZeroNegative scales)

content.scaleOptions.static.maxValues

...

KeyTypeOptionalityDescriptionConstraints
zoominteger

Status
colourRed
titlerequired

zoom level, for which the global/selection value will be used

(info) no need to specify all 16 zoom levels - when one level is specified, the rest is computed as a result of a geometric series

2 .. 18

globaldecimal
Status
colourGreen
titleoptional

global scale value (= no marker selected)

x => 0.0

selectiondecimal
Status
colourGreen
titleoptional
selected scale value (= when a marker is selected)x => 0.0

...

scale / visualizationareasgriddotmaplineheatmap





standard





positive





(error)





negative





(error)





inverse





(error)





binaryStandard





(error)





binaryNegative





(error)





divergingStandard





(error)





divergingNegative





(error)





divergingWithZeroStandard

Image Added

Image AddedImage AddedImage Added





(error)





divergingWithZeroNegative

Image AddedImage AddedImage AddedImage Added





(error)


scale / visualizationareasgriddotmaplinesheatmap





heat





(error)





heatmap





(error)





traffic





(error)





trafficInverse





(error)





magma





(error)





viridis





(error)

...