mirror of
https://github.com/librenms/librenms.git
synced 2024-10-07 16:52:45 +00:00
e4c9153d16
* fix a few bare URLs * make mdl happy * make Weathermap.md as mdl happy as possible * make Varnish.md as mdl happy as possible * make Two-Factor-Auth.md mdl happy * touch one header for Syslog.md, but little can be done about the rest * make Sub-Directory.md as mdl happy as possible * make SNMP-Trap-Handler.md lint happy * make SNMP-Proxy.md mdl happy * make Smokeping.md as mdl happy as possible * make Services.md mdl happy * make RRDTune.md mdl happy * cleanup RRDCached.md as much as possible * make RRDCached-Security.md mdl happy * make Rancid.md as mdl happy as possible * make Proxmox.md mdl happy * make Plugin-System.md as mdl happy as possible * make PeeringDB.md mdl happy * make Oxidized.md more lint happy * make Network-Map.md mdl happy * make MIB-based-polling.md as mdl happy as possible * make Metric-Storage.md mdl happy * make IRC-Bot.md as mdl happy as possible * make IRC-Bot-Extensions.md as mdl happy as possible * make * make Graylog.md mdl happy * make Gateone.md mdl happy * make Fast-Ping-Check.md mdl happy * make Distributed-Poller.md as mdl happy as possible * make Dispatcher-Service.md as mdl happy as possible * make Device-Groups.md mdl happy * make Dell-OpenManage.md mdl happy * make Dashboard.md mdl happy * make Customizing-the-Web-UI.md as mdl happy as possible * make Component.md mdl happy * make Billing-Module.md mdl happy * make Auto-Discovery.md mostly mdl happy * make Authentication.md as mdl happy as possible * tidy up a few lines in Applications.md * make Agent-Setup.md as mdl happy as possible * make metrics/OpenTSDB.md mdl happy * spelling fix
108 lines
3.2 KiB
Markdown
108 lines
3.2 KiB
Markdown
source: Extensions/World-Map.md
|
|
path: blob/master/doc/
|
|
|
|
# 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
|
|
1. If there is a location overide for the device in the WebUI and it
|
|
contains `[lat, lng]` (note the square brackets), that is used.
|
|
1. Attempt to resolve lat, lng using `$config['geoloc']['engine']`
|
|
1. 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
|
|
|
|
- *Initial Latitude / Longitude*: The map will be centered on those
|
|
coordinates.
|
|
- *Initial Zoom*: Initial zoom of the map. [More information about
|
|
zoom levels](https://wiki.openstreetmap.org/wiki/Zoom_levels).
|
|
- *Grouping radius*: Markers are grouped by area. This value define
|
|
the maximum size of grouping areas.
|
|
- *Show devices*: Show devices based on there status.
|
|
|
|
Example Settings:
|
|
|
|
|
|
|
|
# Offline OpenStreet Map
|
|
|
|
If you can't access OpenStreet map directly you can run a local [tile
|
|
server](http://wiki.openstreetmap.org/wiki/Tile_servers). To specify a
|
|
different url you can set:
|
|
|
|
```php
|
|
$config['leaflet']['tile_url'] = 'localhost.com';
|
|
```
|
|
|
|
# Additional Leaflet config
|
|
|
|
```php
|
|
$config['map']['engine'] = "leaflet";
|
|
$config['leaflet']['default_lat'] = "51.981074";
|
|
$config['leaflet']['default_lng'] = "5.350342";
|
|
$config['leaflet']['default_zoom'] = 8;
|
|
// Device grouping radius in KM default 80KM
|
|
$config['leaflet']['group_radius'] = 1;
|
|
```
|
|
|
|
# Geocode engine config
|
|
|
|
```php
|
|
$config['geoloc']['engine'] = "google";// Valid options are google, mapquest or bing
|
|
$config['geoloc']['api_key'] = "abcdefghijklmnopqrstuvwxyz";
|
|
```
|
|
|
|
Google:
|
|
Pros: fast, accurate
|
|
Cons: requires a credit card even for a free account
|
|
|
|
MapQuest:
|
|
Pros: free, no credit card required
|
|
Cons: inaccurate: most addresses are returned as locations at the center of the US
|
|
|
|
Bing:
|
|
Pros: free, no credit card required, accurate
|
|
Cons: Microsoft(debatable)
|
|
|
|
# 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:
|
|
|
|
```php
|
|
$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/```.
|