Abiquo Documentation Cookies Policy

Our Documentation website uses cookies to improve your experience. Please visit our Cookie Policy page for more information about cookies and how we use them.


Abiquo Documentation

Skip to end of metadata
Go to start of metadata

Using Google Maps in Abiquo

Abiquo uses Google Maps for the map display, which requires the server to have Internet access. The map view is optional and statistics can be shown instead. In new installations, the map view is the default for Infrastructure view. In upgraded installations, to enable the map view, set the appropriate property in the client-config-custom.json file.

To plot the datacenter locations on the map, Abiquo uses the Google Maps Javascript API v3, and you cannot use a key for an older version.

Add the Google maps API key to the client-config-custom.json file as described below.

Obtaining a Google Maps API Key

You should add a browser key for accessing the Google Maps Javascript API v3. To obtain the key, follow the instructions at:

https://cloud.google.com/maps-platform/user-guide/account-changes/

You will need to obtain a browser key that can use the Google Maps Javascript API

To add the API key you copied above to the Abiquo Server do these steps:

  1. Log in to the Abiquo Server as root
  2. Change to the UI directory

    cd /var/www/html/ui/config
  3. Back up the client-config-custom.json file, for example

    cp client-config-custom.json ~/client-config-custom.json.backup
  4. If necessary, edit client-config-custom.json to enable Google Maps   

    "client.google.maps.enabled": true, 
  5. Add the Google Maps key. For example:

    "client.google.maps.key": "asdasdDryNhzxEdtfDnGQBKDAtzFqRhjeTUEh_g"
  6. Reload Abiquo in your browser, which will log you out. 
     
  7. Confirm the installation by using "View Source" on the Abiquo login page. You should see the API key.
  8. When you log in to Abiquo, you should see the arrow marking the location of your datacenter.

Troubleshooting

  • Improve Datacenter Location Details: If your datacenter is not correctly plotted, try adding more details of the location. For example, if your datacenter is located in Barcelona, Venezuela and you enter Barcelona, the map will show the location as Barcelona in Spain. In this case, you would enter "Barcelona, Venezuela" in the Datacenter location for a correct visualization.
  • Google maps charges for map usage, see https://developers.google.com/maps/documentation/javascript/usage#usage_limits