Questo documento descrive una procedura per creare un sistema di controllo degli indirizzi per gestire una varietà di risposte dall'API Address Validation. Spiega come crea la tua logica per utilizzare correttamente la risposta, per analizzare altri indicatori dall'API e su quando e come richiedere maggiori informazioni ai clienti.
In generale, la risposta dell'API determina i seguenti modi in cui il sistema dovrebbe gestire un indirizzo:
- Correggi: l'indirizzo è di bassa qualità. Dovresti richiedere ulteriori informazioni.
- Conferma: l'indirizzo è di alta qualità, ma presenta cambia dall'indirizzo di input. Potresti richiedere conferma.
- Accetta: l'indirizzo è di alta qualità. Puoi accetta l'indirizzo fornito.
Scopo principale
Questo documento ti aiuta a modificare il tuo sistema per analizzare al meglio la risposta dell'API e determinare le azioni successive da intraprendere con gli indirizzi forniti. Le seguenti pseudocodice illustra un possibile flusso.
if (the API response indicates significant problems in the address)
FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
CONFIRM - confirm with the user that the address is correct
else
ACCEPT - continue with the address returned by the API.
La logica esatta dipende dalla situazione. Consulta la guida all'implementazione. per ulteriori informazioni. Puoi anche usare la nostra implementazione open source di questa logica, che si trova nella Libreria dei componenti estesi.
Panoramica del flusso di lavoro
La tabella seguente riassume due azioni per il tuo sistema:
- Il flusso di lavoro da utilizzare in base al comportamento di correzione, conferma e accettazione.
- I primi indicatori da verificare dalla risposta. Indicatori
descritti qui provengono dalla proprietà
verdict
e non sono l'unico indicatori da controllare, ma forniscono un indicatore iniziale dell'indirizzo qualità. Ogni tipo di comportamento corrisponde a una sezione di questo documento descrivendo ulteriori segnali che potresti dover indagare.
Comportamento del sistema | |||
---|---|---|---|
Correggere l'indirizzo |
La risposta da
|
||
Conferma l'indirizzo |
La risposta da
|
||
Accetta l'indirizzo |
La risposta dell'API Address Validation indica un indirizzo di qualità eccellente.
|
Linee guida per l'implementazione
Durante la progettazione del modo in cui il sistema reagisce agli indicatori dell'API Address Validation, i seguenti consigli possono aiutarti a creare una risposta più efficace un modello di machine learning. Tuttavia, si tratta solo di consigli, quindi tieni presente che dovrebbe essere adatta al tuo modello di business.
Consulenza | Dettagli | |
---|---|---|
Livello di rischio |
Prendi in considerazione il livello di tolleranza per la tua situazione nell'equilibrio tra richieste correzioni e accettando l'indirizzo inserito. |
L'API Address Validation restituisce vari indicatori che puoi incorporare con il tuo livello di rischio per ottimizzare la tua convalida e il processo di sviluppo. Ad esempio, se un indirizzo ha un numero civico non confermato, puoi la accettano comunque. Se invece le operazioni aziendali richiedono una maggiore precisione degli indirizzi, Ad esempio, potrebbero rientrare in entrambe le categorie. Consulta Numero civico non statunitense non confermato in Accetta indirizzo - esempi. |
Accetta indirizzi |
È buona norma consentire al sistema di accettare la voce originale se il cliente non risponde ai prompt. |
In questi casi, il cliente potrebbe aver inserito un indirizzo non per le nuove costruzioni. |
Invia il tuo feedback |
Quando emetti una richiesta di convalida dell'indirizzo, puoi:
invia una richiesta anche all'endpoint |
In questo modo Google saprà come hai gestito la risposta finale. Vedi Gestire gli indirizzi aggiornati. |
Correggere un indirizzo
Correggi un indirizzo quando i risultati indicano chiaramente che non è il prodotto finale. Il sistema può quindi chiedere al cliente di fornire i dati informazioni, dopodiché emetti il flusso di lavoro per ottenere .
Correggi indicatori
L'API Address Validation fornisce una serie di indicatori che ti consentono di sapere se un di destinazione deve essere corretto.
1. Granularità della convalida e componenti mancanti
Questi due segnali forniscono la migliore indicazione di un indirizzo problematico:
- Ogni volta che il campo
validationGranularity
èOTHER
, il sistema deve analizza gli indicatori dei componenti dell'indirizzo per scoprire dove si trova l'errore e come correggerlo. - Ogni volta che l'oggetto
address
post-elaborato restituisce unmissingComponentTypes
, il sistema deve verificare questo componente. Inoltre, l'assenza di componenti rendono un indirizzo incompleto e non recapitabile.
2. Altri indicatori
L'API Address Validation fornisce anche gli altri indicatori per diagnosticare problemi specifici:
Componenti sospetti | Quando l'enumerazione a livello di conferma di un componente è
UNCOMFIRMED_AND_SUSPICIOUS , è probabile che il componente sia
risposta errata.
|
---|---|
Componente non risolto | Un unresolvedToken è una parte dell'input non riconosciuta come parte valida di un indirizzo. |
3. Indicatori per gli indirizzi negli Stati Uniti
Alcuni campi applicabili solo agli indirizzi USA forniscono un indicatore utile del fatto che non è idoneo per la consegna e deve essere corretto. Per un indirizzo che richiede corretto, dovresti vedere quanto segue:
dpvConfirmation
|
N , D o vuoto.
|
---|
Per maggiori dettagli su dpvConfirmation
, vedi
Gestire gli indirizzi degli Stati Uniti.
Correggere esempi di indirizzi
Conferma un indirizzo
Confermi un indirizzo quando l'esito indica che l'API Address Validation dedotto o apportato modifiche ai componenti per produrre un valido. In questi casi, hai un indirizzo di consegna, ma preferisci con maggiore sicurezza che l'indirizzo risultante sia quello previsto al cliente.
Per fornire al cliente i prompt corretti, la tua logica identificherà
i componenti segnalati dal servizio per determinare quale azione o segnalare l'API
applicata al componente, come inferred
, replaced
o spellCorrected
.
Vedi AddressComponent nel riferimento.
Conferma indicatori
L'API Address Validation fornisce una serie di indicatori che ti consentono di sapere se un dell'indirizzo email deve essere confermato.
1. Granularità della convalida
Un valore validationGranularity
di ROUTE
o superiore è accettabile, ma
PREMISE o SUBPREMISE fornisce un segnale più forte della possibilità di recapito.
2. Altri indicatori
Quando si decide di confermare l'inserimento dell'indirizzo con il cliente, l'esito anche fornisce quanto segue per stabilire quali componenti esaminare:
Dati dedotti | Quando il campo hasInferredComponents è true ,
sai che l'API ha compilato informazioni raccolte da altri indirizzi
componenti.
|
---|---|
Dati sostituiti | Quando il campo hasReplacedComponents è true , il valore
L'API ha sostituito i dati inseriti con dati ritenuti validi per l'indirizzo.
|
3. Indicatori per gli indirizzi negli Stati Uniti
Alcuni campi applicabili solo agli indirizzi negli Stati Uniti indicano che la logica deve verificare i dettagli con il cliente. Si applica una delle seguenti condizioni:
dpvConfirmation
|
S
Per maggiori dettagli su |
---|---|
Risposta all'indirizzo | Contiene il campo missingComponentType con il valore di
subpremise .
|
Esempi di verifica dell'indirizzo
Accetta un indirizzo
Accetti un indirizzo quando l'esito dà un elevato grado di certezza che L'indirizzo deve essere fornito e può essere utilizzato senza ulteriori interazioni con il cliente nel processo downstream.
Accetta indicatori
L'API Address Validation fornisce una serie di indicatori che ti consentono di sapere se un dell'indirizzo email deve essere confermato.
1. Granularità della convalida
Un valore validationGranularity
pari o superiore a PREMISE
è accettabile, ma in alcune
casi, ROUTE
indica comunque un indirizzo di consegna.
2. Altri indicatori
Un esito relativo a un indirizzo di alta qualità dovrebbe anche fornire quanto segue:
- Nessun dato sostituito. In questo caso,
hasReplacedComponents: FALSE
. - Nessun componente dedotto. In questo caso,
hasInferredComponents: FALSE
.
3. Indicatori per gli indirizzi negli Stati Uniti
Alcuni campi applicabili solo agli indirizzi negli Stati Uniti indicano un indirizzo di alta qualità a cui è possibile recapitarli. Per un indirizzo statunitense accettabile, dovresti vedere il seguenti:
dpvConfirmation
|
Y
Per maggiori dettagli su |
---|