En este documento, se describen varias situaciones reales en las que la API de Address Validation proporciona indicadores de respuesta que garantizan un comportamiento de aceptación por parte de tu sistema. Consulta la Descripción general del flujo de trabajo en Usa la respuesta de validación para conocer el contexto.
Ejemplo común: aceptar
En esta situación, se ilustra una dirección en la que tu sistema aceptará una dirección ingresada por un cliente.
Dirección ingresada | Región |
---|---|
76 Buckingham Palace Road, Londres SW1W 9TQ | Reino Unido |
Veredicto sobre una dirección aceptable
En el siguiente ejemplo, se destacan los indicadores importantes.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
Además, la respuesta indicará lo siguiente:
hasUnconfirmedComponents
sigue siendofalse
hasInferredComponents
sigue siendofalse
hasReplacedComponents
sigue siendofalse
Cuando se combinan, estos indicadores indican una dirección de alta calidad.
Ejemplos de casos extremos: aceptar
En los siguientes ejemplos, se abarcan situaciones en las que el verdict
indica que abordan problemas de calidad que justifican una mayor investigación. 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 del sistema.
Número de calle sin confirmar que no es de EE.UU.
En este ejemplo, se muestra la entrada de una dirección italiana con todos los componentes de dirección presentes, sin componentes inferidos ni reemplazados. Sin embargo, el validationGranularity
es ROUTE
.
Dirección ingresada | Región |
---|---|
Via Fonte Grugnale, 14 unit 2, 66054 VASTo CH, Italia | IT |
Veredicto de 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 número de la calle es UNCONFIRMED_BUT_PLAUSIBLE
.
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Número de calle no confirmado de EE.UU.
En este ejemplo, se muestra la entrada de una dirección de EE.UU. con todos los componentes de 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 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 o reemplazados, y una validationGranularity
de PREMISE
. Sin embargo, el campo uspsData
no está completamente propagado y no contiene un valor dpvConfirmation
.
Dirección ingresada | Región |
---|---|
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 | EE.UU. |
Veredicto 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"
}