# Demographics Data

Facebook publishes detailed population data with demographic information under its initiative [FACEBOOK Data for Good](https://dataforgood.fb.com/tools/population-density-maps/). It is one of the most granular data sets about the worldwide population using official census and Facebook data combined with image recognition.

The raw data is aggregated in 30x30 m squares which we transform to H3 bins at resolution 11.\
&#x20;For each bin there is the statistical population value for:

* Total
* Female
* Male
* Children under 5
* Youth 15 - 24
* Elderly 60 plus
* Women of reproductive age 15 - 49

## Setup

Install node modules

```
npm ci
```

Start mongo with Docker

```
docker-compose up -d
```

Load population data into database

```
npm run start-processing:local
```

Follow the prompts to download, process and write data \[1]

```
[1] Data - Process population data
[2] Map - Generate file for Kepler
[0] CANCEL

What do you want to do? [1, 2, 0]:
```

## Usage

Run the app locally

```
npm run start-api:local
```

### API Calls

#### Get Population in a Cell

Request Method: **GET**\
&#x20;URL: `/cell`\
&#x20;Query Params (**required**): `h3_index` ***OR*** `lat, lng`

#### Get Population within Radius

Request Method: **GET**\
&#x20;URL: `/radius/:radius`\
&#x20;Query Params (**required**): `h3_index` ***OR*** `lat, lng`

#### Get Population within Polygon

Request Method: **GET**\
&#x20;URL: `/geojson`\
&#x20;Request Body (**required**): `GeoJSON format` \\

```javascript
    {
        "geometry": {
            "type": "Polygon",
            "coordinates": […]
        }
    }
```

### License

We are neither providing nor are we responsible for the population data. This repository is purely a tool for working with that data. You are responsible for complying with Facebook's licences when using the data.

Facebook publishes the data under the [Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/) license.

They recommend the following citation:

> Facebook Connectivity Lab and Center for International Earth Science Information Network - CIESIN - Columbia University. 2016. High Resolution Settlement Layer (HRSL). Source imagery for HRSL © 2016 [DigitalGlobe](http://explore.digitalglobe.com/Basemap-Vivid.html). Accessed DAY MONTH YEAR.
