Guida alla soluzione di convalida degli indirizzi

Diagramma di flusso che mostra la panoramica generale dei passaggi di test.

Obiettivo

Address Validation offre valore per una serie di casi d'uso e ci sono considerazioni chiave oltre alla qualità dei risultati dei test che ti suggeriamo di esplorare. Ad esempio: una visione olistica dei prodotti compatibili in un flusso utente come Place Autocomplete e Maps, disponibilità regionale e affidabilità e fiducia aziendali.

Una volta arrivato al punto di valutare l'API Address Validation, ecco alcune linee guida che ti consigliamo di utilizzare nell'ambito dei test.

Gli obiettivi di questo test saranno:

  1. Verifica che l'API Address Validation sia adatta al tuo caso d'uso.
  2. Verifica in che modo l'API Address Validation soddisfa i requisiti delle tue soluzioni, ad esempio:
    • Identificare indirizzi di buona qualità.
    • Avvisi per risolvere i problemi relativi agli input di scarsa qualità.
    • Apportare correzioni ai dati degli indirizzi, tra cui inferenze, sostituzioni e correzioni ortografiche.
    • Fornire un indirizzo formattato per la spedizione.
    • Avvisi relativi a dati di subpremise mancanti o errati (solo Stati Uniti).
  3. Assicurati di ottenere un vantaggio misurabile dall'implementazione dell'API.

Dopo aver eseguito il test, potrai rispondere alle domande precedenti e determinare se l'API è adatta alla tua attività.

Preparare i dati

Il test deve essere eseguito su un campione dei dati degli indirizzi esistenti. Non selezionare i dati per il test, ma scegli campioni casuali che siano rappresentativi delle aree geografiche in cui operi. Ciò significa che, se operi sia negli Stati Uniti sia nel Regno Unito, ma il 70% della tua attività viene svolta nel Regno Unito rispetto al 30% negli Stati Uniti, il campione deve riflettere questa suddivisione.

Utilizza gli indirizzi dal punto di acquisizione. Ad esempio, se prevedi di implementare la convalida degli indirizzi nel processo di pagamento del tuo e-commerce, utilizza gli indirizzi inseriti dai clienti nel modulo, prima di qualsiasi elaborazione esistente che potrebbe essere sostituita dall'implementazione dell'API Address Validation.

Prepara un campione di circa 5000-10.000 record per il test.

Chiama l'API

Prerequisito della sezione: scopri come inviare una richiesta di Address Validation.

Una volta preparati i dati, dovrai eseguire ogni record di indirizzo con l'API.

Per istruzioni su come chiamare l'API, consulta la documentazione dell'API Address Validation. Abbiamo anche un articolo che descrive le best practice per l'utilizzo dell'API Address Validation per l'elaborazione di indirizzi in volumi elevati.

Il risultato di questo passaggio dovrebbe essere l'output dei dati dall'API per ogni record di indirizzo. Potrai quindi analizzare i risultati per determinare l'idoneità dell'API per il tuo caso d'uso. La scelta di utilizzare un foglio di lavoro, un database o un altro strumento spetta a te.

Esaminare i risultati

Prerequisito della sezione: scopri come gestire la risposta di convalida, in particolare i concetti di correzione, conferma e accettazione.

In questa sezione parleremo degli scenari di output che puoi analizzare per valutare l'idoneità della soluzione.

Panoramica dei campi API chiave discussi in questo documento

Dati di risposta

Che cos'è?

Come valutare

In che modo può essere utile?

verdict.inputGranularity

Descrive la granularità di input dell'indirizzo.

SUB_PREMISE

PREMESSA

PREMISE_PROXIMITY

BLOCCA

ROUTE

ALTRO

Consente di determinare se l'indirizzo inserito contiene dati sufficienti per essere potenzialmente valido.

verdict.validationGranularity

Descrive la convalida complessiva dell'output dell'indirizzo.

SUB_PREMISE

PREMESSA

PREMISE_PROXIMITY

BLOCCA

ROUTE

ALTRO

Consente di determinare la qualità complessiva dell'indirizzo nell'output dell'API.

