Skip to content

theikkila/postinumerot

Repository files navigation

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)

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.