GIS Lookup

Lookup GIS (Guaranteed Income Supplement) amount by income and marital status.

Install

npm install gis-lookup

Usage

const gisLookup = require('gis-lookup');

const income = 17905;
const result = gisLookup.find(gisLookup.STATUS.SINGLE, income);

console.log(result.output.gis);                         // "13.18"
console.log(result.metadata.time_period_coverage_start) // for example: "2019-01-01 00:00:00"
console.log(result.metadata.time_period_coverage_end)   // for example: ""2019-06-30 00:00:00",

Available statuses are as follows:

Status	Description
SINGLE	Single person who receives an OAS pension
PARTNER_OAS	Spouse/common-law partner of someone who receives an OAS pension
PARTNER_NO_OAS	Spouse/common-law partner of someone who does not receive an OAS pension

If something goes wrong, result will contain an error property

const gisLookup = require('gis-lookup');

const result = gisLookup.find('married', 'abc')
console.log(result.error); // [{"en_CA":"Unknown status","fr_CA":"TBD"},{"en_CA":"Invalid income","fr_CA":"TBD"}]

Maintenance

TBD, too manual currently...

# time_period_coverage_start and time_period_coverage_end are values from current/metadata.json, just take yyyy-mm-dd
mkdir data/historica/from-{time_period_coverage_start}-to-{time_period_coverage_end}
mv data/current/* historical/from-{time_period_coverage_start}-to-{time_period_coverage_end}
# download new metadata.json from Open Government Canada site (see Reference Data section below) to data/current
# download tables 1 through 3 to data/current
npm run generate
# update test expected values for new data
npm test

Reference Data

Lookup tables from Open Government Canada.

GIS lookup tables licensed under the Open Government License - Canada