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):

EntidadNombreFormatoObservaciones
ProvinciaPPCódigo de la provinciaNum.Obligatorio
PoblaciónEEEEENúmero de Entidad de PoblaciónNum.Obligatorio
CalleCCCCCNúmero de CalleNum.Obligatorio
FincaFFFFFNúmero de FincaNum.Obligatorio
FincaBBis/duplicadoAlfanum.Opcional
FincaTXXBloqueAlfanum.Opcional
FincaOYPortal/PuertaAlfanum.Opcional
FincaLLetra de la fincaAlfanum.Opcional
EscaleraSSIdentificador de escaleraAlfanum.Opcional
DomicilioAAAPlantaAlfanum.Obligatorio
DomicilioMMMMMano 1 del domicilioAlfanum.Opcional
DomicilioNNNNMano 2 del domicilioAlfanumOpcional

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 INE

El 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.
PPEEEEENOMBREINE
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
010000200001Calle 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:

OYDescripción
AAlmacén
BBloque
CCasa
EEdificio
FEstación
GGarage
HChalet
LPabellón
NNave
PParcela
RGrupo
SSector
TTorre
ZZona

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:

SSDescripción
0Escalera única
VIzquierda
WDerecha
XCentro
YInterior
ZExterior

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
ALaltillo
AMalmacen
ASascensor
ATatico
BAbajo
BUbungalow
CHchalet
DUduplex
ENentresuelo
ETentreplanta
GAgaraje
KIkiosco
LOlocal
MOmodulo
NAnave
OFoficina
PRprincipal
PTpuesto
S1sotano 1
S2sotano 2
S3sotano 3
S4sotano 4
S5sotano 5
S6sotano 6
S7sotano 7
S8sotano 8
S9sotano 9
SAsobreatico
SEsemisotano
SOsotano
SSsemisotano
TEterraza
TItienda
X1semisotano 1
X2semisotano 2
X3semisotano 3
X4semisotano 4
X5semisotano 5
X6semisotano 6
X7semisotano 7
X8semisotano 8
X9semisotano 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/NNNNDescripción
iddesc
APTOapartamento
ATatico
CTROcentro
DCHAderecha
DPCHdespacho
DCHAdrch
EXT.exterior
HABIhabitación
INT.interior
IZDAizda
IZDAizquierda
LOCLlocal
OFICoficina
PTO.puesto
0sin puerta
TDA.tienda