Normalización de Direcciones

Normalización de Direcciones

 

Descripción General

La normalización de una dirección postal consiste en el tratamiento de los datos postales validando la existencia de una dirección para un determinado alcance postal(localidad, provincia y/o CP), lo que permite identificar problemas de localidades, calles o alturas inexistentes o, formatos incompletos o incomprensibles de escritura. Por otro lado detecta distintas gramáticas de escritura de una dirección, permitiendo separar calle, número, piso, departamento y observaciones o comentarios informados. El resultado obtenido sera un domicilio estandarizado en su escritura y validado.

Además, a partir de la validación de existencia de la dirección, Merlin enriquece los datos postales faltantes : Código Postal, Barrio, Localidad, Partido y Provincia . La información se completa con la asignación de las entre calles correspondientes para brindar un localización más precisa.

Consideraciones generales

El cliente debe enviar una estructura de Dirección según lo detallado en el apartado «Atributos de entrada» debiendo completar mínimamente los campos que se detallan a continuación:

  • street: este campo puede contener tanto el nombre de la calle como la dirección completa (street, houseNumber, floor, unit). Los campos houseNumber, floor, unit NO deben ser completados si se ingreso la calle completa en el campo “street”.
  • level4: puede no completarse si se informa el postalCode.
  • level2: puede no completarse si se informa el postalCode.
  • postalCode: puede no completarse si se informa la level4.
  • clientAccessCode: ID de acceso de cliente.

El resultado del proceso de normalización de una dirección sera la estructura de datos detallada en el apartado «Atributos de salida»

Estados para Direcciones

Atributo Significado Descripción
CO Corregido Merlin devuelve todos los datos normalizados. También informa las posibles contingencias que se hayan producido para obtener dicha resolución
NE No Encontrado Dirección no encontrada
DU Dudoso Merlin retorna más de una dirección con diferentes soluciones
SD Sin Datos No se provee de datos
NP No Parseado Direcciones que no pueden ser interpretadas por la gramática de direcciones

Motivos para Direcciones

Motivos aplicados a Corregidos (CO)

Atributo Significado Descripción
SM Sin Motivo

Motivos de no resolución aplicados a No encontrados (NE)

Atributo Significado Descripción
LI Localidad Inválida No se puede identificar el ámbito de búsqueda de la dirección, ya sea por falta de información, o los datos son inconsistentes entre sí.
CI Calle Inválida La calle, no se puede localizar en la localidad informada.
AI Altura Inválida Localizada la calle, la altura informada no corresponde a una altura valida de la calle. En este caso, Merlin informa el rango válido de alturas para la calle.
SD Sin Datos

Aplicados a Dudosos (DU)

Atributo Significado Descripción
DE Duda Estandar Dos o más calles, matchean de igual forma con la calle informada. Merlin devuelve cada una de las opciones encontradas
DA Duda por Altura La altura de la calle no es encontrada en la localidad informada, pero si en una localidad vecina, y Merlin no puede asegurar que una calle sea la continuación de la otra. En este caso se devuelve tanto la información correspondiente a la altura inválida en la localidad original, como la opción de resolución en la localidad vecina
DZ Duda por Barrio Zonal El barrio zonal informado no es encontrado o se encuentra un barrio o más que matchean de igual forma. Merlin retorna cada una de las opciones encontradas.
DC Duda por Barrio Cerrado El barrio cerrado informado no es encontrado o se encuentra un barrio o más que matchean de igual forma. Merlin retorna cada una de las opciones encontradas.

Custom Adapters

Valor Descripción
SAS_EXCLUDE_GCA Excluir todos los custom values, excepto los que se informen luego de este. (*)
CA_GEO_AR Devuelve nivel normalizacion geo para Argentina.
CA_ENTRECALLE_ADDRESS Devuelve entrecalles.
CA_CPA_ADDRESS Devuelve CPA.
CA_NISE Devuelve Nivel Socioeconomico.
CA_ZP_AR Devuelve si es Zona Peligrosa Argentina.
CA_ADDRESS_POINT_AR Devuelve información de addresspoint Argentina.
CA_GEO_TYPE Devuelve tipoGeo.

(*) Siempre debe enviarse.

