Markers map widgets

[ 1 What data do I need for this widget? ] [ 2 Widget settings ] [ 3 Tips for using a markers map widget ] [ 4 Query example ]

The markers map widget allows you to identify locations on a geographical map. You can customize the markers to display information in the tooltip, add contextual text to bubbles, as well as images for the marker icon.

This type of widget is useful when you want to pinpoint the level of activity in a specific geographical location.

What data do I need for this widget?

The source query must include columns with geolocation coordinates (longitude and latitude), as well as fields to determine the title for the tooltip and the context text of the bubbles.

Widget settings

To edit the widget settings, you must first be in Edit mode.

Click the widget title bar to open its settings. Alternatively, the settings are accessible via the Ellipsis icon → Properties. The widget settings are contained in three tabs: Data, Visual, and Raw.

The settings in the Data and Raw tabs are described in the Create a widget article. These are the Visual settings for the Markers map widget:

Category	Setting	Description

Category	Setting	Description
Map configuration	Zoom	Set the default zoom level. A higher number will set a higher zoom level.
	Type	Choose one of the four map types available: Hybrid - displays a mixture of normal and satellite views. Roadmap - displays the default road map view. This is the default map type. Satellite - displays Google Earth satellite images. Terrain - displays a physical map based on terrain information.
	Draggable	Select this option to enable the possibility of dragging the map to see a different area. Deselect it if you want to keep a specific area and zoom level in your map.
Colors	Background color	Select a color for the map background. This is only visible when you zoom out a certain distance.
Fields	Latitude	Choose the field you want to get the latitude values from.
	Longitude	Choose the field you want to get the longitude values from.
	Title	Select a field to plot a specific data title on the tooltip.
	Content	Select the field you want to use to determine the content text of the bubbles.
General marker	Icon	URI or Base64 image for marker icon.

Tips for using a markers map widget

Here are a few tips to get the most out of your widget:

Use the + and - buttons to adjust the zoom level. Alternatively, you can hold the CTRL key and scroll the mouse wheel.
Select the button in the top-right corner of the marker map to activate the full-screen mode. Click it again to restore the default view.
Apply the Map or Satellite views to the map using the buttons in the top-left corner.
Click the Google logo in the bottom-left corner to see the area displayed in the marker map in Google Maps.
Click on a colored marker to automatically zoom in on the area it covers.
Click on a pin to see the value of the field assigned to the Content property or hover over to see the value assigned to the Title property.

Query example

This is the source query used and the fields mapped to generate the widget shown above:

query(
from siem.logtrust.web.activity
select ip4(srcHost) as srcHostIP
select mmlatitude(srcHostIP) as lat
select mmlongitude(srcHostIP) as lng
where isnotnull(lat) and isnotnull(lng)
group every 30m by lat, lng, method
select count() as count
)

Latitude	lat
Longitude	lng
Title	method
Content	count