Scegli una soluzione di convalida dell'indirizzo

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

Obiettivo

La convalida degli indirizzi offre valore per una serie di casi d'uso e ci sono considerazioni chiave da esplorare oltre alla qualità grezza dei risultati dei test. Ad esempio: una visione olistica dei prodotti compatibili in un flusso utente come Place Autocomplete e Maps, disponibilità regionale e affidabilità e fiducia aziendale.

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à.
    • Avviso per risolvere i problemi relativi agli input di indirizzi di scarsa qualità.
    • Apportare correzioni ai dati dell'indirizzo, incluse inferenze, sostituzioni e correzioni ortografiche.
    • Fornire un indirizzo formattato per la spedizione.
    • Avvisi relativi a dati di sottopremessa mancanti o errati (solo Stati Uniti).
  3. Assicurati di ricevere 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 scegliere manualmente i dati per il test, ma seleziona campioni casuali che siano rappresentativi delle aree geografiche in cui operi. Ciò significa che, se operi sia negli Stati Uniti che 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 dell'indirizzo nel checkout 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 convalida dell'indirizzo.

Una volta preparati i dati, devi eseguire ogni record di indirizzo rispetto all'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 elaborare indirizzi ad alto volume.

Il risultato di questo passaggio dovrebbe essere l'output dei dati dell'API per ogni record di indirizzo. Potrai quindi analizzare i risultati per determinare l'idoneità dell'API per il tuo caso d'uso. Se utilizzi un foglio di lavoro, un database o un altro strumento, la scelta è tua.

Esaminare i risultati

Prerequisito della sezione: comprendere come gestire la risposta di convalida, in particolare il concetto di correzione, conferma e accettazione.

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

Panoramica dei campi API chiave trattati in questo documento

Dati di risposta

Di cosa si tratta?

Come valutare

In che modo è utile?

verdict.inputGranularity

Descrive la granularità dell'input dell'indirizzo.

SUB_PREMISE

PREMESSA

PREMISE_PROXIMITY

BLOCCA

ROUTE

ALTRO

Consente di determinare se l'indirizzo inserito dispone di 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

Segnale per avvisare se nell'indirizzo mancano componenti.

Consulta la tabella 2 per i valori.

Evidenzia i componenti mancanti di un indirizzo incompleto.

Rivedere 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 versioni successive.
  • verdict.addressComplete è true.
  • Nessun componente dedotto o sostituito.

Per ulteriori informazioni, vedi Accettare un indirizzo.

Il risultato di questo esercizio deve essere un sottoinsieme dei dati degli indirizzi che sarebbero accettati come validi dal tuo sistema. A questo punto, puoi determinare:

  • La percentuale di accettazione è accettabile?
  • Se utilizzi un flusso di lavoro di convalida degli indirizzi esistente, il tasso di accettazione è equivalente o migliore?

Esempio: indirizzo valido

Indirizzo inserito

Regione

76 Buckingham Palace Road, London SW1W 9TQ

Regno Unito

Esito

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

Esaminare gli indirizzi non validi

Questo passaggio è un'opportunità per esaminare manualmente alcuni dei dati degli indirizzi che sono stati 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 ulteriori informazioni, consulta Correggere 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 il tasso percentuale non valido è accettabile.

È importante notare che contrassegnare gli indirizzi come non validi è una funzionalità di base dell'API Address Validation e un tasso elevato di indirizzi contrassegnati come non validi non riflette necessariamente in modo negativo sull'API. L'API ti fornisce informazioni che indicano che l'indirizzo presenta un problema, 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

Esito

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

Esaminare i componenti mancanti o non confermati

In questa fase è possibile esaminare anche i componenti mancanti o non confermati. Fa parte dell'oggetto Address nel reso. I due campi sono missingComponentTypes e unconfirmedComponentTypes.

Utilizza questi campi per rilevare il motivo per cui un indirizzo viene contrassegnato come non valido dall'API e raccogli le informazioni corrette per l'indirizzo che consentirebbero di renderlo valido, fornendo un feedback al punto di raccolta dei dati sui campi specifici errati. Questo è un modo in cui l'API fornisce valore fornendo informazioni specifiche sulla qualità dei tuoi dati.

Esempio: componente mancante e non confermato

Indirizzo inserito

Regione

Fake St, New York, NY 10011

USA

Esito

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

Componenti mancanti e non confermati

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

Controllare gli indirizzi con correzioni

L'API Address Validation è in grado di apportare correzioni ai dati di input, prendendo un input di indirizzo potenzialmente non valido e restituendo dati di indirizzo validi. Questo è uno dei modi in cui l'API aggiunge valore ed è importante acquisire questo aspetto 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 Confermare un indirizzo.

Il risultato 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 tuoi dati che ridurrebbero gli attriti nel flusso di lavoro 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 Stati Uniti] Controllare l'indirizzo con dati di unità secondaria mancanti o errati

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

Gli indicatori principali da cercare sono:

  • Nell'oggetto Indirizzo:
    • unconfirmedComponentTypes contiene subpremise
    • missingComponentTypes contiene subpremise
  • Nell'oggetto UspsData:
    • dpvConfirmation è D (sottoindirizzo mancante)
    • dpvConfirmation è S (sottopremessa non confermata)

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

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

Esempio: Missing subpremise

Indirizzo inserito

Regione

111 8th Avenue, Manhattan, NY 10011

US

Componente mancante

"missingComponentTypes": [
    "subpremise"
]

Conferma DPV dei dati USPS

"dpvConfirmation": "D"

[Solo Stati Uniti] Esamina standardizedAddress USPS

L'API Address Validation restituisce anche l'indirizzo standardizzato USPS per gli indirizzi negli Stati Uniti. Ciò è particolarmente importante se richiedi che gli indirizzi in formato USPS vengano stampati sulle etichette di spedizione.

UspsAddress può essere esaminato 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 a eseguire i test: inizia oggi stesso a testare l'API Address Validation per assicurarti dati degli indirizzi accurati, migliorare la customer experience e semplificare le operazioni della tua attività. 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:

Collaboratori

Henrik Valve | DevX Engineer