ds-codigos-postales-ine-es/README.md

# ds-codigos-postales-ine-es

Dataset que proporciona un listado de todos los códigos postales de España asociados al código INE del municipio al que pertenecen.

Usa como fuente el Callejero del Censo Electoral (INE).

## Codigos Postales por Municipio
- Fuente: [Callejero del Censo Electoral (INE)](http://www.ine.es/ss/Satellite?L=es_ES&c=Page&cid=1254735624326&p=1254735624326&pagename=ProductosYServicios%2FPYSLayout)
- URL: `http://www.ine.es/prodyser/callejero/caj_esp/caj_esp_[MM][YYYY].zip` donde `MM` es el mes (01 ó 07) y la cadena `YYYY` es el último año
- Tipo: Texto de ancho fijo comprimido (.zip)
- Datos procesados: [/data/codigos_postales_municipios.csv](data/codigos_postales_municipios.csv)


### Formato de los datos


Ejemplo en CSV:

| codigo_postal | municipio_id | nombre_entidad_singular   |
|---------------|--------------|---------------------------|
| 28100         | 28006        | ALCOBENDAS                |
| 28108         | 28006        | ALCOBENDAS                |
| 28109         | 28006        | ALCOBENDAS                |
| 28110         | 28009        | "DEHESA NUEVA"            |
| 28120         | 28045        | "PUEBLAS (LAS)"           |
| 28124         | 28124        | "ROBLEDILLO DE LA JARA"   |
| 28130         | 28162        | MIRAVAL                   |
| 28140         | 28059        | ADOBERAS                  |
| 28150         | 28164        | "MIRADOR (EL)"            |
| 28160         | 28145        | "MORALEJA (LA)"           |
| 28170         | 28163        | "COTO DE SAN BENITO"      |
| 28180         | 28151        | "TOMILLARES (LOS)"        |
| 28189         | 28153        | "SOTO (EL)"               |
| 28190         | 28118        | "PUEBLA DE LA SIERRA"     |
| 28191         | 28117        | "PRADENA DEL RINCON"      |
| 28192         | 28021        | "DEHESA BOYAL"            |
| 28193         | 28039        | "CERCADOS (LOS)"          |
| 28194         | 28124        | "VILLAR (EL)"             |
| 28195         | 28902        | "SERRADA DE LA FUENTE"    |
| 28196         | 28902        | "PRESA DE PUENTES VIEJAS" |
| 28200         | 28131        | "JURISDICCION (LA)"       |
| 28210         | 28160        | VALDEMORILLO              |
| 28211         | 28054        | PERALEJO                  |
| 28212         | 28095        | "BARRANCOS (LOS)"         |


## Codigos Postales por Municipio (Histórico)
- Fuente: [Callejero del Censo Electoral (INE)](http://www.ine.es/ss/Satellite?L=es_ES&c=Page&cid=1254735624326&p=1254735624326&pagename=ProductosYServicios%2FPYSLayout)
- URL: `http://www.ine.es/prodyser/callejero/caj_esp/caj_esp_[MM][YYYY].zip` donde `MM` es el mes (01 ó 07) y la cadena `YYYY` es el año, (desde 2013 hasta la actualidad))
- Tipo: Texto de ancho fijo comprimido (.zip)
- Datos procesados: [/data/codigos_postales_municipios_historical.csv](data/codigos_postales_municipios_historical.csv)


### Formato de los datos


Ejemplo en CSV:

| codigo_postal | municipio_id | nombre_entidad_singular | year | month |
|---------------|--------------|-------------------------|------|-------|
| 29610         | 29076        | OJEN                    | 2013 |    07 |
| 29610         | 29076        | OJEN                    | 2014 |    01 |
| 29612         | 29076        | OJEN                    | 2014 |    01 |


En el ejemplo se aprecia como en 2014 aparece un nuevo código postal para el municipio de Ojén.


## Script

El script se puede encontrar en [/scripts/](/scripts/).


## Merge con ds-organizacion-administrativa

Para obtener el nombre de municipio asociado al codigo INE se puede hacer un merge con `ds-organizacion-administrativa/ds-oa-municipios` mediante `csvjoin`:

    $ curl https://raw.githubusercontent.com/codeforspain/ds-organizacion-administrativa/master/data/municipios.csv \
        | csvcut -c 'municipio_id,nombre' \
        | csvjoin -I -c "municipio_id" codigos_postales_municipios.csv - \
        | csvcut -c "codigo_postal,nombre_entidad_singular,municipio_id,nombre" \
        > codigos_postales_municipios_join.csv

Este comando devuelve [codigos_postales_municipios_join.csv](data/codigos_postales_municipios_join.csv). Ejemplo:


| codigo_postal | nombre_entidad_singular | municipio_id | nombre                     |
|---------------|-------------------------|--------------|----------------------------|
| 28100         | ALCOBENDAS              | 28006        | Alcobendas                 |
| 28108         | ALCOBENDAS              | 28006        | Alcobendas                 |
| 28109         | ALCOBENDAS              | 28006        | Alcobendas                 |
| 28110         | DEHESA NUEVA            | 28009        | Algete                     |
| 28120         | PUEBLAS (LAS)           | 28045        | Colmenar Viejo             |
| 28124         | ROBLEDILLO DE LA JARA   | 28124        | Robledillo de la Jara      |
| 28130         | MIRAVAL                 | 28162        | Valdeolmos-Alalpardo       |
| 28140         | ADOBERAS                | 28059        | Fuente el Saz de Jarama    |
| 28150         | MIRADOR (EL)            | 28164        | Valdetorres de Jarama      |
| 28160         | MORALEJA (LA)           | 28145        | Talamanca de Jarama        |
| 28170         | COTO DE SAN BENITO      | 28163        | Valdepiélagos              |
| 28180         | TOMILLARES (LOS)        | 28151        | Torrelaguna                |
| 28189         | SOTO (EL)               | 28153        | Torremocha de Jarama       |
| 28190         | PUEBLA DE LA SIERRA     | 28118        | Puebla de la Sierra        |
| 28191         | PRADENA DEL RINCON      | 28117        | Prádena del Rincón         |
| 28192         | DEHESA BOYAL            | 28021        | "Berrueco, El"             |
| 28193         | CERCADOS (LOS)          | 28039        | Cervera de Buitrago        |
| 28194         | VILLAR (EL)             | 28124        | Robledillo de la Jara      |
| 28195         | SERRADA DE LA FUENTE    | 28902        | Puentes Viejas             |
| 28196         | PRESA DE PUENTES VIEJAS | 28902        | Puentes Viejas             |
| 28200         | JURISDICCION (LA)       | 28131        | San Lorenzo de El Escorial |
| 28210         | VALDEMORILLO            | 28160        | Valdemorillo               |
| 28211         | PERALEJO                | 28054        | "Escorial, El"             |
| 28212         | BARRANCOS (LOS)         | 28095        | Navalagamella              |
Modify script to add sources 2016-11-26 21:44:16 +01:00			`# ds-codigos-postales-ine-es`
Initial commit 2016-11-14 21:33:22 +01:00
Newlines 2019-04-28 19:22:08 +02:00			`Dataset que proporciona un listado de todos los códigos postales de España asociados al código INE del municipio al que pertenecen.`
Initial commit 2016-11-14 21:33:22 +01:00
Modify script to add sources 2016-11-26 21:44:16 +01:00			`Usa como fuente el Callejero del Censo Electoral (INE).`
Initial commit 2016-11-14 21:33:22 +01:00
			`## Codigos Postales por Municipio`
			`- Fuente: [Callejero del Censo Electoral (INE)](http://www.ine.es/ss/Satellite?L=es_ES&c=Page&cid=1254735624326&p=1254735624326&pagename=ProductosYServicios%2FPYSLayout)`
Modify script to add sources 2016-11-26 21:44:16 +01:00			- URL: `http://www.ine.es/prodyser/callejero/caj_esp/caj_esp_[MM][YYYY].zip` donde `MM` es el mes (01 ó 07) y la cadena `YYYY` es el último año
Initial commit 2016-11-14 21:33:22 +01:00			`- Tipo: Texto de ancho fijo comprimido (.zip)`
Newlines 2019-04-28 19:22:08 +02:00			`- Datos procesados: [/data/codigos_postales_municipios.csv](data/codigos_postales_municipios.csv)`

Initial commit 2016-11-14 21:33:22 +01:00
			`### Formato de los datos`


			`Ejemplo en CSV:`

Newlines 2019-04-28 19:22:08 +02:00			`\| codigo_postal \| municipio_id \| nombre_entidad_singular \|`
			`\|---------------\|--------------\|---------------------------\|`
			`\| 28100 \| 28006 \| ALCOBENDAS \|`
			`\| 28108 \| 28006 \| ALCOBENDAS \|`
			`\| 28109 \| 28006 \| ALCOBENDAS \|`
			`\| 28110 \| 28009 \| "DEHESA NUEVA" \|`
			`\| 28120 \| 28045 \| "PUEBLAS (LAS)" \|`
			`\| 28124 \| 28124 \| "ROBLEDILLO DE LA JARA" \|`
			`\| 28130 \| 28162 \| MIRAVAL \|`
			`\| 28140 \| 28059 \| ADOBERAS \|`
			`\| 28150 \| 28164 \| "MIRADOR (EL)" \|`
			`\| 28160 \| 28145 \| "MORALEJA (LA)" \|`
			`\| 28170 \| 28163 \| "COTO DE SAN BENITO" \|`
			`\| 28180 \| 28151 \| "TOMILLARES (LOS)" \|`
			`\| 28189 \| 28153 \| "SOTO (EL)" \|`
			`\| 28190 \| 28118 \| "PUEBLA DE LA SIERRA" \|`
			`\| 28191 \| 28117 \| "PRADENA DEL RINCON" \|`
			`\| 28192 \| 28021 \| "DEHESA BOYAL" \|`
			`\| 28193 \| 28039 \| "CERCADOS (LOS)" \|`
			`\| 28194 \| 28124 \| "VILLAR (EL)" \|`
			`\| 28195 \| 28902 \| "SERRADA DE LA FUENTE" \|`
			`\| 28196 \| 28902 \| "PRESA DE PUENTES VIEJAS" \|`
			`\| 28200 \| 28131 \| "JURISDICCION (LA)" \|`
			`\| 28210 \| 28160 \| VALDEMORILLO \|`
			`\| 28211 \| 28054 \| PERALEJO \|`
			`\| 28212 \| 28095 \| "BARRANCOS (LOS)" \|`
Initial commit 2016-11-14 21:33:22 +01:00

			`## Codigos Postales por Municipio (Histórico)`
			`- Fuente: [Callejero del Censo Electoral (INE)](http://www.ine.es/ss/Satellite?L=es_ES&c=Page&cid=1254735624326&p=1254735624326&pagename=ProductosYServicios%2FPYSLayout)`
Modify script to add sources 2016-11-26 21:44:16 +01:00			- URL: `http://www.ine.es/prodyser/callejero/caj_esp/caj_esp_[MM][YYYY].zip` donde `MM` es el mes (01 ó 07) y la cadena `YYYY` es el año, (desde 2013 hasta la actualidad))
Initial commit 2016-11-14 21:33:22 +01:00			`- Tipo: Texto de ancho fijo comprimido (.zip)`
Newlines 2019-04-28 19:22:08 +02:00			`- Datos procesados: [/data/codigos_postales_municipios_historical.csv](data/codigos_postales_municipios_historical.csv)`

