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, 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

...

See the scales coloring visual representation below.

The distribution affects the intensity of the coloring from the beginning to the end of the scale. The rule of thumb when picking the correct distribution is to try them both, and see what works best for each indicator.

...

  • 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 ().

See the visualization examples below.

KeyTypeOptionalityDescriptionConstraints
areasboolean

Status
colourGreen
titleoptional

enables areas visualization

[true, false]
gridboolean
Status
colourGreen
titleoptional

enables grid visualization

[true, false]
zonesboolean
Status
colourGreen
titleoptional
enables zones visualization[true, false]
heatmapboolean
Status
colourGreen
titleoptional

enables heatmap visualization

[true, false]
dotmapboolean
Status
colourGreen
titleoptional

enables dotmap visualization

[true, false]
lineboolean
Status
colourGreen
titleoptional

enables line visualization

[true, false]
dominanceboolean
Status
colourGreen
titleoptional

enables the dominance visualization in the Compare tool

[true, false]
heatmapScaleFactordecimal
Status
colourGreen
titleoptional
sets the scale factor of a heatmap visualizationx => 0.0

...

See complete indicator example above.

KeyTypeOptionalityDescriptionConstraints
staticarray

Status
colourGreen
titleoptional

array of static scaleOptions objects, one for each dataset

specifies the default settings of a distribution block

x => 0
defaultDistributionobject
Status
colourGreen
titleoptional
specifies the default settings of a distribution block

...

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

...

Indicators are represented as a list of cards in a dashboard.

Turnover value indicator

Image RemovedImage Added

In this area, the turnover value in selected time frame is 688,424 £.

Turnover value indicator after a mouse hover

Image RemovedImage Added

Turnover value indicator with a mouse hover on the fitness

Image RemovedImage Added

This ranks the area as 16th, which gives it a 90 percentile.

Turnover value indicator with a mouse hover on the Visualize button

Image RemovedImage Added

Three indicators in a specific area

Image RemovedImage Added

Here, we see an area - Oscott ward in the Birmingham district, described by three indicators. They tell us that a total of 912 customers live in this area, and the average number of purchases per customer is 1.20. In the selected time frame, these customers generated 104,497 £ turnover.

...