Obiettivo
In qualità di sviluppatore, spesso lavori con set di dati contenenti indirizzi dei clienti che potrebbero non essere di buona qualità. Devi assicurarti che gli indirizzi siano corretti per casi d'uso che vanno dalla verifica dell'ID cliente alla consegna e altro ancora.
La sezione Address Validation API è un prodotto di Google Maps Platform che puoi utilizzare per convalidare un indirizzo. Tuttavia, elabora un indirizzo alla volta. In questo documento, vedremo come utilizzare High Volume Address Validation in diversi scenari, dai test delle API fino alla convalida degli indirizzi una tantum e ricorrente.
Casi d'uso
Ora conosceremo i casi d'uso in cui viene utilizzata la validazione degli indirizzi a volume elevato utile.
Test
Spesso conviene testare l'API Address Validation eseguendo migliaia di indirizzi IP esterni. Gli indirizzi potrebbero essere contenuti in un file di valori separati da virgole e per convalidare la qualità degli indirizzi.
Convalida una tantum degli indirizzi
Durante l'onboarding per l'API Address Validation, vuoi convalidare il tuo il database di indirizzi esistente rispetto al database degli utenti.
Convalida ricorrente degli indirizzi
Vari scenari richiedono la convalida degli indirizzi su base ricorrente:
- Potresti aver pianificato job per convalidare gli indirizzi per i dettagli acquisiti durante la giornata, ad esempio in base alle registrazioni dei clienti, ai dettagli degli ordini, alle le pianificazioni degli annunci.
- Potresti ricevere dump di dati contenenti indirizzi di diversi reparti, ad esempio, dalle vendite al marketing. Il nuovo reparto che riceve di destinazione spesso vogliono convalidarli prima dell'utilizzo.
- Potresti raccogliere indirizzi durante sondaggi, varie promozioni e in un secondo momento all'aggiornamento nel sistema online. Vuoi verificare che gli indirizzi siano corretti durante l'inserimento nel sistema.
Approfondimento tecnico
Ai fini del presente documento, si suppone che:
- Stai chiamando l'API Address Validation con gli indirizzi di un cliente (ad es. un database con i dettagli del cliente)
- Puoi memorizzare nella cache i flag di validità in corrispondenza di singoli indirizzi nel tuo database.
- I flag di validità vengono recuperati dall'API Address Validation quando il singolo cliente esegue l'accesso.
Cache per uso in produzione
Quando utilizzi l'API Address Validation, spesso vuoi memorizzare nella cache parte la risposta dalla chiamata API. Anche se i nostri Termini di Limite di servizio quali dati possono essere memorizzati nella cache, qualsiasi dato che può essere memorizzato nella cache dall'API Address Validation devono essere memorizzate nella cache per un account utente. Ciò significa che nel database, l'indirizzo o i metadati dell'indirizzo devono essere memorizzati nella cache in base all'indirizzo email o all'indirizzo e un altro ID principale.
Per il caso d'uso di High Volume Address Validation, la memorizzazione nella cache dei dati deve seguire le Specifico del servizio dell'API Address Validation Termini, descritto nella Sezione 11.3. In base a queste informazioni, sarai in grado di determinare se l'indirizzo di un utente può non essere valido; in questo caso visualizzerai un messaggio all'utente per un indirizzo corretto alla sua successiva interazione con il tuo un'applicazione.
- Dati da AddressComponent
oggetto
confirmationLevel
inferred
spellCorrected
replaced
unexpected
Se vuoi memorizzare nella cache informazioni sull'indirizzo effettivo, questi dati Deve essere memorizzata nella cache solo con il consenso dell'utente. Ciò garantisce che l'utente stia bene consapevoli del motivo per cui un particolare servizio memorizza il proprio indirizzo e sono d'accordo con termini di condivisione del proprio indirizzo.
Un esempio di consenso dell'utente potrebbe essere l'interazione diretta con un indirizzo e-commerce in una pagina di pagamento. Tieni presente che memorizzarai nella cache elaborare l'indirizzo per la spedizione di un pacco.
Con il consenso dell'utente, puoi memorizzare nella cache formattedAddress
e altri componenti chiave
dalla risposta. Tuttavia, in uno scenario headless, un utente non può fornire
dato che la convalida dell'indirizzo avviene dal backend. Pertanto,
puoi memorizzare nella cache informazioni
molto limitate in questo scenario headless.
Comprendere la risposta
Se la risposta dell'API Address Validation contiene i seguenti indicatori, puoi avere la certezza che l'indirizzo di input sia di qualità idonea:
- L'indicatore
addressComplete
nel Esito ètrue
, validationGranularity
nel Esito l'oggetto èPREMISE
oSUB_PREMISE
- Nessun elemento AddressComponent
sono contrassegnate come:
Inferred
(nota: inferred=true
che si verifica quandoaddressComplete=true
)spellCorrected
replaced
unexpected
e
confirmationLevel
: Il livello di conferma nella AddressComponent è impostato suCONFIRMED
oUNCONFIRMED_BUT_PLAUSIBLE
Se la risposta dell'API non contiene gli indicatori sopra indicati, l'indirizzo di input era probabilmente di scarsa qualità e puoi memorizzare nella cache i flag del database per quello. I flag memorizzati nella cache indicano che l'indirizzo nel suo complesso è di scarsa qualità, mentre le segnalazioni più dettagliate, come Ortografia corretta, indicano il tipo specifico risolvere problemi di qualità. Alla successiva interazione del cliente con un indirizzo segnalato di qualità scadente puoi chiamare l'API Address Validation con lo stato . L'API Address Validation restituirà l'indirizzo corretto che hai possono essere visualizzati usando un prompt dell'interfaccia utente. Dopo che il cliente accetta l'indirizzo formattato puoi memorizzare nella cache i seguenti elementi della risposta:
formattedAddress
postalAddress
addressComponent componentNames
oUspsData standardizedAddress
Implementare una convalida degli indirizzi headless
In base alla discussione sopra riportata:
- Spesso è necessario memorizzare nella cache parte della risposta dall'indirizzo API Validation per motivi aziendali.
- Tuttavia, i Termini di Service in Google Maps Platform limita i dati che possono essere memorizzati nella cache.
Nella sezione che segue, illustreremo una procedura in due fasi che spiega come conformarsi ai Termini di servizio e implementare la convalida degli indirizzi per volumi elevati.
Passaggio 1:
Nel primo passaggio vedremo come implementare un indirizzo ad alto volume script di convalida da una pipeline di dati esistente. Questa procedura ti consentirà di archiviare campi specifici dalla risposta dell'API Address Validation in Termini di nel rispetto del servizio.
Diagramma A: il seguente diagramma mostra come migliorare una pipeline di dati con una logica di convalida degli indirizzi a volume elevato.
In base ai Termini di servizio, puoi memorizzare nella cache i seguenti dati dal
addressComponent
:
confirmationLevel
inferred
spellCorrected
replaced
unexpected
Pertanto, durante questa fase dell'implementazione, memorizzeremo nella cache rispetto allo UserID.
Per ulteriori informazioni, consulta i dettagli sui dati effettivi dei dati.
Passaggio 2:
Nel passaggio 1, abbiamo raccolto un feedback secondo cui alcuni indirizzi nel set di dati di input potrebbero non essere di alta qualità. Nel passaggio successivo, prenderemo questi indirizzi segnalati e di presentarli all'utente e ottenere il loro consenso per correggere .
Diagramma B: questo diagramma mostra come un'integrazione end-to-end dell'utente flusso di consenso potrebbe essere simile a:
- Quando l'utente esegue l'accesso, controlla innanzitutto se hai memorizzato eventuali flag di convalida nella cache nel tuo sistema.
- Se sono presenti segnalazioni, è necessario presentare all'utente un'interfaccia utente per correggere aggiornare il proprio indirizzo.
- Puoi chiamare di nuovo l'API Address Validation con di destinazione e presenta l'indirizzo corretto all'utente per confermare.
- Se l'indirizzo è di buona qualità, l'API Address Validation restituisce un
formattedAddress
. - Puoi presentare tale indirizzo all'utente se sono state o accettare in silenzio se non ci sono correzioni.
- Quando l'utente accetta, puoi memorizzare nella cache
formattedAddress
nel database.
Conclusione
High Volume Address Validation è un caso d’uso comune che probabilmente incontrerai in molte applicazioni. Questo documento si propone di illustrare alcuni scenari modello di progettazione su come implementare una soluzione del genere conforme a Google Maps Termini di servizio della piattaforma.
Abbiamo inoltre scritto un'implementazione di riferimento per gli indirizzi ad alto volume Convalida come libreria open source su GitHub. Dai un'occhiata per iniziare creare rapidamente con la Convalida degli indirizzi a volume elevato. Leggi anche l'articolo su schemi di progettazione su come usare la libreria in diversi scenari.
Passaggi successivi
Scarica la sezione Migliora pagamento, consegna e operazioni con indirizzi affidabili Whitepaper e consulta la sezione Miglioramento di pagamento, consegna e operazioni con l'indirizzo Convalida Webinar.
Ulteriori letture suggerite:
- Applications of High Volume Address Validation
- Libreria Python su GitHub
- Esplora la demo di Address Convalida
Collaboratori
Google gestisce questo articolo. L'ha scritto in origine i seguenti collaboratori.
Autori principali:
Henrik Valve | Solutions Engineer
Thomas Anglaret | Soluzioni
Ingegnere
Sarthak Ganguly | Soluzioni
Ingegnere