codes-postaux

French postal codes API for Node.js

Usage no npm install needed!

<script type="module">
  import codesPostaux from 'https://cdn.skypack.dev/codes-postaux';
</script>

README

Codes postaux

Ce dépôt contient les scripts permettant de générer le fichier des codes postaux ainsi qu'un module Node.js permettant de l'interroger facilement.

Données

Sources

Les données de base sont produites à partir du Code Officiel Géographique de l'INSEE et du FIMOCT de la DGFiP.

Production

npm install
npm run build

Module JavaScript

Installation

$ npm install codes-postaux --save

Utilisation

const codesPostaux = require('codes-postaux');

codesPostaux.find(75001);
codesPostaux.find('75001');

Retourne

[ { codeCommune: '75101',
    nomCommune: 'Paris 1er Arrondissement',
    codePostal: '75001',
    libelleAcheminement: 'PARIS' } ]

Communes mortes pour la France

6 communes ont une population municipale nulle. Il s'agit des communes mortes pour la France.

const COMMUNES_MORTES_POUR_LA_FRANCE = [
  '55039',
  '55050',
  '55239',
  '55307',
  '55139',
  '55189'
];

Autres bibliothèques connues

Nom de la bibliothèque Langage Auteur
codes_postaux Dart Kleak

Et les données de La Poste ?

Pourquoi ne pas utiliser la base officielle des codes postaux produite par La Poste ?

Les données produites par La Poste sont diffusées sous licence ODbL, ce qui implique que toute base de données dérivée doit être diffusée sous cette même licence.

Par ailleurs le fichier diffusé par La Poste est moins complet puisqu'il n'indique pas quelles sont les voies ou les numéros concernés par un code postal, lorsque plusieurs postaux sont associés à une même commune.