Skip to content

🇫🇷 Get the INSEE municipality code from postal code and name of French municipality

Notifications You must be signed in to change notification settings

gofer-work-on-demand/insee-municipality-code

Repository files navigation

🇫🇷 Get INSEE municipality code

tested with jest npm version CircleCI Build Status codecov

Simply provide the postal code and / or name of a French municipality and get the most likely INSEE municipality code

Installation

yarn add insee-municipality-code

or

npm i --save insee-municipality-code

Usage

import InseeCode from "insee-municipality-code"

InseeCode.getCode({ postalCode: "14710", name: "Colombières" }) // "14168"
InseeCode.getCode({ name: "Collonbier", postalCode: "15710" }) // "14168"
InseeCode.getCode({ name: "Lyon" }) // "69381"
InseeCode.getMunicipality("14168") // { postalCode: "14710", name: "COLOMBIERES" }
InseeCode.getMunicipality("96501") // null

Api

Method arguments  returned value  throws
getCode params: { postalCode: string? | number?, name: string? } string: the most likely Insee code regarding your input will throw if both params are empty
getMunicipality string, params: { postalCode: string? | number? }? { postalCode: string, name: string }?: the corresponding city (if it exists).1 will throw if insee code is not well formated (`/(\d{2}

1The second argument is optional and used to help decide which postalCode to return when the city corresponding to the Insee code has many options. e.g. : Saint-Maur-des-Fossés has Insee code 94068 and postal codes 94100 and 94210.

Dependencies

Limitations

This package loads in memory the name and postal code of 39k+ French towns. You should probably not try to send this package client side.

Contributing

Please fork this package, and run

yarn install
yarn test

Issues

Something is not working as expected? Some result is wrong? Documentation is missing? You need a different feature / API? Please file an issue, we'll be in touch.

References

(in French)

Financial Support

Gofer 🤝 (the human-centric work-on-demand solution) is the main support of this package.

About

🇫🇷 Get the INSEE municipality code from postal code and name of French municipality

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published