Demographics Data

Facebook publishes detailed population data with demographic information under its initiative FACEBOOK Data for Good. 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. 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 URL: /cell Query Params (required): h3_index OR lat, lng

Get Population within Radius

Request Method: GET URL: /radius/:radius Query Params (required): h3_index OR lat, lng

Get Population within Polygon

Request Method: GET URL: /geojson Request Body (required): GeoJSON format

    {
        "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) 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. Accessed DAY MONTH YEAR.

Last updated