eHealthAfrica/locations

JSON files listing locations in Sierra Leone, Liberia, Guinea and Mali ## locations JSON files listing locations in - Guinea - Liberia (Health division) - Liberia (Clans division) - Mali - Sierra Leone - Madagascar Data is provided as JSON files in order to be used in all environments ### New releases This repo is just about the JSON files, so there is no build step involved in creating a new release, just update the changelog and the version number in the Bower file. There are some consistency tests and they can be run with the command `npm test`. You might need to run `npm install` before that if it's the first time you are running tests on this repo ### Data Model We don't have an explicit (yet) data model for the json objects stored in the JSON files. Whenever data-models is referenced in the documentaiton of the project, it referes to the informal-conventional data-model we are using for the JSON files in ### Adding countries Adding a country requires adding a `country_name.json` file to the `json` folder (read the `README.md` in there, too). ### Providing Human-Readable Locations There's a node.js CLI tool called `readable.js` in root. Run it with `$ node readable.js [countryName]`, for example `$ node readable.js guinea`. To save the output to a text file, do `$ node readable.js guinea > guinea.txt` ### Providing GeoJson Locations (for locations with coordinates) There's a node.js CLI tool called `toGeoJSON.js` in root. Run it with `$ node toGeoJSON.js [countryName]`, for example `$ node toGeoJSON.js`. To save the output to a text file, do `$ node toGeoJSON.js guinea > geojson.json` It provides an output conforming with the GeoJSON format, ready to be loaded in tools like geojson.io, were the locations can be visualized in the map if they have coordinates ### Fast visualizing geocoordinates the `toURL.js` script will output a url ready to be consumed by geojson.io example: `$ url=$(node toGeoJSON.js [countryName] | node toURL.js) && open -a Firefox $url` ### History of added locations The folder ./history c …