tinok / kobomaps-orig

kobomaps-orig

A simple tool for quickly displaying dozens or hundreds of data indicators by geographic region on a map

---

Requirements

• NodeJs 10.0.0

Note: an Internet connection is required even for testing on a local machine. kobomaps uses the Google Maps and Google Charts APIs.

Quick start - Windows users

1. Install NodeJS
2. Download this repository and unzip it to a directory.
3. Open a command prompt and navigate to the directory where you extracted the repository
4. run npm i
5. run webpack-dev-server
6. Open your browser and open http://localhost:8080
7. Make changes to data\data.csv (using Excel or another spreadsheet editor) - the changes will be reflected on the map.

Details on default map files

Each individual map should be its own subdirectory inside maps. To create a new map use the maps/example directory as a template. Of the four files, the following three may need to be edited for a specific map:

• data.csv: Contains the data of your map. Each line contains a different indicator. The first two columns are used to organize the indicators hierarchically, the third column contains the indicator name. Each region's data is in a separate column. The column header needs to match the exact name used in the boundaries.txt file
• boundaries.txt: Contains the geographic outline of all your regions in JSON format. KoBoMaps can display any region you define. The easiest way to create the outline is through kobomaps-orig\kmlconverter\kmlconverter.php
• config.json: Controls the major details of the map. The following should always be changed: name of the map, HTML page title, default zoom level, default X/Y coordinates for initial view. All other variabels can be changed for a specific map if needed, such as styling or custom JavaScript.