Map

The map content item displays assets on a map based on their latitude and longitude. Map layers that are associated with the assets can be configured to display as well.

Note: For details on the requirements for an asset to show on the map, see Data requirements for visualizations. To update this information, you must have the ability to modify asset metadata properties.

Configure the basic properties

Configure the following properties in the Basic tab for this content item:

• Follow asset context – When this is enabled, the asset selected in the asset context shows on the map, and the map zooms in on it. The appearance of the asset context marker and the info that displays for it can be customized in the Asset Context info advanced settings.

  • If this content is in a dashboard, it uses the dashboard's asset context. For details, see Create a new dashboard.

  • If this content is in an experience, it uses the navigation item's asset reference. For details, see the Add content to a pane section in Add content to panes in your navigation items.

• Assets – Select assets to include in this content item. Up to 100 assets can be selected. You can search for assets by name, by filter, or both.

  • To search by name, enter a value in the Assets field.

  • To apply filters, select to view and select filters. Select to accept your selected filters and return to the previous search panel.

  • To add a single asset, select its name. To add multiple assets, check the box for each, then select Select.

• Follow time context - When this is enabled, the content item uses the the time context for the information it displays. The locations shown on the map reflect the location of the assets at the last available time in the time range. If you specify any conditional variables, the average over the specified time range is used. The source of the time context depends on whether this content item is in a dashboard or experience:

  • If this content is in a dashboard, it uses the dashboard's time context as the time range for the data it displays. For details, see Create a new dashboard.

  • If this content is in an experience, it uses the time selected in the time selector content item as the time range for the data it displays. For details, see Add a time selector.

• Time - If Follow time context is disabled, select the time range. The locations shown on the map reflect the location of the assets at the last available time in the time range. If you specify any conditional variables, the average over the specified time range is used.

Configure the advanced properties

Configure the following properties in the Advanced tab for this content item:

• Title - The title that displays for this content item. This property is only available in grid dashboards; content items do not display titles in canvas dashboards or experiences.

Primary layers section

• Basemap - Select which basemap layers are available. The active basemap shows by default. Layers with SHOW IN LAYERS enabled can be enabled or disabled by the viewer in the Layers control panel.

• Overlays - Select which overlay layers are available. Visible layers are shown by default. Layers with SHOW IN LAYERS enabled can be enabled or disabled by the viewer in the Layers control panel.

Map view section

• Options - Enable or disable the following map controls:

  • Layers button - Display a control panel to toggle visibility of individual overlay/asset layers.

  • My location button - Display a button to center the map on the user's location.

  • Zoom buttons - Display zoom in/out buttons to control the map’s zoom level.

  • Zoom slider - Display a vertical slider to control the map’s zoom level.

  • Cursor coordinates - Display the real-time geographic coordinates (latitude and longitude) of the cursor position on the map.

  • Overview map - Display a small inset map in the bottom left corner to provide geographic context and orientation.

  • Scale - Display a scale bar to indicate distances on the map.

• Default zoom – The initial zoom level of the map.

• Default latitude – The initial latitude the map centers on.

• Default longitude – The initial longitude of the map centers on.

Asset context info section

The Asset Context info section determines how the marker and info card for the asset selected in the asset context appear.

• Key property – Enter up to 5 metadata or asset stream references. The first match is shown on the info card. Only exact matches are shown. This field is case sensitive and does not support wildcard characters.

  If no match for the key property is found, the type, latitude, and longitude are shown.

• Marker style – A marker appears when the asset context's location is a coordinate pair. If the asset's location is dynamic, the marker appears at the most recent coordinates available in the selected time range. Configure the appearance of the marker:

  • Marker type – The shape of the marker.

  • Marker color – The color and opacity of the marker.

  • Marker size – The size of the marker in points.

  • Zoom on asset selection – The zoom level the to use when an asset with this asset type is set as the asset context.

• Polygon style – A polygon appears when the asset context's location is an area. Configure the appearance of the polygon:

  • Fill color – The color and opacity of the polygon.

  • Fill pattern – The pattern of the fill color for the polygon.

  • Outline color – The color and opacity of the polygon's outline.

  • Outline pattern – The pattern of the polygon's outline.

  • Outline width – The thickness of the outline.

