Codificación es el proceso de traducción de direcciones de texto a una serie de códigos que nos permita identificar de forma unequivoca la ciudad, estado, código postal, vía, portal y cualquier información referente a una ubicación.
En España exiten variedad de codificación de direcciones públicas, las principales son las utilizadas por el INE (Instituto nacional de estadística), DGC (Dirección general del catastro) y Cartociudad (IGN).
GESCAL es el sistema de referencia de información de entidades geográficas definido y utilizado por telefónica, contiene información de las siguientes entidades: Comunidad Autónoma, Provincia, Municipio, Entidad Colectiva, Entidad Singular, Núcleo de Población, Entidad de Población, Tipo de Vía, Calle, Finca, Escalera, Domicilio, Código Postal.
Cada entidad tiene asociado un código único que la identifica en cualquier sistema que tome a GESCAL como referencia geográfica
El código de domicilio GESCAL es un valor alfanumérico de 37 posiciones, subdividido en subcampos que identifican cada una de las entidades geográficas que lo componen.
El formato es el siguiente (se resaltan en negrita y subrayados los subcampos obligatorios):

| Entidad | Nombre | Formato | Observaciones | |
|---|---|---|---|---|
| Provincia | PP | Código de la provincia | Num. | Obligatorio |
| Población | EEEEE | Número de Entidad de Población | Num. | Obligatorio |
| Calle | CCCCC | Número de Calle | Num. | Obligatorio |
| Finca | FFFFF | Número de Finca | Num. | Obligatorio |
| Finca | B | Bis/duplicado | Alfanum. | Opcional |
| Finca | TXX | Bloque | Alfanum. | Opcional |
| Finca | OY | Portal/Puerta | Alfanum. | Opcional |
| Finca | L | Letra de la finca | Alfanum. | Opcional |
| Escalera | SS | Identificador de escalera | Alfanum. | Opcional |
| Domicilio | AAA | Planta | Alfanum. | Obligatorio |
| Domicilio | MMMM | Mano 1 del domicilio | Alfanum. | Opcional |
| Domicilio | NNNN | Mano 2 del domicilio | Alfanum | Opcional |
Según el número de caracteres cumplimentados, el código gescal se puede utilizar para identificar desde una provincia a una unidad inmobiliaria.
Analicemos todas estas posibilidades desde la entidad superior (Provincia) hasta la unidad inferior (inmueble).
Provincia (PP dígitos del 1 al 2):
Representa la codificación del INE para cada provincia según la siguiente tabla:
Provincias INEEl Gescal 2 se compone del código de provincia PP.
- Obligatoridad: es un campo obligatorio.
- Formato: numérico de 2 posiciones que pueden tomar cualquier valor comprendido entre 01 y 52.
Población (EEEEE dígitos del 3 al 7):
Identifica la población, cada población tiene asignado un municipio del INE. Telefónica no publica el listado de sus poblaciones. Actualmente hay definidas más de 29.694, si estás interesado en disponer de esta información puedes ponerte en contacto con nosotros. Aquí te dejamos algunos ejemplos.
El Gescal 7 se compone de la concatenación de PPEEEEE.
- Obligatoridad: es un campo obligatorio.
- Formato: numérico de 5 posiciones que pueden tomar cualquier valor comprendido entre 00000 y 99999.
| PPEEEEE | NOMBRE | INE |
|---|---|---|
| 0100001 | Aberasturi | 01059 |
| 0100002 | Alegria-Dulantzi | 01001 |
| 0100003 | Amurrio | 01002 |
Calle (CCCCC dígitos del 8 al 12)
Campo compuesto por 5 dígitos que identifica el tipo (calle, plaza, avda..) y el nombre de vía dentro de una población. Telefónica tampoco no pone a disposición de los operadores esta información, actualmente tiene definidas más de 975k vías, si estás interesado en disponer de esta información puedes ponerte en contacto con nosotros. Aquí te dejamos algunos ejemplos.
El Gescal 12 se compone de la concatenación de PPEEEEECCCCC.
- Obligatoridad: es un campo obligatorio.
- Formato: numérico de 5 posiciones que pueden tomar cualquier valor comprendido entre 00000 y 99999.
| PPEEEEECCCCC | Descripción |
|---|---|
| 010000100738 | Calle Aberasturi |
| 010000200001 | Calle Dulantzi |
| 010000200002 | Calle Urbanizacion Alai |
Finca (FFFFF dígitos del 13 al 17)
Identifica la finca, portal o punto kilométrico de una vía (calle, carretera, etc). Es un campo numérico compuesto por 5 dígitos. Ejemplo la Calle Aberasturi número 5 se representaría con el código 01000010073800005
El Gescal 17 se compone de la concatenación de PPEEEEECCCCCFFFFF.
- Obligatoridad: es un campo obligatorio.
- Formato (FFFFF): numérico 5 posiciones que pueden tomar cualquier valor comprendido entre 00000 y 99999.
Bis/duplicado (B dígito 18)
- Obligatoriedad: es un campo Opcional
- Formato: es un campo de 1 posició que puede tomar cualquier valor comprendido entre A-Z y el 0-9.
Para los casos más habituales existe una codificación preestablecida, que debe ser utilizada:
Inentificativo del Bloque (TXX dígitos del 19 al 21)
- Obligatoriedad: es un campo Opcional
- Formato: es un campo de 3 posiciones que pueden tomar cualquier valor
Inentificativo del Portal/puerta (OY dígitos del 22 al 23)
- Obligatoriedad: es un campo Opcional
- Formato: es un campo de 2 posiciones.
Para los casos más habituales existe una codificación preestablecida, que debe ser utilizada:
| OY | Descripción |
|---|---|
| A | Almacén |
| B | Bloque |
| C | Casa |
| E | Edificio |
| F | Estación |
| G | Garage |
| H | Chalet |
| L | Pabellón |
| N | Nave |
| P | Parcela |
| R | Grupo |
| S | Sector |
| T | Torre |
| Z | Zona |
Letra (L dígito 24)
- Obligatoriedad: es un campo Opcional
- Formato: es un campo de 1 posición que puede tomar cualquier valor comprendido entre A-Z.
Escalera (SS dígitos del 25 al 26)
- Obligatoriedad: es un campo Opcional
- Formato: es un campo de 2 posiciones que pueden tomar cualquier valor comprendido entre A-Z.
Para los casos más habituales existe una codificación preestablecida, que debe ser utilizada:
| SS | Descripción |
|---|---|
| 0 | Escalera única |
| V | Izquierda |
| W | Derecha |
| X | Centro |
| Y | Interior |
| Z | Exterior |
Identificativo de Planta (B dígito del 27 al 29)
- Obligatoridad: es un campo obligatorio.
- Formato: Subcampo de 3 posiciones, que puede tomar los siguientes valores:
Un número de 3 posiciones (con ceros por delante), para especificar plantas de tipo numérico.
Un alfanumérico de 2 posiciones y un blanco por el final para especificar plantas de tipo alfanumérico, por ejemplo bajo, sótano, etc. En este caso debe utilizarse la siguiente codificación:
| AAA | Descripción |
|---|---|
| AL | altillo |
| AM | almacen |
| AS | ascensor |
| AT | atico |
| BA | bajo |
| BU | bungalow |
| CH | chalet |
| DU | duplex |
| EN | entresuelo |
| ET | entreplanta |
| GA | garaje |
| KI | kiosco |
| LO | local |
| MO | modulo |
| NA | nave |
| OF | oficina |
| PR | principal |
| PT | puesto |
| S1 | sotano 1 |
| S2 | sotano 2 |
| S3 | sotano 3 |
| S4 | sotano 4 |
| S5 | sotano 5 |
| S6 | sotano 6 |
| S7 | sotano 7 |
| S8 | sotano 8 |
| S9 | sotano 9 |
| SA | sobreatico |
| SE | semisotano |
| SO | sotano |
| SS | semisotano |
| TE | terraza |
| TI | tienda |
| X1 | semisotano 1 |
| X2 | semisotano 2 |
| X3 | semisotano 3 |
| X4 | semisotano 4 |
| X5 | semisotano 5 |
| X6 | semisotano 6 |
| X7 | semisotano 7 |
| X8 | semisotano 8 |
| X9 | semisotano 9 |
Mano 1 (MMMM digitos 30 al 33) y Mano 2 (NNNN dígitos del 34 al 37)
Identifican la situación de un domicilio dentro de una planta.
- Obligatoriedad: es un campoopcional
- Formato: estos campos pueden contener cualquier valor alfanumérico.
Para los casos más habituales existe una codificación preestablecida, que debe ser utilizada:
| MMMM/NNNN | Descripción |
|---|---|
| id | desc |
| APTO | apartamento |
| AT | atico |
| CTRO | centro |
| DCHA | derecha |
| DPCH | despacho |
| DCHA | drch |
| EXT. | exterior |
| HABI | habitación |
| INT. | interior |
| IZDA | izda |
| IZDA | izquierda |
| LOCL | local |
| OFIC | oficina |
| PTO. | puesto |
| 0 | sin puerta |
| TDA. | tienda |