Aceptar dirección: ejemplos

En este documento, se describen varios casos prácticos en los que la API de Address Validation proporciona indicadores de respuesta que justifican un comportamiento de aceptación por parte de tu sistema. Consulta los flujos de trabajo de ejemplo en Crea tu lógica de validación para obtener contexto.

Ejemplo común: Aceptar

En este caso, se ilustra una dirección en la que tu sistema aceptaría una dirección ingresada por un cliente.

Dirección ingresada Región
76 Buckingham Palace Road, Londres SW1W 9TQ Reino Unido

Verificación de una dirección aceptable

En el siguiente ejemplo, se destacan los indicadores importantes.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

Además de esto, la respuesta indica lo siguiente:

  • hasUnconfirmedComponents sigue siendo false
  • hasInferredComponents sigue siendo false
  • hasReplacedComponents sigue siendo false
  • hasSpellCorrectedComponents sigue siendo false

Cuando se combinan, estos indicadores señalan una dirección de alta calidad.

Ejemplos de casos extremos: Aceptar

En los siguientes ejemplos, se abarcan situaciones en las que verdict indica problemas de calidad de la dirección que justifican una investigación más a fondo. Estos ejemplos también ilustran cómo tu lógica puede viajar desde el veredicto hasta los componentes de la dirección para obtener un panorama más completo y, así, mejorar la lógica del sistema.

Número de la calle sin confirmar que no es de EE.UU.

En este ejemplo, se ilustra el ingreso de una dirección italiana con todos los componentes presentes, sin componentes inferidos ni reemplazados. Sin embargo, el validationGranularity es ROUTE.

Dirección ingresada Región
Via Fonte Grugnale, 14, unidad 2, 66054 Vasto CH, Italia TI

Verificación de un número de calle no confirmado

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

Una investigación más profunda de los componentes de la dirección revela que el número de la calle es UNCONFIRMED_BUT_PLAUSIBLE.

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

Número de la calle de EE.UU. sin confirmar

En este ejemplo, se ilustra el ingreso de una dirección de EE.UU. con todos los componentes de la dirección presentes, sin componentes inferidos ni reemplazados. Sin embargo, el validationGranularity es PREMISE_PROXIMITY.

Dirección ingresada Región
975 Carson Dr, Sunnyvale, CA 94086 EE.UU.

Datos del USPS para un número de calle no confirmado

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

Datos incompletos del USPS para una dirección confirmada

En este ejemplo, se ilustra el ingreso de una dirección de EE.UU. con todos los componentes de la dirección confirmados, sin componentes inferidos ni reemplazados, y un validationGranularity de PREMISE. Sin embargo, el campo uspsData no está completamente completado y no contiene un valor de dpvConfirmation.

Dirección ingresada Región
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 EE.UU.

Verificación de una dirección confirmada con datos incompletos del USPS

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true,
}

Datos del USPS para una dirección confirmada con datos incompletos del USPS

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}