Page History

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

1. In the Map charts geodata screen click on the Import points database and import CSV file in format described in the note section 
   
   
   
   
2. 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)

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

Anchor
providers providers

Custom map providers are supported. You can add your own map provider to use in map charts. 

1. 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
   
3. Open your report and select your map provider.
   

Using Mapbox as tile server

Mapbox is a mapping platform which can also be used as a map tile server in BellaDati.

1. Create new account here.
2. Open Mapbox studio - https://www.mapbox.com/studio/
3. In left menu click on Classic.
4. Click on Mapbox Editor projects.
5. Create new Mapbox project with desired settings.
6. Save the project.
7. In BellaDati click on New map provider and this URL:
   

   http://api.tiles.mapbox.com/v4/{mapid}/{z}/{x}/features{y}.jsonpng?access_token=<your access token>

   
   

   1. {mapid} - ID of your map, can be found in map info in Mapbox.
      

   2. <your access token> - access token that can be found on Mapbox Account page. You need to create a public token with all three public scopes enabled.

      

Creating own map tile server

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

• Creating Geo Maps