datasets-fi-postalcodes/README.md

Suomalaiset postinumerot, finnish postalcodes

# Suomalaiset postinumerot

Datat rouhitaan *fetch.py* skriptillä Postin tietokannasta.
https://www.posti.fi/fi/asiakastuki/postinumerotiedostot

## Tiedostot

`postcode_map_light.json` *~92K* postinumero -> nimi (joko suomalainen tai ruotsalainen riippuen kunnan kielisyyssuhteesta)   
`postcode_map.json` *~1,7M* postinumero -> tietue (kaikki data postin tiedostosta json-muodossa)   
`postcodes.json` *~1,7M* lista tietueista json-muodossa   


**Huom! Gzipattuina koko pienenee vielä entisestään.**


## Ajantasaisuus

Viimeisin päivitys `LAST_UPDATED`-tiedostossa
Uusi versio buildataan joka päivä klo 8:00 UTC jos muutoksia ilmenee buildi julkaistaan uutena patchinä NPM:ään ja committina gittiin.

Build tehdään CircleCI:n avulla. Buildin yhteydessä ajettava testi menee hyväksyttävästi läpi jos muutoksia edelliseen on. ns. rikki oleva buildi ei siis ole merkki siitä onko paketti ajantasalla. (kts edellinen: [![CircleCI](https://dl.circleci.com/status-badge/img/gh/theikkila/postinumerot/tree/master.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/theikkila/postinumerot/tree/master))

## Postinumeroiden päivitys
```
./fetch_and_update.sh
```

## Esimerkki

```
npm install datasets-fi-postalcodes

```

```
const postinumerot = require('datasets-fi-postalcodes');
console.log(postinumerot['00100'])
```


## Käyttöehdot

Data on postin ja sitä koskee kaikki alkuperäisen https://www.posti.fi/fi/asiakastuki/postinumerotiedostot dokumentin käyttöehdot.

JSON-muunnokset ovat vapaasti käytettävissä ja muunneltavissa.