World Map

The world map widget displays geographical data on a world map. Different map projections are supported, such as the standard mercator or orthographic projection.

Input Format

Field Type Description
weight number A weight value in range [0;1]. This is used to scale opacity and color values.
latitude number The latitude coordinate in range [-90;90] degrees. Values outside the range will wrap.
longitude number The longitude coordinate in range [0;360] degrees. Values outside the range will wrap.
geohash string OPTIONAL. A base32 geohash string to calculate latitude and longitude.

If both geohash and latitude and longitude are specified, geohash is ignored.

Usage

The world map widget can be used with any input that satisfies the format above, but you will usually want to bucket locations using geohashing. Humio provides a function worldMap that helps you conform to the format.

Example 1: IP addresses

worldMap(ip=ip)

Example 2: Existing geo-coordinates

worldMap(lat=myLatitudeField, lon=myLongitudeField, magnitude=avg(responseTime))

Example 3: Alternative

You do not have to use the worldMap function in order to use the widget. You can also just provide data that conforms to the input format. The results in Example 2 can be reproduced using the following query:

geohash(lat=myLatitudeField, lon=myLongitudeField)
| groupBy(_geohash, function=avg(responseTime, as=magnitude))

Here we use the geoHash function to achieve the same bucketing of points as the worldMap function does for us. If we do not use geohashing, we risk getting way too many points, making the widget very slow.