Scegli una soluzione di convalida dell'indirizzo

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à grezza 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 attendibilità 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. Confermare che l'API Address Validation è adatta al tuo caso d'uso.
  2. Verificare in che modo l'API Address Validation soddisfa i requisiti delle tue soluzioni, ad esempio:
    • Identificare indirizzi di buona qualità.
    • Avvisare degli indirizzi di input di scarsa qualità.
    • Apportare correzioni ai dati degli indirizzi, incluse inferenze, sostituzioni e correzioni ortografiche.
    • Fornire un indirizzo formattato per la spedizione.
    • Avvisare dei dati di subpremessa mancanti o errati (solo Stati Uniti).
  3. Assicurarsi 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 scegli campioni casuali 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 svolto 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 dell'e-commerce, utilizza gli indirizzi inseriti dai clienti nel modulo, prima che venga eseguita l'elaborazione esistente che potrebbe essere sostituita dall'implementazione dell'API Address Validation.

Prepara una dimensione del campione di circa 5000-10.000 record per il test.

Chiama l'API

Prerequisito della sezione: comprendere come inviare una richiesta di convalida dell'indirizzo .

Dopo aver preparato i dati, dovrai eseguire ogni record di indirizzo rispetto all'API.

Per indicazioni 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 in grandi volumi.

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 al tuo caso d'uso. Se utilizzi un foglio di lavoro, un database o un altro strumento, dipende da te.

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 parleremo degli 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à di input dell'indirizzo.

SUB_PREMISE

PREMISE

PREMISE_PROXIMITY

BLOCK

ROUTE

OTHER

Ti consente di determinare se l'indirizzo di input contiene dati sufficienti per essere potenzialmente valido.

verdict.validationGranularity

Descrive la convalida complessiva dell'output dell'indirizzo.

SUB_PREMISE

PREMISE

PREMISE_PROXIMITY

BLOCK

ROUTE

OTHER

Ti 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 quando 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 per avvisare se l'indirizzo contiene componenti mancanti.

Consulta la tabella due per i valori.

Evidenzia i componenti mancanti di un indirizzo incompleto.

Esaminare gli indirizzi validi

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

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

Per saperne di più, consulta Accettare un indirizzo.

L'output di questo esercizio dovrebbe essere un sottoinsieme dei dati degli indirizzi che il tuo sistema accetterebbe come validi. A questo punto, puoi determinare:

  • La percentuale di accettazione è accettabile?
  • Se utilizzi un workflow di convalida dell'indirizzo esistente, la percentuale 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 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 chiave 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 Correggere un indirizzo.

L'output di questo esercizio dovrebbe essere un sottoinsieme dei dati degli indirizzi che il tuo sistema contrassegnerebbe come non validi. A questo punto, puoi determinare se la percentuale di non validità è accettabile.

È importante notare che contrassegnare gli indirizzi come non validi è una funzionalità fondamentale dell'API Address Validation e un'alta percentuale di indirizzi contrassegnati come non validi non riflette necessariamente in modo negativo sull'API. L'API ti fornisce informazioni che indicano che c'è qualcosa di sbagliato nell'indirizzo e questo potrebbe migliorare l'efficienza del tuo workflow 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 valore restituito. 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 ne consentirebbe la validità, fornendo al punto di raccolta dei dati i campi specifici errati. 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

Esito

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

Componenti mancanti e non confermati

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

Esaminare gli indirizzi con correzioni

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

Gli indicatori chiave da cercare sono:

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

Per saperne di più, consulta Confermare un indirizzo.

L'output di questo esercizio dovrebbe essere un sottoinsieme dei dati degli indirizzi a cui l'API ha applicato una correzione.

Una parte di questi dati può essere esaminata manualmente per determinare se l'API sta apportando correzioni ai tuoi dati che ridurrebbero l'attrito nel tuo workflow a valle.

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] Esaminare l'indirizzo con dati di subpremessa mancanti o errati

L'API Address Validation è in grado di determinare se una subpremessa è mancante o errata per gli indirizzi statunitensi.

Gli indicatori chiave da cercare sono:

  • Nell'oggetto Address:
    • unconfirmedComponentTypes contiene subpremise
    • missingComponentTypes contiene subpremise
  • Nell'oggetto UspsData:
    • dpvConfirmation è D (subpremessa mancante)
    • dpvConfirmation è S (subpremessa non confermata)

Per saperne di più, consulta Gestire gli indirizzi degli Stati Uniti.

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

Esempio: subpremessa mancante

Indirizzo inserito

Regione

111 8th Avenue, Manhattan, NY 10011

USA

Componente mancante

"missingComponentTypes": [
    "subpremise"
]

Conferma DPV dei dati USPS

"dpvConfirmation": "D"

[Solo Stati Uniti] Esaminare l'indirizzo standardizzato USPS

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

È possibile esaminare UspsAddress per visualizzare questi dati e determinare se aggiungono valore al tuo workflow.

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 il test: inizia oggi stesso a testare l'API Address Validation per garantire dati degli indirizzi precisi, migliorare l'esperienza dei clienti 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 workflow.

Letture consigliate:

Collaboratori

Henrik Valve | DevX Engineer