| Table of Contents | ||
|---|---|---|
|
About markers map widgets
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 fields 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 activate the 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 |
|---|---|---|
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:
| |
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. When using the Map view, you can also check the Terrain box to see the topographic details. When using the Satellite view, you can also uncheck the Labels box to hide street grids and names.
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 it represents or hover over to see the field for that value.
Keep clicking until the exact marker is revealed.
Query example
This is the source query used and the fields mapped to generate the widget shown above:
| Code Block |
|---|
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 |