Atributos de entrada

Atributo Longitud Máxima Descripción del atributo
clientAccessCode 64 Identificador único de usuarios. Este valor identifica y valida en cada invocación a un usuario determinado. Este valor tiene asociado los roles que le corresponden al usuario.
customAdapters 64 Adaptadores de respuesta/modificadores de comportamiento. Para más información ver «Adaptadores de respuesta».
level1 64 Corresponde al primer nivel (País) administrativo de una dirección. Para más información ver «Niveles administrativos«.
level2 64 Corresponde al segundo nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Provincia. Para más información ver «Niveles administrativos«.
level3 64 Corresponde al tercer nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Partido. Para más información ver «Niveles administrativos«.
level4 64 Corresponde al cuarto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Localidad. Para más información ver «Niveles administrativos«.
level5 64 Corresponde al quinto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Barrio. Para más información ver «Niveles administrativos«.
street 64 Nombre de la calle o dirección completa. Puede incluir nombres de barrios cerrados, barrios zonales, rutas, alturas, piso, depto, referencias, nombres de puntos de interes, etc.
houseNumber 10 Número de la dirección.
floor 2 Piso de la dirección.
unit 3 Departamento, numero de casa, oficina, PH, local, entre otros elementos de la dirección.
postalCode 4 Código Postal de la dirección.
additionalData 64 Observaciones o datos adicionales de la calle.
betweenStreet1 64 Entre calles entrada para constatar dicha calle con esa altura.
betweenStreet2 64 Entre calles entrada para constatar dicha calle con esa altura.
Nota:

** Para la normalización de Rutas utilizar el token «Ruta» e informar el kilometraje con el prefijo Km. Ejemplo: Ruta Nacional 12 Km 1575.

** En los casos de Barrios utilizar los token «Barrio» , «BO» o «Country». Ejemplo: BO CLUB DE CAMPO EL PASO o BARRIO CLUB DE CAMPO EL PASO.

Atributos de salida

 

Atributo

