Aceptar dirección: ejemplos

En este documento, se describen varias situaciones del mundo real en las que la API de Address Validation proporciona indicadores de respuesta que justifican un comportamiento de aceptación de tu sistema. Consulta la Descripción general del flujo de trabajo en Usa la respuesta de validación para obtener contexto.

Ejemplo común: aceptar

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

Veredicto para una dirección aceptable

En el siguiente ejemplo, se destacan los indicadores importantes.

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

Además, el verdict indica lo siguiente:

• hasUnconfirmedComponents sigue siendo false
• hasInferredComponents sigue siendo false
• hasReplacedComponents 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 el campo verdict indica problemas de calidad de la dirección que requieren una investigación más detallada. 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 mejorar la lógica de tu sistema.

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

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

Veredicto para un número de calle no confirmado

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

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

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

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

En este ejemplo, se ilustra la entrada 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.

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 del USPS incompletos para una dirección confirmada

En este ejemplo, se ilustra la entrada de una dirección de EE.UU. con todos los componentes de dirección confirmados, sin componentes inferidos ni reemplazados, y un validationGranularity de PREMISE. Sin embargo, el uspsData no se propaga por completo y no contiene un valor dpvConfirmation.

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

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

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

{
  "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"
}