/*******************************************************************************

    Author ......... Arno Streuli
    Contact ........ [email protected]
    Home Site ...... http://cactiusers.org
    Program ........ Map for Cacti
    Purpose ........ Display all device on a Google Map

*******************************************************************************/

----[ Purpose

	This plugin Display all device in a Google map.

----[ Installation

	It use the site table from cacti.
	If your table is empty, it will be 'geocoded' from the device.
	In this case each device need to have the following snmp setting:
	snmp-server location Country;City;Street_Building;Floor;Room;Rack;RU;Lat;Long
	
	Lat; long is used if you don't have the street correct, like an equipment in middle of nowhere. but you still need to have all the filed, at least the ;
	
	On the Cacti Configuration page, under misc, you have a few line:
	choose if you want to use google map or openstreet map.
	if google map is coosen, you have to install the key
	then you have to enter the center location of the map with a field with this format:
	Country;City;Street_Building
	
	To create your site database, you can go under utilities -> System utilities and then 'Rebuild sites table'
	It will parse every device on your DB and look for snmp location information, then go to either googlemap or openstreet map to have all information to create the site table
	
	When you click on the tab MAP, it's can look empty depending of the browser, just click refresh, and you should see the map with the device on it.
	
	if not activate the debug and give me the output or any error message

----[ Possible Bugs?
   

----[ Future Changes

	Got any ideas or complaints, please e-mail me!


----[ Changelog

1.0.2 The snmp location format change to include GPS value in the following format: Country;City;Street_Building;Floor;Room;Rack;RU;Lat;Long
1.0.3 check if the device is snmp enable otherwise do not try to find the location
1.1.0 use cacti site database for location taken from snmp location in format: country;city;address;floor;room;rack;RU or ;;;floor;room;rack;RU;lat;long the 7 and 8 argument are lat/log
1.2.0 added support of openstreetmap
1.2.1 added the usage of extenddb to not display phone on the map
1.2.2 changed the format of the map center under settings, to be the same as location on a device !
1.2.3 Added the option to geocode only selected device under Management -> devices list
1.2.4 Added the type on the notes on the site liste, and some correction with openstreet map geocoding
1.2.5 fully working with OpenStreetmap and leaflet
1.2.6 Fix some problem with escape string on location detection and geocoding with openstreetmap
1.2.7 Used Spider function on GoogleMap, thanks to OverlappingMarkerSpiderfier
1.2.8 Add a flag to let the user disable the geolocation on saved device, it take way to mutch Internet time during discovery
1.2.9 Upgrade to Leafleet 1.7.1
1.2.10 Some correction with extenddb plugin, and the way Leaflet and google API are used
1.3.0 Upgrade to mapbox GL instead of base mapbox JS
1.3.1 add header hook
1.3.2 add filter on view to remove isPhone