Longitud Máxima Observación
status 3 Indica el estado de normalización y/o validación. Para mas información ver el apartado «Estados y Motivos».
statusReason 2 Indica la razón con referencia al estado de normalización y/o validación. Para mas información ver el apartado «Estados y Motivos”.
remainingCredits 16 Créditos restantes del usuario.
transactionId 10 Merlin asigna un id de transacción por consulta.
nAddress Son los datos de la dirección ya corregida. Si la dirección no pudo ser corregida, aquí se encontrarán los datos de la dirección original parseados de haber sido posible.
geoType 2 Tipo de georeferenciación, ver documento “Tipo de Georeferenciación”.
level1 64 Corresponde al primer nivel (País) administrativo de una dirección. Para más información ver «Niveles administrativos«.
level2 64 Corresponde al segundo nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Provincia. Para más información ver «Niveles administrativos«.
level3 64 Corresponde al tercer nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Partido. Para más información ver «Niveles administrativos«.
level4 64 Corresponde al cuarto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Localidad. Para más información ver «Niveles administrativos«.
level5 64 Corresponde al quinto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Barrio. Para más información ver «Niveles administrativos«.
streetType 12 Tipo de vialidad como ser avenida, calle,etc.
street 64 Nombre de la calle normalizada o estandarizada.
houseNumber 10 Numeración de la dirección.
floor 2 Piso de la dirección.
unit 3 Departamento, numero de casa, oficina, PH, local, entre otros elementos de la dirección.
latitude 10 Coordenada Y de georeferenciación.
longitude 10 Coordenada X de georeferenciación.
postalCode 4 Código postal de la dirección.
additionalPostalCode 8 Codigo postal adicional. Por ejemplo para Argentina, «Código Postal Argentino» (CPA).
fromStreetNumber 10 Altura inicial para la calle normalizada.
toStreetNumber 10 Altura final para la calle normalizada.
additionalData 64 Son datos extras encontrados en la dirección original que no corresponden a ningún campo.
betweenStreet1 64 Primera transversal del domicilio.
betweenStreet2 64 Segunda transversal del domicilio.
corner 64 Esquina de la dirección o denominación de la esquina a normalizar.
placeType 12 Tipo de punto de interés, lugar, etc.
place 64 Nombre del punto de interés, lugar, etc.
placeReference 64 Datos complementarios de como llegar al domicilio normalizado, es utilizado para los barrios cerrados. Para màs información ver «Resolución de POIS»
numberAlternativeAddresses 1 Cantidad de direcciones alternativas.
alternativeAddresses Si existe mas de una a la dirección posible para los datos ingresados, aquí se retornará N estructuras de respuesta de direcciones. El máximo posible de direcciones dudosas es de 5. Es decir, que es posible que la estructura se repita de 1 a 5 veces. Si no existieron direcciones alternativas, entonces el campo estará vacío.
level1 64 Corresponde al primer nivel (País) administrativo de una dirección. Para más información ver «Niveles administrativos«.
level2 64 Corresponde al segundo nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Provincia. Para más información ver «Niveles administrativos«.
level3 64 Corresponde al tercer nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Partido. Para más información ver «Niveles administrativos«.
level4 64 Corresponde al cuarto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Localidad. Para más información ver «Niveles administrativos«.
level5 64 Corresponde al quinto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Barrio. Para más información ver «Niveles administrativos«.
street 64 Nombre de la calle alternativa encontrada.
houseNumber 5 Numeración de la dirección.
geoType 2 Tipo de georeferenciación, ver documento “Tipo de Georeferenciación”.
latitude 10 Coordenada Y de georeferenciación.
longitude 10 Coordenada X de georeferenciación.
postalCode 4 Código postal de la dirección.
fromStreetNumber 5 Altura inicial para la calle normalizada.
toStreetNumber 5 Altura final para la calle normalizada.
merlinCustomValues Valores desarrollados por demanda del cliente o que se provee opcionalmente como el nivel socioeconómico.
addressLabel 100 Etiqueta de la dirección. Por ejemplo: «Av. Libertador 7270 2 A, (1429), Ciudad Autónoma de Buenos Aires, Argentina»
NISE 1 Nivel socioeconómico de la dirección. Para mas información ver «Nivel Socioeconómico«
maqStatus 2 Indica si el domicilio se encuentra en MAQ asociado a un criterio definido por el cliente (Si o No).
maqConcept 16 Indica el concepto asignado en MAQ (Inhibido, Fraudulento).
maqValue Variable Valor asignado al agregar el domicilio a MAQ.(Valores Numéricos, escala para el concepto).
level4Longitude 10 Indica la longitud del centroide de la localidad.
level4Latitude 10 Indica la latitud del centroide de la localidad.
postalCertifiedAddress 1 Dirección Verificada a nivel de puerta. Para mas información ver «Validación de Puertas».
merlinRiskArea 1 Indica si la dirección corresponde a una zona de riesgo o difícil acceso (S o N).
buildingType 10 Edificio, casa, terreno, etc.
clientCustomValues Valores desarrollados por demanda del cliente o que se provee opcionalmente.

Estructura de Dudas

 

Atributo

Longitud Máxima Observación
geoType 2 Tipo de georeferenciación, ver documento “Tipo de Georeferenciación”.
level1 64 Corresponde al primer nivel (País) administrativo de una dirección. Para más información ver «Niveles administrativos«.
level2 64 Corresponde al segundo nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Provincia. Para más información ver «Niveles administrativos«.
level3 64 Corresponde al tercer nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Partido. Para más información ver «Niveles administrativos«.
level4 64 Corresponde al cuarto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Localidad. Para más información ver «Niveles administrativos«.
level5 64 Corresponde al quinto nivel administrativo de una dirección. Por ejemplo para Argentina, corresponde a Barrio. Para más información ver «Niveles administrativos«.
street 64 Nombre de la calle normalizada o estandarizada. de vialidad como ser avenida, calle,etc.
houseNumber 10 Numeración de la dirección.
latitude 10 Coordenada Y de georeferenciación.
longitude 10 Coordenada X de georeferenciación.
postalCode 4 Código postal de la dirección.
fromStreetNumber 5 Altura inicial para la calle normalizada.
toStreetNumber 5 Altura final para la calle normalizada.

Para ver más detalles de los WebServices:

Formato de mensajería JSON
Formato de mensajería SOAP