verdict.hasInferredComponents

Indica se l'API ha dedotto un componente.

Vero/Falso

L'API è in grado di aggiungere i componenti mancanti laddove può dedurre i dati. Ad esempio, un codice stato mancante.

verdict.hasReplacedComponents

Indica se l'API ha sostituito un componente.

Vero/Falso

In alcuni scenari, l'API è in grado di sostituire i componenti errati con i dati corretti.

verdict.addressComplete

Indica se l'indirizzo è completo.

Vero/Falso

Se l'API determina che l'indirizzo di output contiene tutti i componenti necessari, questo valore sarà true.

address.missingComponentTypes

Indicatore che segnala se nell'indirizzo mancano dei componenti.

Consulta la tabella due per i valori.

Evidenzia i componenti mancanti di un indirizzo incompleto.

Esamina gli indirizzi validi

Ordina i dati restituiti dall'API per determinare l'insieme di indirizzi che il tuo sistema accetterebbe come validi. Gli indicatori principali da cercare nell'API sono:

  • verdict.validationGranularity contiene PREMISE o un valore superiore.
  • verdict.addressComplete è true.
  • Nessun componente dedotto o sostituito.

Per saperne di più, consulta Accetta un indirizzo.

L'output di questo esercizio deve essere un sottoinsieme dei dati degli indirizzi che verrebbero accettati come validi dal tuo sistema. A questo punto, puoi determinare:

  • La percentuale di accettazione è accettabile?
  • Se utilizzi un workflow di Address Validation esistente, il tasso di accettazione è equivalente o migliore?

Esempio: indirizzo valido

Indirizzo inserito

Regione

76 Buckingham Palace Road, London SW1W 9TQ, Regno Unito

Regno Unito

Verdict

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

Esamina gli indirizzi non validi

Questo passaggio è un'opportunità per esaminare manualmente alcuni dei dati degli indirizzi contrassegnati come non validi e verificare se, senza utilizzare l'API Address Validation, l'indirizzo non valido potrebbe causare problemi a valle.

Ordina i dati restituiti dall'API per determinare l'insieme di indirizzi che il tuo sistema contrassegnerebbe come non validi. Gli indicatori principali da cercare nell'API sono:

  • verdict.validationGranularity impostato su OTHER o ROUTE a seconda del tuo livello di rischio.
  • verdict.addressComplete è false.

Per saperne di più, consulta Correggi un indirizzo.

L'output di questo esercizio deve essere un sottoinsieme dei dati degli indirizzi che verrebbero contrassegnati come non validi dal tuo sistema. A questo punto, puoi determinare se la percentuale di annullamento convalida è accettabile.

È importante notare che contrassegnare gli indirizzi come non validi è una funzionalità fondamentale dell'API Address Validation e un tasso elevato di indirizzi contrassegnati come non validi non riflette necessariamente un problema dell'API. L'API ti informa che c'è un problema con l'indirizzo, il che potrebbe migliorare l'efficienza del tuo flusso di lavoro rilevando gli errori in anticipo, prima che causino problemi a valle.

Esempio: indirizzo non valido

Indirizzo inserito

Regione

21 45 40th street

USA

Verdict

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Esamina i componenti mancanti o non confermati

In questa fase, è anche possibile esaminare i componenti mancanti o non confermati. Questo fa parte dell'oggetto Address nella risposta. I due campi sono missingComponentTypes e unconfirmedComponentTypes.

Utilizza questi campi per rilevare il motivo per cui un indirizzo è contrassegnato come non valido dall'API e raccogliere le informazioni corrette per l'indirizzo che lo renderebbero valido, inviando al punto di raccolta dei dati i campi specifici non corretti. In questo modo, l'API fornisce valore fornendoti informazioni specifiche sulla qualità dei tuoi dati.

Esempio: componente mancante e non confermato

Indirizzo inserito

Regione

Fake St, New York, NY 10011

USA

Verdict

{
     "inputGranularity": "ROUTE",
     "validationGranularity": "OTHER",
     "geocodeGranularity": "OTHER",
     "hasUnconfirmedComponents": true
}

