# datasets-fi-postalcodes

> Suomalaiset postinumerot, finnish postalcodes

Latest version **1.0.289** (published 2025-12-01) · MIT license · 1.1K weekly downloads

## Install

```sh
npm install datasets-fi-postalcodes
pnpm add datasets-fi-postalcodes
yarn add datasets-fi-postalcodes
bun add datasets-fi-postalcodes
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: no vulnerabilities.

Warnings: no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.0.289 |
| Published | 2025-12-01 |
| First published | 2016-01-26 |
| Weekly downloads | 1.1K |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 3.2 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 39 |
| Author | Teemu Heikkilä |
| Maintainers | theikkila |
| Keywords | Finnish, zip-code, postalcode, postal, code, finland |

## Links

- npm: https://www.npmjs.com/package/datasets-fi-postalcodes
- Repository: https://github.com/theikkila/postinumerot
- Homepage: https://github.com/theikkila/postinumerot#readme
- Issues: https://github.com/theikkila/postinumerot/issues
- npm.io page: https://npm.io/package/datasets-fi-postalcodes

## Alternatives

- [flatbuffers](https://npm.io/package/flatbuffers.md) — 6.0M weekly downloads
- [jwt-simple](https://npm.io/package/jwt-simple.md) — 259.5K weekly downloads
- [@exodus/patch-broken-hermes-typed-arrays](https://npm.io/package/@exodus/patch-broken-hermes-typed-arrays.md) — 28.5K weekly downloads
- [@native-to-anchor/buffer-layout](https://npm.io/package/@native-to-anchor/buffer-layout.md) — 12.2K weekly downloads
- [binary-parser-encoder](https://npm.io/package/binary-parser-encoder.md) — 5.3K weekly downloads

## Recent versions

- 1.0.289 (latest) — 2025-12-01
- 1.0.288 — 2025-10-30
- 1.0.287 — 2025-10-08
- 1.0.286 — 2025-09-29
- 1.0.285 — 2025-09-16
- 1.0.284 — 2025-09-15
- 1.0.283 — 2025-09-11
- 1.0.282 — 2025-08-20
- 1.0.281 — 2025-04-02
- 1.0.280 — 2025-03-24
- 1.0.279 — 2025-02-26
- 1.0.278 — 2025-01-21
- 1.0.277 — 2025-01-01
- 1.0.276 — 2024-12-20
- 1.0.275 — 2024-12-02
- … 273 more at https://npm.io/package/datasets-fi-postalcodes/versions

## README

# 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.

---
_Source: https://npm.io/package/datasets-fi-postalcodes · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._