Initial commit 2016-11-14 21:33:22 +01:00

			`### Formato de los datos`


			`Ejemplo en CSV:`

Modify script to add sources 2016-11-26 21:44:16 +01:00			`\| codigo_postal \| municipio_id \| nombre_entidad_singular \| year \| month \|`
Newlines 2019-04-28 19:22:08 +02:00			`\|---------------\|--------------\|-------------------------\|------\|-------\|`
Modify script to add sources 2016-11-26 21:44:16 +01:00			`\| 29610 \| 29076 \| OJEN \| 2013 \| 07 \|`
			`\| 29610 \| 29076 \| OJEN \| 2014 \| 01 \|`
			`\| 29612 \| 29076 \| OJEN \| 2014 \| 01 \|`
Initial commit 2016-11-14 21:33:22 +01:00

Newlines 2019-04-28 19:22:08 +02:00			`En el ejemplo se aprecia como en 2014 aparece un nuevo código postal para el municipio de Ojén.`
Initial commit 2016-11-14 21:33:22 +01:00


			`## Script`

Newlines 2019-04-28 19:22:08 +02:00			`El script se puede encontrar en [/scripts/](/scripts/).`
Initial commit 2016-11-14 21:33:22 +01:00

			`## Merge con ds-organizacion-administrativa`