• Line style – A line appears when the asset context's location is a line. Configure the appearance of the line:

  • Line color – The color and opacity of the line.

  • Line pattern – The pattern of the line.

  • Line width – The thickness of the line.

• Location history – A location history line appears when the asset context's location is a coordinate pair that changes over time. Configure the appearance of the location history line:

  • Show location history – Display the location history line.

  • Line color – The color and opacity of the line.

  • Line pattern – The pattern of the line.

  • Line width – The thickness of the line.

    Note: The location history line uses up to 10,000 coordinate pairs. If there are more than 10,000 coordinate pairs in the selected time range, the most recent 10,000 coordinate pairs are used.

Asset type layers section

The Asset type layers section appears if at least one asset with a valid location has been selected. Select the Edit button to configure the layer properties:

• In the Layer settings tab:

  • Layer name – The name of the layer.

  • Zoom on asset selection – The zoom level to use when an asset with this asset type is set as the asset context.

  • Marker type – The shape of the marker.

    Note: If the asset's location is dynamic, the marker appears at the most recent coordinates available in the selected time range.

  • Marker color – The default color and opacity of the marker.

  • Marker size – The default size of the marker in points.

  • Info card – Show an information card when the marker for an asset of this type is selected. The information card includes details such as the asset's name, type, and coordinates.

• In the Info cards tab, configure the info card that appears when a marker for an asset in this layer is selected:

  • Show properties table card – Show a card that includes the name, type, and coordinates of the asset. If a Property or metadata is selected, that shows in the table as well.

  • Property or metadata – Show a key properties card that includes the name of the asset with the selected property or metadata.

    If a Property or metadata is selected and Show properties table card is enabled, the key properties card is the default (front) side of the card that appears when the asset marker is selected. Select the Show asset details button in the card to show the properties table side of the card.

• In the Label tab:

  • Property or metadata - Select an asset metadata or property to use its value as the label for markers.

  • Visible zoom range – The zoom range at which the label is visible on the map.

  • Font color – The font color and opacity.

  • Font size – The size of the font.

  • Font weight – The weight of the font.

  • Text alignment – The horizontal and vertical alignment of the label relative to the marker.

  • Offset position – Adjust the position of the label relative to the marker.

• In the Location history tab, configure the history lines that appear when the location for assets of this type is coordinate pairs that change over time:

  • Show location history – Display the location history line.

  • Line color – The color and opacity of the line.

  • Line pattern – The pattern of the line.

  • Width – The thickness of the line.

    Note: The location history line uses up to 10,000 coordinate pairs. If there are more than 10,000 coordinate pairs in the selected time range, the most recent 10,000 coordinate pairs are used.

• In the Conditional color tab:

  • Property or metadata - Select a property or metadata to dynamically change the color of markers based on the property or metadata value. The value must be numeric.

  • Select the + button to add a condition.

  • Value - Enter the value to use for this condition.

  • Color - Assign the color to be used at the value. Colors are interpolated between values to create smooth transitions. For example, if you define conditions as 0 = Blue, 50 = Yellow, 100 = Red, then an asset with a value of 25 will appear greenish (between blue and yellow), and one with 75 will appear orange (between yellow and red).

• In the Conditional size tab:

  • Property or metadata - Select a property or metadata to dynamically scale the size of markers based on the property or metadata value. The value must be numeric.

  • Value – The minimum and maximum expected values of the selected property or metadata.

  • Size – The marker size in pixels for the minimum and maximum values.

• In the Conditional direction tab:

  • Property or metadata - Select a property or metadata to dynamically rotate markers based on the property or metadata value. The value must be between 0 and 360.

Map layers section

The Map layers section appears if at least one selected asset has at least one map layer associated with it. Map layers display geographic data including points, lines, polygons, and feature collections.

A Map Layer is an entity created through the API. It includes:

