Only users with data manager role can manage GEO points, regions and map providers. See BellaDati permissions and roles for details.
BellaDati supports data visualisation on geo maps by using two options:
- GEO Points
- GEO Shapes
Map charts geodata screen
In the Data set menu screen click on the Map charts geodata to manage GEO points, regions and map providers.
Available actions on Map charts geodata screen are:
- Create point-based definition
- Create definition of regions
- Map providers: Use your custom GEO map provider.
- Import GeoJSON: Allow to import predefined geo regions from file using GeoJSON format.
- Import points database: Allow to import predefined geo points from CSV file in structure: point name, longitude, latitude, additional names
- Create default: Will create default set of regions and points (countries, world capital cities, US states). That are delivered by default as part of BellaDati installation.
Uploading GEO Points definition
GEO Points file format
Your CSV file with GEO location points must have exact format on picture below. Please note the delimiter type and no blank spaces are accepted. Each GEO point is defined by its latitude and longitude coordinantes. You have to define associated drill-down values to match drill-down members in the report view. You can associate more drill-down values to single GEO point definition. Upper and lower case are distinguished (eg. New York, new york, NY are different values).
This picture includes GEO POINTS for streets of Chicago city as following - Street Name, longitude, latitude (longitude and latitude exactly in this order)
- In the Map charts geodata screen click on the Import points database and import CSV file in format described in the note section
- Click on the imported points data to edit data or proceed to report to create New Map
Following options are available
- Add definition entry (to add new latitude and longitude definitions into the exiting definition)
- Export option will export existing definition into the NameOfExistingDefinition.csv
- Delete definition will delete existing definition
- Back to overview will return user to overview of all available definitions
On the screen of the particular GEO points definition user can edit following parameters
- Name,
- Latitude
- Longitude
- Associated drill-down values (multiple parameters can be inserted by using , as an delimiter)
Associate with other drill-down members
Name of the GEO point will be associated with drill-down members in your data set used to create new map in report. Using Associated with drill-down members section you can associate latitude and longitude as well with other drill-down member. Example - City of Vienna has got associated latitude and longitude in Geo Points definition. If your data set includes as well state Austria. You can define it in Associated with drill-down members section and same latitude and longitude will be associated with Austria.
Tip how to upload geo data other way
Include the GEO point definition in the regular data import mapping the longitude/latitude to the GEO Point attribute type. But if you need to use Show details for option during creating new maps in report import GEO data trough Map Charts Geo Data section as described below.
GEO Regions
Each GEO region is defined by three or usually more points specified by latitude and longitude coordinantes. Standardized GeoJSON format is supported to simplify importing these definitions. You have to define associated drill-down values to match drill-down members in the report view. You can associate more drill-down values to single GEO region definition. Upper and lower case are distinguished (eg. Canada, canada, CAN are different values).
Following parameters are manageable for GEO regions:
- Definition name
- Region parameters: Name, GeoJSON coordinantes, Associated drill-down values
Map providers
Custom map providers are supported. You can add your own map provider to use in map charts.
- In the Map charts geodata screen click on the Map providers
2. Click on New map provider. In the popup window name your map provider and paste its URL.
Follow the valid URL format example using the OSM standard. You can refer to OpenStreetMap wiki for more information (section "Tile servers"). In case you are using only one server, parameter {s} is not used.
Creating own map tile server
Own map tile server is very resource-demanding and requires powerful server with big storage. In most cases it is better to use default map provider.
We suggest using this tutorial for installing and configuring your map tile server. It is compatible with Ubuntu (tested on version 14.04). More info can be found here:
- https://switch2osm.org/serving-tiles/using-an-all-in-one-solution/
- https://switch2osm.org/serving-tiles/manually-building-a-tile-server-14-04/
- https://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/
Maps can be downloaded from these links:
- http://planet.openstreetmap.org/ - map of the whole planet - 28 GB
- http://download.geofabrik.de/index.html - maps of regions. In case only one country is needed, clicking on region name will open list of countries.
After successful start of server, copy the URL (or IP adress) and paste it in BellaDati in correct format (see Map Providers above)
Next Steps
Overview
Content Tools