Modify script to add sources 2016-11-26 21:44:16 +01:00			Para obtener el nombre de municipio asociado al codigo INE se puede hacer un merge con `ds-organizacion-administrativa/ds-oa-municipios` mediante `csvjoin`:
Initial commit 2016-11-14 21:33:22 +01:00
Change merge.sh command to return output in the same format as shown in readme 2019-04-28 22:42:28 +02:00			`$ curl https://raw.githubusercontent.com/codeforspain/ds-organizacion-administrativa/master/data/municipios.csv \`
			`\| csvcut -c 'municipio_id,nombre' \`
			`\| csvjoin -I -c "municipio_id" codigos_postales_municipios.csv - \`
			`\| csvcut -c "codigo_postal,nombre_entidad_singular,municipio_id,nombre" \`
			`> codigos_postales_municipios_join.csv`
Initial commit 2016-11-14 21:33:22 +01:00
			`Este comando devuelve [codigos_postales_municipios_join.csv](data/codigos_postales_municipios_join.csv). Ejemplo:`
Newlines 2019-04-28 19:22:08 +02:00

			`\| codigo_postal \| nombre_entidad_singular \| municipio_id \| nombre \|`
			`\|---------------\|-------------------------\|--------------\|----------------------------\|`
			`\| 28100 \| ALCOBENDAS \| 28006 \| Alcobendas \|`
			`\| 28108 \| ALCOBENDAS \| 28006 \| Alcobendas \|`
			`\| 28109 \| ALCOBENDAS \| 28006 \| Alcobendas \|`
			`\| 28110 \| DEHESA NUEVA \| 28009 \| Algete \|`
			`\| 28120 \| PUEBLAS (LAS) \| 28045 \| Colmenar Viejo \|`
			`\| 28124 \| ROBLEDILLO DE LA JARA \| 28124 \| Robledillo de la Jara \|`
			`\| 28130 \| MIRAVAL \| 28162 \| Valdeolmos-Alalpardo \|`
			`\| 28140 \| ADOBERAS \| 28059 \| Fuente el Saz de Jarama \|`
			`\| 28150 \| MIRADOR (EL) \| 28164 \| Valdetorres de Jarama \|`
			`\| 28160 \| MORALEJA (LA) \| 28145 \| Talamanca de Jarama \|`
			`\| 28170 \| COTO DE SAN BENITO \| 28163 \| Valdepiélagos \|`
			`\| 28180 \| TOMILLARES (LOS) \| 28151 \| Torrelaguna \|`
			`\| 28189 \| SOTO (EL) \| 28153 \| Torremocha de Jarama \|`
			`\| 28190 \| PUEBLA DE LA SIERRA \| 28118 \| Puebla de la Sierra \|`
			`\| 28191 \| PRADENA DEL RINCON \| 28117 \| Prádena del Rincón \|`
			`\| 28192 \| DEHESA BOYAL \| 28021 \| "Berrueco, El" \|`
			`\| 28193 \| CERCADOS (LOS) \| 28039 \| Cervera de Buitrago \|`
			`\| 28194 \| VILLAR (EL) \| 28124 \| Robledillo de la Jara \|`
			`\| 28195 \| SERRADA DE LA FUENTE \| 28902 \| Puentes Viejas \|`
			`\| 28196 \| PRESA DE PUENTES VIEJAS \| 28902 \| Puentes Viejas \|`
			`\| 28200 \| JURISDICCION (LA) \| 28131 \| San Lorenzo de El Escorial \|`
			`\| 28210 \| VALDEMORILLO \| 28160 \| Valdemorillo \|`
			`\| 28211 \| PERALEJO \| 28054 \| "Escorial, El" \|`
			`\| 28212 \| BARRANCOS (LOS) \| 28095 \| Navalagamella \|`
Initial commit 2016-11-14 21:33:22 +01:00