ES-Municipalities

This package offers Spain's municipalities names and codes as shown in INE (Spain's National Statistics Institute).

According to Wikipedia:

A municipality is usually a single administrative division having corporate status and powers of self-government or jurisdiction as granted by national and regional laws to which it is subordinate.

Also Wikipedia has an specific page for municipalities of Spain.

XLSX Files provided by INE are updated the first day of every year and can be found at https://www.ine.es/dyngs/INEbase/es/operacion.htm?c=Estadistica_C&cid=1254736177031&menu=ultiDatos&idp=1254734710990.

Every change after the first day of the year is logged in the same page and this package will update its data accordingly. Information about new changes will be shown in this README file.

This package contains the data extracted from the information contained in an XLSX file provided by INE.

This package offers two files:

• An index.js file that contains an array with municipalities,
• A JSON file that you can read and parse to be offered using a REST API or to insert records into a database.

Install

yarn add @doncicuto/es-municipalities

or

npm install @doncicuto/es-municipalities --save

Usage

The default export is an array of objects with the following structure:

Property	Type	Description	Example
commCode	string	INE's Autonomous community code	07
provCode	string	INE's province code	47
code	string	INE's municipality code	186
dc	string	Control digit	8
name	string	province name	Valladolid

You can use @doncicuto/es-provinces and/or @doncicuto/es-autonomous-communities if you want to use the province and autonomous community codes to get the province and community names.

WARNING Be warned that this array contains 8131 municipalities so it may be heavy for your usage case. You may prefer to use the JSON file called 'municipalitiesWithProvinces.json' contained in the lib folder.

Example (Browser):

import municipalities from "@doncicuto/es-municipalities";

const names = municipalities.map((p) => p.name);
console.log(names);

const filtered = municipalities.filter((p) => p.commCode === "07");
console.log(filtered);

Example (NodeJS):

const municipalities = require("@doncicuto/es-municipalities").default;

const names = municipalities.map((p) => p.name);
console.log(names);

const filtered = municipalities.filter((p) => p.commCode === "07");
console.log(filtered);