• GeoJSON data: Standard geographic features, which support:

  • Point and MultiPoint markers, typically used for features such as asset locations

  • LineString and MultiLineString lines, typically used for features such as pipelines and routes

  • Polygon and MultiPolygon areas, typically used for features such as sites or regions

    Each feature combines a geometry (location or shape) with properties (custom key-value metadata).

• Related assets: A list of assets linked to the map layer by a relationship. The map layer appears on the map automatically when its related assets are added.

For details on creating map layers through the API, see Content Management.

Select the Edit button to configure the map layer properties. The properties available depend on the type of map layer.

For a Point map layer:

• In the Layer settings tab:

  • Layer display name – The name of the layer.

  • Zoom on asset selection – The zoom level to use when an asset associated with this map layer is set as the asset context.

  • Visible zoom range – The zoom range at which the layer is visible on the map.

  • Marker type – The shape of the markers.

    Note: If the marker locations are dynamic, the markers appear at the most recent coordinates available in the selected time range.

  • Marker color – The default color and opacity of the markers.

  • Marker size – The default size of the markers in points.

  • Show all features – Display the complete GeoJSON Feature Collection for this map layers. This includes both features associated with assets and standalone features that have no asset association.

• In the Info cards tab, configure the info cards that appear when a marker in this layer is selected:

  • Show properties table card – Show a properties table card with information about the property or metadata selected in the Property or metadata dropdown.

  • Property or metadata – The property or metadata to show in the key property and properties table cards.

• In the Label tab:

  • Property or metadata - Select an asset metadata or property to use its value as the label for markers.

  • Visible zoom range – The zoom range at which the label is visible on the map.

  • Font color – The font color and opacity.

  • Font size – The size of the font.

  • Font weight – The weight of the font.

  • Text alignment – The horizontal and vertical alignment of the label relative to the marker.

  • Offset position – Adjust the position of the label relative to the marker.

• In the Conditional fill color tab:

  • Property or metadata - Select a property or metadata to use its value to dynamically change the color of markers. The value must be numeric.

  • Select the + button to add a condition.

  • Value - Enter the value to use for this condition.

  • Color - Assign the color to be used at the value. Colors are interpolated between values to create smooth transitions. For example, if you define conditions as 0 = Blue, 50 = Yellow, 100 = Red, then an asset with a value of 25 will appear greenish (between blue and yellow), and one with 75 will appear orange (between yellow and red).

• In the Conditional size tab:

  • Property or metadata - Select a property or metadata to use its value to dynamically scale the size of markers. The value must be numeric.

  • Value – The minimum and maximum expected values of the selected property or metadata.

  • Size – The marker size in pixels for the minimum and maximum values.

• In the Conditional direction tab:

  • Property or metadata - Select a property or metadata to dynamically rotate markers based on the property or metadata value. The value must be between 0 and 360.

For a Line map layer:

• In the Layer settings tab:

  • Layer display name – The name of the layer.

  • Zoom on asset selection – The zoom level to use when an asset associated with this map layer is set as the asset context.

  • Visible zoom range – The zoom range at which the layer is visible on the map.

  • Line color – The default color and opacity of the lines.

  • Line pattern – The default pattern of the lines.

  • Line width – The default thickness of the lines.

  • Show all features – Display the complete GeoJSON Feature Collection for this map layers. This includes both features associated with assets and standalone features that have no asset association.

• In the Info cards tab, configure the info cards that appear when a line in this layer is selected:

  • Show properties table card – Show a properties table card with information about the property or metadata selected in the Property or metadata dropdown.

  • Property or metadata – The property or metadata to show in the key property and properties table cards.

• In the Label tab:

  • Property or metadata - Select an asset metadata or property to use its value as the label for lines in this layer.

  • Visible zoom range – The zoom range at which the label is visible on the map.

  • Font color – The font color and opacity.

  • Font size – The size of the font.

  • Font weight – The weight of the font.

  • Text alignment – The horizontal and vertical alignment of the label relative to the marker.

  • Offset position – Adjust the position of the label relative to the marker.

