From ISP admin

Google Maps set up

Google Maps was implemented into the ISP admin system for its universality, worldwide width, and also its large variety of functions such as localization according to a mail address and GPS coordinates, displaying of several spots on one map, or for instance displaying of altitudinal profile among two spots.

Google Maps integration into our system, however, allows to locate the place of residence of our customers (very often it is a location also of the installed client´s device if there is not another address of installation listed), to locate a router as well as the connected devices. Searching the location of the client runs by means of the address details, for routers at present only according to GPS coordinates.

Utilization within the ISP admin

• Displays locations of routers, devices, connections and clients in a high-quality map background (classical, satelite, hybrid and terrain).
• Visually monitors the network status directly on the map.
• Calculates the range of visibility and distance between two spots including the altitudinal profile.

Configuration

Get the API key → Insert the key into the ISP admin → Set the location

Future development

In the future we are planning on displaying routers, clients, devices, connections, etc., ie. all devices added into the system on one map. You will thus obtain an exquisite overview of extent and of physical topology of your network with altitudinal profile of the terrain between a client device and its connecting point.

• Displays the coverage according to the type of aerials
• Executes new requirements from the ISP

Configuration

Get the API key

After you have made the Google Maps service functional in the ISP admin system, what you ahve to do first is to get the API key on the address of http://code.google.com/apis/maps/signup.html. The key will be generated after confirming the terms and conditions for usage and after filling in the domain or the IP address in which the ISP admin operates.

The key is unique for each domain or IP address (according to what you have submitted); it has a result in the fact that it is more suitable to generate a key for the domain which often remains the same compared to IP addresses which may change in the course of the time. For a correct validation of the key, the ISP admin must be approached from the given domain or IP address.

The condition for getting the API key is to have a Google account opened. Google account can be obtained for free and it is possible to open one directly while getting the API key.

Insert the key into the ISP admin

The obtained Google API key must be submitted in the menu of Settings / System settings / Public into google_maps_api_key variable. If the API key is not submitted in this way into the system settings, the Google Maps function will not work properly.

Set the client´s location

If you then have Google Maps already activated, you can click on the name of the user in the menu of Users / Contacts and you will thus open the client card. When editing the contact information ( or when you add a contact ), the Google map will be displayed together with the location.

After clicking on the button of , the ISP admin will make an attempt to find the location according to the street, town, city, and country (listed in the client card) and the map will show the position of this address. You may display the location of the client by "dragging" the indicator of the client location and thus make the location more precise. If the system does not find the street or town/city location, it will make an attempt to find only the town/city and will display its center)‏.

After you have inserted all the information, also the location of the client will save.

Set the router or connecting device location

When editing a router in the bookmark of Routers, a google map is displayed as well for routers and all devices assigned to this router. Here, the location is not given by an address but only by the GPS coordinates. After clicking on button, the ISP admin will attempt to find the location according to given GPS coordinates. A change by dragging the indicator works in the same way as for displaying the location of the client.

Control

Map icon

If you click on this icon wherever within the system, you will open a new window with the location of a given device like you know it from Google Maps.

Display the location of network devices on the Google Maps basis including the altitudinal profile

View and motion on the map

• demo.ispadmin.cz/googlemaps.php
• At the top left part there is a control panel for moving and Zoom
• At the right top part you can change the map type
• Zoom by a mouse wheel
• Shifting the map by clicking and dragging by a mouse
• Fullscreen view of the map: * END key (and F11)‏
• The center of the map is set on the spot with the highest number of users

Layers

• Layers: clients, routers, devices, connections between the routers, connection of clients to routers
• Only one client, router and device will be displayed; those which have their coordinates set in the Google maps
• Spine connections - according to the settings of a superior device for Nagios
• Connections to clients – according to the settings of the Internet service

Filtering

• Clients, routers and online devices
• Clients, routers and online devices
• Clients in monitoring mode

Measuring of the range of visibility and distance

• After the first double-click on the map, the initial point A will be created
• After another double-click on the map, the terminal point B will be created
• The altitudinal profile between the spots A and C will appear over the map
• The points may be relocated

Newly there is a function of the altitudinal profile display integrated. The system is able to display the altitudinal profile between two points defined on the map. Upon double-clicking on the map, the initial point will be marked and upon another double-clicking, there will appera the terminal point. Then in the upper part of the screen the altitudinal profile of the line between the two points will automatically be displayed. The X ax shows the distance and the Y ax shows the height.

For each router and device, there is the posisbility to enter the GPS coordinates according to which appropriate icons will display on the map.

Clients, routers, devices, spine connections and client connections are displayed on the maps. The spine connections will be displayed according to the dependancy set on the router and device in the section Superordinate devices for Nagios. Here you can define individual router dependecies which will then be shown in the maps. By marking an appropriate checkbox, you can set view of individual layers.

If a device or client is online, the icon will be green. In contrary case it will be red.