/codes-postaux

Générer et manipuler facilement le fichier des codes postaux

Primary LanguageJavaScriptMIT LicenseMIT

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.

Warning

Les fichiers FIMOCT ne sont plus générés depuis 2023.

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.