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 validado y estandarizado en su escritura.

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 «Datos 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 ingresa la calle completa en el campo “street”.
  • level4: Corresponde al nivel de la localidad, puede no completarse si se informa el postalCode.
  • postalCode: Corresponde al código postal, 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 «Datos de salida»

 

Método

GET

Definición de la Ruta de Acceso

https://api.merlindataquality.com/2.0/addressnormalizer.json?

Formato de Entrada

https://api.merlindataquality.com/2.0/addressnormalizer.json?street= Av. Libertad 1524&level4=CABA&clientAccessCode={{clientAccessCode}}

Formato de Salida Direcciones

{
  
    "status": "CO",
    "statusReason": "SM",
    "remainingCredits": "-2363432",
    "transactionId": "cc9691fb-8ce1-42fe-9a11-bd5f568279a3",
    "nAddress": {
        "geoType": "1",
        "level1": "",
        "level2": "CAPITAL FEDERAL",
        "level3": "CAPITAL FEDERAL",
        "level4": "CIUDAD AUTONOMA BUENOS AIRES",
        "level5": "NUÑEZ",
        "streetType": "",
        "street": "AVDA DEL LIBERTADOR",
        "houseNumber": "8620",
        "floor": "",
        "unit": "",
        "latitude": "-34.536478",
        "longitude": "-58.466545",
        "postalCode": "1429",
        "additionalPostalCode": "C1429BNT",
        "fromStreetNumber": "1",
        "toStreetNumber": "8700",
        "additionalData": "C 1429 CABA",
        "betweenStreet1": "NICOLAS DE VEDIA",
        "betweenStreet2": "PICO",
        "corner": "",
        "placeType": "",
        "place": "",
        "placeReference": "",
        "numberAlternativeAddresses": "0",
        "alternativeAddresses": [],
        "merlinCustomValues": [
            {
                "name": "level4Longitude",
                "value": "-58.446264"
            },
            {
                "name": "postalCertifiedAddresses",
                "value": "SI"
            },
            {
                "name": "level4Latitude",
                "value": "-34.614420"
            },
            {
                "name": "nise",
                "value": "9"
            },
            {
                "name": "merlinRiskArea",
                "value": "N"
            }
        "clientCustomValues": []
   }
}