Conjunto de datos actualizado en formato base de datos MySQL de la organización territorial española (comunidades, provincias, municipios, comarcas y otras entidades de población), incluyendo códigos postales e información geográfica, con tablas optimizadas para consultas rápidas, mínimo espacio posible de los registros relacionados y uso fácil. 
Para los impacientes:
- Descargar el archivo 7z (comprimido con 7-zip) que contiene los volcados SQL (dumps) de las tablas mínimas. Las tablas adicionales se publicarán en una próxima versión.
- Echa un vistazo a las tablas y definición de IDs.
- Hay municipios con código postal único, municipios que tienen varios códigos postales y también existen municipios que comparten un mismo código postal.
- Probado en MariaDB 10.11.2, 10.1, 10.5 y 10.6 aunque por la simplicidad de las tablas debería ser compatible con versiones anteriores y MySQL 5 y 8.
- Usado en aplicaciones reales utilizadas diariamente con entradas de datos dependientes de códigos postales, provincias, municipios...
En la página de Demos encontrarás algunas de las cosas interesantes que podemos hacer con Soft Line Geo DB.
| Países | 250 |
|---|
| Municipios España | 8.131 | Códigos postales | 11.053 |
|---|
La organización territorial de España se inicia con 19 demarcaciones autónomas, cada una dividida en una o varias provincias (52). Cada provincia se divide a su vez en varios municipios (en total 8.131). Los municipios son las entidades territoriales básicas en esta organización, aunque existen otras entidades territoriales como agrupaciones de municipios o entidades de rango inferior al municipio, conocidas como "entidades locales menores".
| Autonomías | 19 |
|---|---|
| 17 comunidades autónomas de las que 2 son archipiélagos: las islas Baleares y las Canarias 2 ciudades autónomas en África: Ceuta y Melilla |
| Provincias | 52 | Islas | 11 |
|---|---|---|---|
| 49 sin islas 3 con islas |
0 4 islas Baleares (1 provincia) 7 islas Canarias (en 2 provincias) |
Para poder tomar decisiones basadas en datos, estos deben tener cierta consistencia y ser lo más precisos posible. Cuando hablamos de datos relacionados con la ubicación, resulta asombrosa la cantidad de programas informáticos y servicios que recogen esta información de la peor manera posible en términos de tratamiento y analítica de datos (abominaciones como números inventados para los municipios o directamente el nombre de la "población" o municipio en cada registro, incluso a veces, texto libre, en vez de identificadores).
Con el objetivo de intentar mejorar esta mala situación del software y registros en general, publicamos “Soft Line Geo DB”, para que quien quiera “hacer las cosas bien” tenga recursos a su alcance.
Estas son las motivaciones principales que nos llevaron a crear esta base de datos:
- Disponer de una base de datos relacional en la que estén normalizados los datos de provincia y municipios españoles, usando IDs numéricos compatibles con los oficiales y no números inventados con AUTOINCREMENT a salto de mata, que es lo fácil.
- Poder determinar a qué municipio oficial pertenece un código postal y cuántas calles comprende. La problemática de los códigos postales es que estos no son estrictamente una subdivisión de los municipios: hay municipios con un solo código postal, otros que tienen varios, y también hay municipios que comparten un mismo código postal.
- Geoposicionar (con latitud/longitud) los municipios y tener otra información, como la isla a la que pertenece, provincia, comunidad autónoma, nº de habitantes, altitud...
- Poder presentarle al usuario los municipios de la ISLA a la que se refiere, en lugar de "como hace todo el mundo": darle los municipios de todas las islas mezclados, solo porque son "de la misma provincia"...
- Poder relacionar datos del INE y otras fuentes -geográficas, estadísticas- a partir de referencias consistentes y compatibles (ID municipio, ID provincia, a veces se tiene solo el código postal como dato fiable, etc.)
Actualización enero 2023. Los datos procesados están creados a partir de fuentes oficiales: INE y CNIG (IGN), tan pronto el INE publicó en Internet los datos de enero de 2023 del Callejero de Censo Electoral, exactamente el día 9 de marzo de 2023. El procesado de datos se realizó el 26 de marzo, descargando también entonces los últimos datos del CNIG. Ver más información en el siguiente apartado fuentes de datos.
Esta base de datos procesados se construye desde 2016 y ha sido actualizada en las siguientes fechas, si bien se publica en Github el 1 de mayo de 2023:
| Fecha | Comentario |
|---|---|
| 19 de marzo de 2023 | Actualización con datos 2023 |
| 1 de enero de 2021 | Actualización con datos 2020 |
| 15 de junio de 2019 | Actualización con datos 2019 |
| 27 de mayo de 2018 | Actualización con datos 2018, 1ª versión con tabla entidades_geo |
| 20 de agosto de 2017 | Actualización con datos 2017, 1ª versión con tabla de países |
| 2 de mayo de 2016 | 1ª versión de las tablas con datos 2016 del INE y CNIG/IGN |
INE (Instituto Nacional de Estadística) que mantiene los datos de municipios / provincias / comunidades autónomas y el callejero del censo electoral con sus códigos postales.
- Recurso: INE: Relación de municipios y sus códigos por provincias. Últimos datos
- Recurso: Cartografía secciones censales y callejero de Censo Electoral - (Ver fichero nacional del "Callejero de Censo Electoral")
CNIG (Centro Nacional de Información Geográfica) dirigido por el IGN (Instituto Geográfico Nacional), que mantiene diversos conjuntos de datos geográficos.
- Recursos: En el Centro de Descargas del CNIG ver el "Nomenclátor Geográfico Básico de España" y el "Nomenclátor Geográfico de Municipios y Entidades de Población"
En mayo de 2023 se contrastó la fiabilidad de los datos de códigos postales: la tabla "municipios_cp" de este proyecto -que relaciona los códigos postales con los municipios- se chequeó contra los datos CSV generados por este otro proyecto similar de Íñigo Flores. La comparación fue exacta para los datos de 2023-1 (Enero).
La versión de datos mínima consta de 7 tablas SQL.
En las siguientes imágenes, los iconos de llaves de color amarillo son índices PRIMARY KEY, las verdes son INDEX y las rojas son índices UNIQUE.
| ID | Nombre | Descripción |
|---|---|---|
| id_ccaa | Comunidad Autónoma | Número del 1 al 19, sin cero inicial, basta 1 byte y por eso el tipo de dato es TINYINT UNSIGNED |
| id_provincia | Provincia | Número del 1 al 52, sin cero inicial, basta 1 byte y por eso el tipo de dato es TINYINT UNSIGNED |
| id_municipio | Municipio | Para poder identificar un municipio de forma única y almacenarlo como un tipo númerico, sin ceros iniciales (al contrario que el INE), lo que hacemos es prefijar el "id_ccaa" (Comunidad Autónoma) y seguir el patrón del INE: dos cifras del 01 al 52 para la provincia, y 3 cifras para el código de municipio, del 001 al 999. De esta manera nos bastan 3 bytes para referenciar un municipio de forma única (tipo MEDIUMINT UNSIGNED) y además podemos obtener la Comunidad Autónoma leyendo hacia atrás el ID municipio. |
Sobre nuestro id_municipio: Por ejemplo el código de provincia y municipio de Palma de Mallorca en el INE sería 07040 (provincia 07, municipio 040). En nuestra base de datos el id_municipio se queda como 407040 ya que el id 4 es el de la comunidad autónoma de las Islas Baleares y se le concatena el "07040" del INE después.
La ciudad de Valencia, cuyo código de provincia y municipio del INE juntos sería 46250 (46 código provincia, 250 código de municipio), se queda como 1046250 ya que 10 es el ID de Comunidad Autónoma.
Las tablas completas con datos extra incluyen datos procesados del callejero del INE y las entidades poblacionales adicionales e información geográfica extra del CNIG, todo asociado a los ID de municipio, pero su uso es más raro y ocupan mucho más espacio (son cientos de miles de filas).
Las 19 autonomías (por unificar: CCAA o Comunidades Autónomas) con las ciudades autónomas de Ceuta y Melilla.
Cada provincia pertenece a una Comunidad Autónoma ("ccaa") y se indica el municipio que es la capital de la provincia. Existe además un nombre, nombre corto y nombre alternativo.
Permite asociar las 11 islas de entidad en España con su provincia, pues las islas Canarias se agrupan en 2 provincias.
Cada municipio tiene el ID de su Comunidad Autónoma ("ccaa") y Provincia "id_provincia". El ID de isla será distinto de 0 si procede.
De esta tabla podemos extraer a qué municipio(s) pertenece un código postal. Algunos códigos postales están compartidos entre 2 municipios o más y un municipio puede tener uno o varios códigos postales.
De aquí obtendremos información geográfica de un ID municipio dado, incluyendo latitud/longitud del centroide del municipio, nº de habitantes, etc.
Asociación de todos los núcleos de población del CNIG con el padrón municipal, para asociar nº de habitantes y posición geográfica de todos los "CUN" y no solo municipios.
-
2013: La base de datos de códigos postales oficial de Correos siempre ha sido de pago, y desde hace un tiempo ofrece varias versiones. Los precios van desde 800 € a 5.000 €
Correos: Base de datos (de pago) de códigos postales -
2013: El siguiente artículo de Pablo Barrachina es el que motivó la creación de "softlinegeodb" en 2016:
Relacionar el Código INE con su Código Postal de Pablo Barrachina -
2016: Primera versión (interna) de "Soft Line Geo DB", de Juan Gabriel Covas para SOFT LINE Informática
-
2017: Relación de códigos postales de España de Iñigo Flores junto el código INE del municipio al que pertenecen, con las geometrías asociadas a cada código postal en formato .geojson
-
2017: Base de Datos de Códigos Postales de Javier Casares, volcado en CSV, Excel y SQL, pero sin fuentes contrastables. Indica: "La información de este sitio recoge datos de Correos, Google Maps, Códigos Postales y otras fuentes. La información puede no ser exacta". Actualizado en 2019.
-
2019: Petición formal (42 solicitantes) a “Datos abiertos” del Gobierno (datos.gob.es) de una “Base de delimitaciones de los CODIGOS POSTALES DE ESPAÑA”. Estado: No viable. "La base de delimitaciones de códigos postales actualmente está sujeta a comercialización". Se refieren a Correos.
-
2022: Conjunto de datos con todos los códigos postales de España asociados a los municipios y unidades poblacionales de Íñigo Flores, usa como fuente el Callejero del Censo Electoral (del INE).
-
2022: Este fantástico trabajo de Francisco Goerlich es prácticamente un tratado sobre códigos postales. Para los interesados en obtener cartografía actualizada de los códigos postales en España:
Elaboración de un mapa de códigos postales de España con recursos libres. Cómo evitar pagar por disponer de información de referencia de Francisco Goerlich (Universidad de Valencia e IVIE: Instituto Valenciano de Investigaciones Económicas)
(Trabajo en PDF) Página del trabajo en IVIE.
"Soft Line GeoDB" es un trabajo de Juan Gabriel Covas para SOFT LINE Informática. 2016 - 2023
Contacto por mail: jgcovas at domain softline.es
Basado en el artículo de 2013: Relacionar el Código INE con su Código Postal de Pablo Barrachina
Licencia GPL-3.0
Uso libre de "Softlinegeodb". Las modificaciones, si se distribuyen, deben hacerse con código fuente.