Accetta indirizzo. Esempi

Questo documento descrive una serie di scenari reali in cui l'API Address Validation fornisce indicatori di risposta che garantiscono un comportamento di accettazione da parte del sistema. Per informazioni contestuali, consulta la sezione Panoramica del flusso di lavoro in Utilizzare la risposta di convalida.

Esempio comune: accept

Questo scenario illustra un indirizzo in cui il tuo sistema accetterà un indirizzo inserito da un cliente.

Indirizzo inserito Regione
76 Buckingham Palace Road, London SW1W 9TQ Regno Unito

Giudizio per un indirizzo accettabile

L'esempio seguente evidenzia gli indicatori importanti.

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

Inoltre, la risposta indica quanto segue:

  • hasUnconfirmedComponents rimane false
  • hasInferredComponents rimane false
  • hasReplacedComponents rimane false

Se combinati, questi indicatori indicano un indirizzo di alta qualità.

Esempi di casi limite: accetta

Gli esempi riportati di seguito riguardano situazioni in cui il codice verdict indica problemi di qualità degli indirizzi che richiedono ulteriori accertamenti. Questi esempi illustrano anche come la logica può passare dal verdetto ai componenti dell'indirizzo per ottenere un quadro più completo al fine di migliorare la logica di sistema.

Numero civico non verificato al di fuori degli Stati Uniti

Questo esempio mostra l'inserimento di un indirizzo italiano con tutti i componenti presenti, senza componenti dedotti o sostituiti. Tuttavia, il valore di validationGranularity è ROUTE.

Indirizzo inserito Regione
Via Fonte Grugnale, 14 unità 2, 66054 Vasto CH, Italia IT

Giudizio per un numero civico non confermato

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

Ulteriori indagini sui componenti dell'indirizzo rivelano che il numero civico è UNCONFIRMED_BUT_PLAUSIBLE.

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

Numero civico non confermato degli Stati Uniti

Questo esempio mostra l'inserimento di un indirizzo degli Stati Uniti con tutti i componenti dell'indirizzo presenti, senza componenti dedotti o sostituiti. Tuttavia, il valore di validationGranularity è PREMISE_PROXIMITY.

Indirizzo inserito Regione
975 Carson Dr, Sunnyvale, CA 94086 US

Dati USPS per un numero civico non confermato

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

Dati USPS incompleti per un indirizzo confermato

Questo esempio mostra l'inserimento di un indirizzo degli Stati Uniti con tutti i componenti confermati, senza componenti dedotti o sostituiti e un valore validationGranularity di PREMISE. Tuttavia, uspsData non è completamente compilato e non contiene un valore dpvConfirmation.

Indirizzo inserito Regione
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 US

Giudizio per un indirizzo confermato con dati USPS incompleti

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

Dati USPS per un indirizzo confermato con dati USPS incompleti

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