Componenti mancanti e non confermati

"missingComponentTypes": [
    "street_number"
],
"unconfirmedComponentTypes": [
    "route"
]

Esamina gli indirizzi con correzioni

L'API Address Validation è in grado di apportare correzioni ai dati di input, prendendo un indirizzo potenzialmente non valido e restituendo dati di indirizzo validi. Questo è uno dei modi in cui l'API aggiunge valore ed è importante acquisirlo nell'ambito del test.

Gli indicatori principali da cercare sono:

  • inferred, replaced o spellCorrected impostato su true in uno dei addressComponents.
  • verdict.hasInferredComponents o verdict.hasReplacedComponents impostato su true.

Per saperne di più, consulta Conferma un indirizzo.

L'output di questo esercizio deve essere un sottoinsieme dei dati degli indirizzi a cui è stata applicata una correzione dall'API.

Una parte di questi dati può essere esaminata manualmente per determinare se l'API sta apportando correzioni ai dati che ridurrebbero gli attriti nel workflow downstream.

Esempio: indirizzo con una correzione

Indirizzo inserito

Regione

76 Bruckingm Palace Road, London SW1W 9TQ

Regno Unito

Route addressComponent

{
    "componentName": {
        "text": "Buckingham Palace Road",
        "languageCode": "en"
    },
    "componentType": "route",
    "confirmationLevel": "CONFIRMED",
    "spellCorrected": true
}

[Solo USA] Controlla l'indirizzo con dati di subpremise mancanti o errati

L'API Address Validation è in grado di determinare se un'unità secondaria è mancante o errata per gli indirizzi degli Stati Uniti.

Gli indicatori principali da cercare sono:

  • Nell'oggetto Address:
    • unconfirmedComponentTypes contiene subpremise
    • missingComponentTypes contiene subpremise
  • Nell'oggetto UspsData:
    • dpvConfirmation è D (manca il numero civico)
    • dpvConfirmation è S (subpremise non confermata)

Per ulteriori informazioni, consulta la sezione Gestire gli indirizzi degli Stati Uniti.

Questo test mostrerà se nei tuoi dati sono presenti problemi relativi a numeri di unità secondarie mancanti o errati, ad esempio i numeri degli appartamenti. Ciò può causare problemi a valle, soprattutto per i casi d'uso di consegna. L'API Address Validation può aggiungere valore aggiunto al tuo flusso di lavoro identificando questo problema in anticipo, consentendoti di implementare passaggi per raccogliere dati corretti.

Esempio: numero civico mancante

Indirizzo inserito

Regione

111 8th Avenue, Manhattan, NY 10011, USA

US

Componente mancante

"missingComponentTypes": [
    "subpremise"
]

Conferma DPV dei dati USPS

"dpvConfirmation": "D"

[Solo USA] Esamina l'indirizzo standardizzato USPS

L'API Address Validation restituisce anche l'indirizzo standardizzato USPS per gli indirizzi degli Stati Uniti. Questo è particolarmente importante se hai bisogno che gli indirizzi formattati secondo lo standard USPS vengano stampati sulle etichette di spedizione.

Puoi esaminare UspsAddress per visualizzare questi dati e determinare se aggiungono valore al tuo flusso di lavoro.

Esempio: indirizzo standardizzato USPS

"standardizedAddress": {
    "firstAddressLine": "111 8TH AVE FL 11",
    "cityStateZipAddressLine": "NEW YORK NY 10011-5201",
    "city": "NEW YORK",
    "state": "NY",
    "zipCode": "10011",
    "zipCodeExtension": "5201"
}

Conclusione

Inizia i test: inizia oggi stesso a testare l'API Address Validation per garantire dati degli indirizzi accurati, migliorare la customer experience e semplificare le operazioni aziendali. Dopo aver seguito gli scenari di test descritti sopra, avrai le informazioni necessarie per determinare se l'API Address Validation apporterà valore al tuo flusso di lavoro.

Letture consigliate per approfondire:

Collaboratori

Henrik Valve | DevX Engineer