8132 municipios
de España

Municipios dentro de un radio en km de una ciudad de referencia. No incluye la propia ciudad de referencia.

import { getCitiesInRange } from 'spanish-cities-info';

getCitiesInRange('Ferrol', 10).map((c) => c.name);
// ['Ares', 'Mugardos', 'Narón']

Devuelve los 8.132 municipios, ordenados alfabéticamente por nombre.

import { getAllCities } from 'spanish-cities-info';

getAllCities();
// [{ name: 'A Baña', ineCode: '15007', province: 'A Coruña',
//    community: 'Galicia', latitude: 42.9634, longitude: -8.7529 }, ...]

Busca un municipio por su código INE de 5 dígitos. Devuelve undefined si no existe.

import { getCityByCityCode } from 'spanish-cities-info';

getCityByCityCode('15036');
// { name: 'Ferrol', ineCode: '15036', province: 'A Coruña',
//   community: 'Galicia', latitude: 43.5098, longitude: -8.2704 }

Busca municipios cuyo nombre contenga el texto indicado. No distingue mayúsculas/minúsculas.

import { getCityByName } from 'spanish-cities-info';

getCityByName('Ferrol');
// [{ name: 'Ferrol', ineCode: '15036', province: 'A Coruña', ... }]

Todos los municipios de una provincia. Útil para un select en cascada en un formulario.

import { getCitiesByProvince } from 'spanish-cities-info';

getCitiesByProvince('Melilla');
// [{ name: 'Melilla', ineCode: '52001', province: 'Melilla',
//    community: 'Melilla', latitude: 35.291, longitude: -2.9505 }]

Todos los municipios de una comunidad autónoma.

import { getCitiesByCommunity } from 'spanish-cities-info';

getCitiesByCommunity('Melilla');
// [{ name: 'Melilla', ineCode: '52001', province: 'Melilla', ... }]

Todos los municipios de una isla. Solo aplica a los 155 municipios de Illes Balears, Las Palmas y Santa Cruz de Tenerife: el resto de España no tiene este dato y su island es undefined.

import { getCitiesByIsland } from 'spanish-cities-info';

getCitiesByIsland('Menorca');
// [{ name: 'Alaior', ineCode: '07002', province: 'Illes Balears',
//    community: 'Illes Balears', island: 'Menorca',
//    latitude: 39.9339, longitude: 4.1403 }, ...]

Listado de las 52 provincias, ordenado alfabéticamente.

import { getProvinces } from 'spanish-cities-info';

getProvinces();
// ['A Coruña', 'Alacant', 'Albacete', 'Almería', 'Araba', ...]

Listado de las 19 comunidades y ciudades autónomas, sin duplicados.

import { getCommunities } from 'spanish-cities-info';

getCommunities();
// ['Andalucía', 'Aragón', 'Asturias', 'Canarias', 'Cantabria', ...]