Documentación API AddressWorld

Funciones

Búsqueda Directa (Individual)

Búsqueda Masiva

:logo-adw:Volver al sitio web

Descripción:

El servicio de Búsqueda de Direcciones de AddressWorld permite validar, estructurar y georreferenciar direcciones en Chile con alta precisión, reduciendo significativamente los errores de localización que afectan los procesos de última milla. A través de una API de consulta, la plataforma entrega resultados estructurados, coordenadas exactas y metadatos que facilitan la toma de decisiones logísticas.

• Consulta Masiva: Diseñada para procesar grandes volúmenes de direcciones de forma periódica o bajo demanda. Puede recibir consultas por lotes desde 20 direcciones o más en una sola solicitud. Se utiliza en reprocesos o procesos de backoffice asíncronos, como limpieza de bases históricas, carga inicial de clientes o auditorías de calidad de datos.

Beneficios:

• Mejora significativa en la calidad de la georreferenciación y reducción de errores en la última milla.
• Normalización y estructuración de direcciones en componentes estándar (calle, número, comuna, etc.).
• Aumenta la eficiencia operativa al evitar reprocesos, entregas fallidas y desvíos.
• Flexibilidad para integrarse con sistemas existentes mediante API o procesos batch.

Ventajas comparativas:

• Optimizado para la realidad territorial de Chile, incluyendo zonas rurales y cambios administrativos.
• Motor de búsqueda propio, con interpretación contextual y mejoras continuas a partir del uso.
• Tiempos de respuesta bajos y trazabilidad de cada resultado, con indicadores de calidad.
• Soporte técnico local, con opciones de personalización según las necesidades del cliente.

Funcionamiento :

El servicio masivo recibe un lote con múltiples direcciones y las analiza para poder:

• Parsear: identificar y estructurar los distintos componentes de la dirección
• Formatear: Estructura los datos de la dirección de manera estandarizada
• Normalizar: corrige nombres de calle y niveles administrativos, para utilizar un mismo valor en todos los casos
• Geocodificar: posiciona la dirección a través de coordenadas de latitud y longitud
• Enriquecer: completa y agrega datos adicionales de la dirección que no necesariamente incluye el dato de entrada
• Validar: entrega una clasificación del resultado que permite identificar la confianza del dato y completitud de la dirección

⚡Inicio rápido:

Para usar este servicio es necesario realizar una autenticación previa con la API deCrear un token (Login), utilizando las credenciales asociadas a tu cuenta. Una vez obtenido el bearer token, si tienes dudas sobre cómo usarlo en cada servicio, puedes consultar el API Reference respectivo.

Pasos:

1. Se envía lote con direcciones.
2. Se consulta estado de avance con endpoint de Status.
3. Una vez esté en estado finalizado, se descargan resultados con endpoint Download.

API Reference:

Create Batch Geocoder v3

Create Batch Geocoder v2

Status Batch Geocoder

Download Batch Geocoder

Consulta Búsqueda Masiva:

El archivo CSV de entrada debe contener los siguientes datos:

• Datos y Parámetros de entrada - Consulta Masiva

Respuesta Búsqueda Masiva:

• Datos y Parámetros de salida - Consulta Masiva

Descripción valores de la Respuesta:

• Valores parámetro DIR_CAT_DETECTED(v3) / TIPO DE DIRECCION(v1 y v2)

• Valores parámetro MATCHTYPE (v3)

• Valores parámetro MATCHTYPE (v1 y v2)

Límites:

El servicio de Búsqueda Masiva permite buscar en lotes. Cada lote deberá ser de mínimo 20 y de máximo 5.000 direcciones de forma simultánea. En caso de requerir aumentar el límite, favor contactar con tu ejecutivo comercial.