mapvisualization properties

 The Map Visualization node can accept multiple input connections and display geospatial data on a map as a series of layers. Each layer is a single geospatial field; for example, the base layer might be a map of a country, then above that you might have one layer for roads, one layer for rivers, and one layer for towns.
Table 1. mapvisualization properties
mapvisualization properties Data type Property description
tag string

Sets the name of the tag for the input. The default tag is a number based on the order that inputs were connected to the node (the first connection tag is 1, the second connection tag is 2, etc.
layer_field field
Selects which geo-field from the data set is displayed as a layer on the map. The default selection is based on the following sort order:
  • First - Point
  • Linestring
  • Polygon
  • Multipoint
  • MultiLinestring
  • Last - MultiPolygon

If there are two fields with the same measurement type, the first field alphabetically (by name) will be selected by default.
color_type boolean

Specifies whether a standard color is applied to all features of the geo-field, or an overlay field which colors the features based on values from another field in the data set. Possible values are standard or overlay. The default is standard.
color string

If standard is selected for color_type, the drop-down contains the same color palette as the chart category color order on the user options Display tab.

Default is chart category color 1.
color_field field

If overlay is selected for color_type, the drop-down contains all fields from the same data set as the geo-field selected as the layer.
symbol_type boolean

Specifies whether a standard symbol is applied to all records of the geo-field, or an overlay symbol which changes the symbol icon for the points based on values from another field in the data set. Possible values are standard or overlay. The default is standard.
symbol string

If standard is selected for symbol_type, the drop-down contains a selection of symbols that can be used to display points on the map.
symbol_field field

If overlay is selected for symbol_type, the drop-down contains all of the nominal, ordinal, or categorical fields from the same data set as the geo-field selected as the layer.
size_type boolean

Specifies whether a standard size is applied to all records of the geo-field, or an overlay size which changes the size of symbol icon or the line thickness based on values from another field in the data set. Possible values are standard or overlay. The default is standard.
size string

If standard is selected for size_type, for point or multipoint, the drop-down contains a selection of sizes for the symbol selected. For linestring or multilinestring, the drop-down contains a selection of line thicknesses.
size_field field

If overlay is selected for size_type, the drop-down contains all of the fields from the same data set as the geo-field selected as the layer.
transp_type boolean

Specifies whether a standard transparency is applied to all records of the geo-field, or an overlay transparency which changes the level of transparency for the symbol, line, or polygon based on values from another field in the data set. Possible values are standard or overlay. The default is standard.
transp integer

If standard is selected for transp_type, the drop-down contains a selection of transparency levels starting at 0% (opaque) and increasing to 100% (transparent) in 10% increments. Sets the transparency of points, lines, or polygons on the map.

If overlay is selected for size_type, the drop-down contains all of the fields from the same data set as the geo-field selected as the layer.

For points, multipoints, linestrings, and multilinestrings, polygons and multipolygons (that are the bottom layer), the default is 0%. For polygons and multipolygons that are not the bottom layer, the default is 50% (to avoid obscuring layers beneath these polygons).
transp_field field

If overlay is selected for transp_type, the drop-down contains all of the fields from the same data set as the geo-field selected as the layer.
data_label_field field

Specifies the field to use as data labels on the map. For example, if the layer this setting is applied to is a polygon layer, then the data label might be the name field – containing the name of each polygon. So selecting the name field here would result in those names being displayed on the map.
use_hex_binning boolean

Enables hex binning and enables all of the aggregation drop-downs. This setting is turned off by default.
color_aggregation and transp_aggregation string

If you select an overlay field for a points layer using hex binning, then all the values for that field must be aggregated for all points within the hexagon. Therefore, you must specify an aggregation function for any overlay fields you want to apply to the map.

The available aggregation functions are:

Continuous (Real or Integer storage):
  • Sum
  • Mean
  • Min
  • Max
  • Median
  • 1st Quartile
  • 3rd Quartile
Continuous (Time, Date, or Timestamp storage):
  • Mean
  • Min
  • Max
Nominal/Categorical:
  • Mode
  • Min
  • Max
Flag:
  • True if any true
  • False if any false
custom_storage string

Sets the overall storage type of the field. Default is List. If List is specified, the following custom_value_storage and list_depth controls are disabled.
custom_value_storage string

Sets the storage types of the elements in the list instead of to the field as a whole. The default is Real.

list_depth integer
Sets the depth of the list field. Ther required depth depends on the type of geofield, following these criteria:
  • Point - 0
  • LineString - 1
  • Polygon - 2
  • Multipoint - 1
  • MultiLineString - 2
  • Multipolygon - 3

You must know the type of geospatial field you are converting back to a list and the required depth for that kind of field. If set incorrectly, the field cannot be used.

The default value is 0, minimum is 0, and maximum is 10.