• In the Conditional line color tab:

  • Property or metadata – Select a property or metadata to use its value to dynamically change the line color. The value must be numeric.

  • Select the + button to add a condition.

  • Value – Enter the value to use for this condition.

  • Color – Assign the color to be used at the value. Colors are interpolated between values to create smooth transitions. For example, if you define conditions as 0 = Blue, 50 = Yellow, 100 = Red, then an asset with a value of 25 will appear greenish (between blue and yellow), and one with 75 will appear orange (between yellow and red).

• In the Conditional line pattern tab:

  • Property or metadata – Select a property or metadata to use its value to dynamically change the line pattern. The value must be numeric.

  • Select the + button to add a condition.

  • Value – Enter the value to use for this condition.

  • Line pattern – Assign the pattern to be used at the value. The pattern is used for this value and any values greater than it until the next condition is met.

• In the Conditional size tab:

  • Property or metadata - Select a property or metadata to use its value to dynamically scale the size of lines in this layer. The value must be numeric.

  • Value – The minimum and maximum expected values of the selected property or metadata.

  • Size – The line size for the minimum and maximum values.

For a Polygon map layer:

• In the Layer settings tab:

  • Layer display name – The name of the layer.

  • Zoom on asset selection – The zoom level to use when an asset associated with this map layer is set as the asset context.

  • Visible zoom range – The zoom range at which the layer is visible on the map.

  • Fill color – The default color and opacity of the polygons.

  • Fill pattern – The default pattern of the fill color for the polygons.

  • Outline color – The default color and opacity of the polygons' outline.

  • Outline pattern – The default pattern of the polygons' outline.

  • Outline width – The default thickness of the polygons' outline.

  • Show all features – Display the complete GeoJSON Feature Collection for this map layers. This includes both features associated with your assets and standalone features that have no asset association.

• In the Info cards tab, configure the info cards that appear when a polygon for this layer is selected:

  • Show properties table card – Show a properties table card with information about the property or metadata selected in the Property or metadata dropdown.

  • Property or metadata – The property or metadata to show in the key property and properties table cards.

• In the Label tab:

  • Property or metadata - Select an asset metadata or property to use its value as the label for polygons in this layer.

  • Visible zoom range – The zoom range at which the label is visible on the map.

  • Font color – The font color and opacity.

  • Font size – The size of the font.

  • Font weight – The weight of the font.

  • Text alignment – The horizontal and vertical alignment of the label relative to the polygon.

  • Offset position – Adjust the position of the label relative to the polygon.

• In the Conditional fill color tab:

  • Property or metadata - Select a property or metadata to use its value to dynamically change the fill color of polygons in this layer. The value must be numeric.

  • Select the + button to add a condition.

  • Value - Enter the value to use for this condition.

  • Color - Assign the color to be used at the value. Colors are interpolated between values to create smooth transitions. For example, if you define conditions as 0 = Blue, 50 = Yellow, 100 = Red, then a polygon with a value of 25 will appear greenish (between blue and yellow), and one with 75 will appear orange (between yellow and red).

• In the Conditional line color tab:

  • Property or metadata – Select a property or metadata to use its value to dynamically change the outline color of the polygons in this layer. The value must be numeric.

  • Select the + button to add a condition.

  • Value – Enter the value to use for this condition.

  • Color – Assign the color to be used at the value. Colors are interpolated between values to create smooth transitions. For example, if you define conditions as 0 = Blue, 50 = Yellow, 100 = Red, then an asset with a value of 25 will appear greenish (between blue and yellow), and one with 75 will appear orange (between yellow and red).

• In the Conditional line pattern tab:

  • Property or metadata – Select a property or metadata to use its value to dynamically change the the outline pattern of the polygons in this layer. The value must be numeric.

  • Select the + button to add a condition.

  • Value – Enter the value to use for this condition.

  • Line pattern – Assign the pattern to be used at the value. The pattern is used for this value and any values greater than it until the next condition is met.

• In the Conditional size tab:

  • Property or metadata - Select a property or metadata to use its value to dynamically scale the outline size of polygons in this layer. The value must be numeric.

  • Value – The minimum and maximum expected values of the selected property or metadata.

  • Size – The outline size for the minimum and maximum values.