ehealthafrica / locations Goto Github PK

View Code? Open in Web Editor NEW

2.0 58.0 11.0 7.8 MB

JSON files listing locations in Sierra Leone, Liberia, Guinea and Mali

License: Other

JavaScript 99.53% Makefile 0.47%

locations's Introduction

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 contains the history of the different tasks to add locations. Some of this tasks use the code in the ./lib folder.

locations's People

Contributors

Stargazers

Watchers

Forkers

danse carolinagc tillre patriciagarcia emig tthew briocheberlin saltonmassally click2tman 5212baba rochekollie

locations's Issues

SL chiefdoms > sections . Seimaya appears in 2 chiefdoms

possible duplicate in source:
Seimaya appears of section of 2 chiefdoms:

https://github.com/eHealthAfrica/locations/blob/master/history/sierra_leone/add_sections_localities_admin_divisions/sources/kailahun_village.csv#L401-L424

https://github.com/eHealthAfrica/locations/blob/master/history/sierra_leone/add_sections_localities_admin_divisions/sources/kailahun_village.csv#L482-L483

in OCHA it only appears as section of 1 chiefdom:

https://github.com/eHealthAfrica/locations/blob/master/history/sierra_leone/add_coordinates_to_admin_level_4_and_ochaid/sources/SLadminLv4.json#L8410-L8425

missing entry in SL : freetown green fields / lumley

the commit that reorganized the westarn area sections (2d051bb) missed https://github.com/eHealthAfrica/locations/blob/master/history/sierra_leone/update_west_area_section_communities/sources/westernurban.csv#L66

Generic data model

[{
  level: 0,
  name: 'county',
  plural: 'counties',
  items: [{
    name: 'monserrado',
    id: 32
  }]
},{
  level: 1,
  name: 'district',
  items: [{
    id: 2,
    name: 'whatever',
    parentId: 34,
  }]
}]

Replace Chiefdoms for Sierra Leone / Western

Apparently the Western Area has come up with a new structure for the chiefdoms (admin level 3 in SL):

Western Urban Chiefdoms:
Aberdeen
Albert Academy
Allen Town I
Allen Town II
Ascension Town
Bombay
Bottom Oku
Brookfields
Brookfields-Congo
Brookfields-Red Pu
Cline Town
Cockerill-Aberdeen
Cockle-Bay / Colleg
Coconut Farm / Asho
Congo Town
Congo Water I
Congo Water II
Foulah Town
Fourah Bay
George Brook
Ginger Hall
Grass Field
Hill Station
Industrial Estate (Wellington)
Jalloh Terrace
Juba / Kaningo
Kingtom
Kissy Brook
Kissy Bye Pass I
Kissy Bye Pass II
Kissy Mental
Kissy Mess Mess
Kossoh Town
Kroo Town
Kuntolor
Lowcost Housing
Lumley
Magazine
Malama / Kamayama
Mamba Ridge I
Mamba Ridge II
Mayenkineh
Mount Aureol
Mountain Regent
Murray Town
New England - Hannes
New England - Hill C
Old Warf
Pamuronko
Pipelin / Wilkinson
Portee
Quarry
Robis
Rokupa
Sanders Brook
Shell
Sorie Town
Susan's Bay
Tasso Island
Tengbeh Town
Thunderhill
Tower Hill
Wilberforce

Western Rural Chiefdoms:
Koya - Fabaina Area
Koya - Madonkeh
Koya - Magbafti
Koya - Malambay
Koya - Newton
Koya - Songo
Mountain - Bathurst
Mountain - Charlotte
Mountain - Gloucester
Mountain - Leicester
Mountain - Regent
Other
Waterloo - Benguema Village A
Waterloo - Campbell Town VIII
Waterloo - Hastings Village A
Waterloo - Waterloo Village A
York - Gbendembu
York - Goderich - Adonkia/M
York - Goderich - Funkia
York - Hamilton
York - Kent
York - Sattia / Tombo
York - York
Other

location files should contain the new locations for Western Urban and Western Rural
new locations should contain IDs that do not overlap with previous entries to prevent data mess