librenms-librenms/doc/Extensions/World-Map.md

source: Extensions/World-Map.md

World Map Configuration

LibreNMS comes with a configurable Geo Map based on World Map Widget to visualize where your equipment is located geographically.

World Map Widget

World Map Widget, requires you to have properly formatted addresses in sysLocation or sysLocation override. As part of the standard poller these addresses will be Geocoded by Google and stored in the database.

Location resolution happens as follows

1. If device['location'] contains [lat, lng] (note the square brackets), that is used
2. If there is a location overide for the device in the WebUI and it contains [lat, lng] (note the square brackets), that is used.
3. Attempt to resolve lat, lng using $config['geoloc']['engine']
4. Properly formatted addresses in sysLocation or sysLocation override, under device settings.

Example:

[40.424521, -86.912755]

or

1100 Congress Ave, Austin, TX 78701

We have two current mapping engines available:

• Leaflet (default)
• Jquery-Mapael

World Map Widget Settings

Example Settings:

Offline OpenStreet Map

If you can't access OpenStreet map directly you can run a local tile server. To specify a different url you can set:

$config['leaflet']['tile_url'] = 'localhost.com';

Jquery-Mapael config

Further custom options are available to load different maps of the world, set default coordinates of where the map will zoom and the zoom level by default. An example of this is:

$config['map']['engine']                                = "jquery-mapael";
$config['mapael']['default_map'] = 'mapael-maps/united_kingdom/united_kingdom.js';
$config['mapael']['map_width'] = 400;
$config['mapael']['default_lat'] = '50.898482';
$config['mapael']['default_lng'] = '-3.401402';
$config['mapael']['default_zoom'] = 20;

A list of maps can be found in html/js/maps/ or html/js/mapael-maps/.