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:

  In the Default Layers section:

  • Basemap - Select the style for the map.

  • Overlays - Toggle traffic and weather overlay layers.

    In the Map View section:

  • Zoom – The initial zoom level of the map.

  • Latitude – The initial latitude of the map view.

  • Longitude – The initial longitude of the map view.

    In the User Interface section:

  • Options - Enable or disable the following map controls:

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

    • Mouse Position - Show the real-time geographic coordinates (latitude and longitude) of the mouse pointer on the map.

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

    • Scale Line - Add a visual scale bar to indicate distances on the map

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

    • Zoom Slider - Provide a vertical slider for fine-grained zoom control.

      The Asset Layers section appears if at least one asset with a valid location has been selected. Configure the following properties:

  • Select Asset Type – Select an asset type to configure the visual properties for all assets of this type.

  • Marker Type – The shape of the marker.

  • Marker Color – The default color for the markers for assets with this type.

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

  • Asset Type Zoom – The zoom level the map will use when an asset context is set.

  • Popup – If enabled, viewers can select a marker to show detail about the asset such as its name, type, and coordinates.

    In the Conditional Color section:

  • Enable Conditional Color - Dynamically change the marker color based on a numeric asset property.

    • Color variable - Select the asset metadata or property to use for color mapping.

    • 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 section:

  • Enable Conditional Size - Dynamically scale the marker size based on a numeric asset property. Define:

    • Size Variable - Select the asset metadata or property to use to determine the marker size.

    • Min Value – The minimum expected value of the selected variable.

    • Min Size – The marker size in pixels when the variable equals the minimum value.

    • Max Value – The maximum expected value of the selected variable.

    • Max Size – The marker size in pixels when the variable equals the maximum value.

      In the Conditional Rotation section:

  • Enable Conditional Rotation - Rotate the marker based on metadata or a property that represents an angle in degrees.

    • Rotation Variable - Select a metadata or property to use for the rotation. The rotation of asset markers is based on the value of this metadata or property for each respective asset. Select a metadata or property that has a value between 0 and 360.