Aceptar dirección: ejemplos

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

Ejemplo común: Accept

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

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

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 de esto, la respuesta indica lo siguiente:

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

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 verdict indica dirección problemas de calidad que justifiquen una investigación más profunda. Estos ejemplos también ilustrar 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 fuera de EE.UU.

Este ejemplo ilustra la entrada de una dirección italiana con todos los componentes de la dirección. y que no haya 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

Veredicto por un número de calle sin confirmar

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

Una mayor investigación de los componentes de la dirección revela que la calle el número es UNCONFIRMED_BUT_PLAUSIBLE.

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

Número de calle no confirmado de EE.UU.

Este ejemplo ilustra la entrada de una dirección de EE.UU. con todos los componentes de dirección. sin que se infieran ni reemplacen componentes. 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 sin confirmar

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

Este ejemplo ilustra la entrada de una dirección de EE.UU. con todos los componentes de dirección. confirmado, sin componentes inferidos o reemplazados, y un validationGranularity de PREMISE. Sin embargo, la 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 correspondientes a 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"
}