Detalle de la API

Para poder utilizar esta API se debe realizar una llamada con un metodo GET conformándose por:

Endpoint: https://cont1-virtual1.certisend.com/web/container/api/v1/database/data/ar/georef/address

Parámetros:

• token-susc: Token obtenido al momento de la suscripción a nivel empresa.
• token-api: Token obtenido al momento de la suscripción a nivel API.
• address: Nombre completo o parte del nombre de la dirección y el número (Obligatorio).
  
• province: Provincia donde se encuentra la dirección de la consulta.
• department: Departamento donde se encuentra la dirección de la consulta.
• census_location: Nombre de la localidad censal.
• locality: Localidad donde se encuentra la dirección de la consulta.
• internalid: Parámetro opcional en donde se puede enviar un id interno para su identificación por parte del cliente.
  
  

La llamada quedaría de la siguiente manera:
https://cont1-virtual1.certisend.com/web/container/api/v1/database/data/ar/georef/address?token-susc=TOKENSUSC&token-api=TOKENAPI&address=Urquiza%20400&province=Santa%20Fe&department=Rosario&census_location=Granadero%20Baigorria&locality=Granadero%20Baigorria&internalid=47

Una vez realizada la llamada van a recibir los siguientes parámetros:

• state: Tendrá el valor 0 para un parámetro faltante o dirección no encontrada y un 1 en el caso de que se encuentre información.
• data: Conjunto de información recibida.
  • quantity: Cantidad de resultados encontrados.
  • addresses: Información correspondiente a las direcciones encontradas.
    • altura: Punto específico en la calle encontrada.
      • unidad: Unidad de medida usada en caso de ser necesario.
      • valor: Valor numérico que determina la altura.
    • calle: Datos de la calle encontrada.
      
      • categoria: Clasificación de la calle encontrada.
      • id: ID único de la calle encontrada.
      • nombre: Nombre de la calle encontrada.
    • calle_cruce_1: Datos de la primer intersección cercana a la dirección consultada.
    • calle_cruce_2: Datos de la segunda intersección cercana a la dirección consultada.
  • department: Datos del departamento correspondiente a la dirección encontrada.
    • id: ID único del departamento.
    • nombre: Nombre del departamento.
  • localidad_censal: Datos de la localidad censal correspondiente a la dirección encontrada.
    • id: ID único de la localidad censal.
    • nombre: Nombre de la localidad censal.
  • nomenclatura: Dirección completa compuesta por su nombre, número de la calle, departamento y provincia.
  • piso: Especifica el piso de la dirección en caso de que esté registrada con uno.
  • provincia: Datos de la provincia correspondiente a la dirección encontrada.
    • id: ID único de la provincia.
    • nombre: Nombre de la provincia.
  • ubicacion: Datos de la ubicación correspondiente a la dirección encontrada.
    • lat: Latitud de la ubicación.
    • lon: Longitud de la ubicación.
• parameters: Parámetros ingresados en la consulta.
  • departamento: Departamento ingresado en la consulta (department).
  • direccion: Dirección ingresada en la consulta (address).
  • localidad: Localidad ingresada en la consulta (locality).
  • localidad_censal: Localidad censal ingresada en la consulta (census_location).
  • provincia: Provincia ingresada en la consulta (province).
• amount: Total de resultados encontrados.
• internalid: Id interno ingresado por el cliente.
  
  

Respuestas de Ejemplo:

Negativa:

{"state":"0","desc":"address not found.","internalid":"0"}

Positiva:

{"state":"1","data":[{"quantity":1,"addresses":[{"altura":{"unidad":null,"valor":400},"calle":{"categoria":"CALLE","id":"8208416001280","nombre":"URQUIZA"},"calle_cruce_1":{"categoria":null,"id":null,"nombre":null},"calle_cruce_2":{"categoria":null,"id":null,"nombre":null},"departamento":{"id":"82084","nombre":"Rosario"},"localidad_censal":{"id":"82084160","nombre":"Granadero Baigorria"},"nomenclatura":"URQUIZA 400, Rosario, Santa Fe","piso":null,"provincia":{"id":"82","nombre":"Santa Fe"},"ubicacion":{"lat":-32.8551530494615,"lon":-60.6976005574218}}],"start":0,"parameters":{"departamento":"Rosario","direccion":{"altura":{"unidad":null,"valor":"400"},"calles":["Urquiza"],"piso":null,"tipo":"simple"},"localidad":"Granadero Baigorria","localidad_censal":"Granadero Baigorria","provincia":"Santa Fe"},"amount":1}],"internalid":"5"}

Se encuentra a disposición para consultar la documentación técnica, revisar los parámetros de entrada/salida y evaluar las respuestas de la api accediendo a nuestro API-Doc. Así mismo si se registra gratuitamente en nuestro sistema, puede acceder a generar sus Token de Prueba e ingresar a nuestro portal API-Test

Definición Técnica de la API: