Los servicios de dirección de DQE validan, normalizan y enriquecen direcciones postales en tiempo real. Este artículo describe cada servicio de dirección y lo que devuelve.
DQE ofrece dos conjuntos de endpoints de API de dirección con funcionalidad equivalente:
- Legacy WS — los endpoints originales de estilo WS, todavía totalmente compatibles.
- RESTful — los nuevos endpoints REST, recomendados para nuevas integraciones.
Validación de dirección
La validación de dirección comprueba si una dirección enviada puede reconocerse, normalizarse y evaluarse frente a los datos de referencia disponibles para el país correspondiente. DQE ofrece varios endpoints de validación:
-
CheckAddress — valida una dirección completa y devuelve un formato postal normalizado con un indicador de entregabilidad. Para direcciones francesas, DQE se basa en los datos de referencia de La Poste (RNVP — Rectification et Normalisation des adresses en Vue de la Poste).
Legacy WS:/RNVP/— RESTful:/{VERSION}/checkaddress/
Para direcciones internacionales, el nivel de precisión varía según el país y la cobertura disponible.
Autocompletado de dirección
El autocompletado de dirección sugiere y completa direcciones mientras el usuario escribe, reduciendo los errores de entrada en origen. Está diseñado para usarse en campos de formulario en tiempo real.
-
Modo embudo (funnel) — guía al usuario paso a paso: código postal → calle → complemento.
Legacy WS:/CP/→/ADR/→/COMPL/— RESTful:/{VERSION}/funnelpostcode/→/{VERSION}/funneladdress/→/{VERSION}/funnelcompl/ -
Modo único (single) — devuelve sugerencias a partir de una entrada de texto completo, seguida de un paso de complemento para detalles de edificio o apartamento.
Legacy WS:/SINGLEV2/→/COMPLV2/— RESTful:/{VERSION}/single/→/{VERSION}/compl/
Geocodificación
La geocodificación devuelve coordenadas geográficas (latitud y longitud) para una dirección dada. El nivel de precisión depende de los datos de referencia disponibles:
- Precisión a nivel de calle cuando se reconoce la dirección completa
- Precisión a nivel de ciudad cuando no se puede localizar la calle
- No se devuelven coordenadas cuando la dirección no puede geolocalizarse
Legacy WS: /LATLG/
Geocodificación inversa
La geocodificación inversa devuelve información de dirección a partir de un conjunto de coordenadas geográficas. Es útil para enriquecer datos de ubicación cuando dispone de coordenadas pero no de una dirección postal.
Legacy WS: /SINGLE/ (con parámetros lat/lng)
Formato de respuesta
Todos los servicios de dirección devuelven las respuestas en formato JSON, incluidos los componentes de dirección normalizados y los indicadores de calidad que describen el nivel de validación alcanzado.
Artículos relacionados
- ¿Cómo valida DQE las direcciones postales?
- ¿Por qué DQE normaliza una dirección de forma diferente a la esperada?
- ¿Por qué DQE no devuelve una dirección?
Relacionada con