Map

The map content item displays assets as markers on a map based on their latitude and longitude.

The location of an asset is specified in either its asset metadata or asset stream references. Use asset metadata for static location attributes, or asset stream references for dynamic location attributes.

The asset's location must consist of a latitude property and longitude property. These properties must be named as follows:

• Latitude: latitude, lat, or y

• Longitude: longitude, long, lon, or x

These property names are case sensitive.

If multiple matches are found, the first match is used.

Configure the map

Configure the following properties for this content item:

• In the Basic tab:

  • Follow asset context - When this is enabled, the map starts zoomed in on the coordinates of the asset selected for the asset context.

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

    • 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 visualization or experience:

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

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

• In the Advanced tab:

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

    In the 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.

    In the 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.

    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.

    • Marker type – The shape of the marker.

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

    • Marker size – The default 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.

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

  • In the Marker 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.