L'API Address Validation accetta un indirizzo, ne identifica i componenti e li convalida, standardizza l'indirizzo per l'invio per posta e restituisce le coordinate di latitudine/longitudine più conosciute. Per gli indirizzi degli Stati Uniti e di Portorico, puoi attivare facoltativamente l'elaborazione USPS CASS.
API Address Validation: informazioni chiave
- Prodotto: API Address Validation
- Categoria: Luoghi
- Piattaforma: servizio web (REST)
- Esecuzione su: server (codice di backend)
- Fase di lancio: GA
- Ciclo di vita: Attivo
- Panoramica: panoramica dell'API Address Validation
- Disponibilità regionale: limitata. I paesi supportati e la qualità dei dati variano in base al paese e alcuni paesi sono in anteprima. I metadati residenziali e commerciali vengono restituiti solo per i paesi contrassegnati nella pagina di copertura. USPS CASS è supportato solo per gli Stati Uniti e Portorico. (dettagli sulla copertura)
API Address Validation: quando utilizzarla
Utilizza l'API Address Validation quando:
- Devi verificare se un indirizzo si riferisce a un luogo reale e trovare i componenti mancanti o eventualmente errati.
- Devi standardizzare e completare un indirizzo per l'invio per posta, ad esempio durante un flusso di checkout.
- Per gli indirizzi negli Stati Uniti o a Portorico, è necessaria la convalida certificata CASS di USPS e
uspsData. - Devi disporre dei metadati dell'indirizzo residenziale o commerciale per un paese elencato nella pagina di copertura.
Non utilizzare l'API Address Validation quando:
- Devi solo convertire un indirizzo in latitudine/longitudine e non devi convalidare i singoli componenti dell'indirizzo. Utilizza invece l'API Geocoding.
- Hai bisogno di dettagli sulla destinazione iperlocali, come gli ingressi degli edifici, i contorni degli edifici o i punti di navigazione. Utilizza invece l'API Geocoding.
API Address Validation: configurazione
- Servizio da attivare:
addressvalidation.googleapis.com - Autenticazione: chiave API, OAuth 2.0, service account
- Inizia: configura l'API Address Validation
- Riferimento: Riferimento API Address Validation
- Prezzi: Utilizzo e fatturazione dell'API Address Validation
- Note di rilascio: note di rilascio dell'API Address Validation
Pacchetti ufficiali dell'API Address Validation:
- npm:
@googlemaps/addressvalidation - pypi:
google-maps-addressvalidation - go:
cloud.google.com/go/maps
API Address Validation: errori comuni
- Problema: la proprietà
addressCompleteviene omessa dall'esito quando il suo valore èfalse, pertanto il codice che prevede la presenza del campo può interpretare erroneamente gli indirizzi incompleti. Correzione: tratta una proprietàaddressCompletemancante comefalseo verifica la presenza della proprietà. Consulta la pagina /maps/documentation/address-validation/understand-response. - Problema: se
regionCodeviene omesso, l'API deduce la regione dall'indirizzo, il che può fornire risultati meno precisi. Correzione: includiregionCodeinPostalAddressquando lo conosci. Consulta /maps/documentation/address-validation/requests-validate-address. - Problema: Non è garantito che l'oggetto
uspsDatasia completamente popolato per ogni indirizzo statunitense convalidato. Correzione: non fare affidamento suuspsDatacome unico indicatore di convalida; utilizza anche l'esito e i componenti dell'indirizzo. Consulta /maps/documentation/address-validation/handle-us-address. - Problema: il feedback inviato con
provideValidationFeedbackdeve fare riferimento aresponseIddella prima chiamatavalidateAddressdella sequenza, non a una successiva. Correzione: memorizza ilresponseIddella prima rispostavalidateAddresse invialo nella richiesta di feedback. Consulta /maps/documentation/address-validation/handle-updated-address.
Cosa puoi fare con l'API Address Validation
Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.
- Restituisce un indirizzo convalidato per un indirizzo o un indirizzo parziale specificato.
- Restituisce le coordinate di latitudine/longitudine di un indirizzo convalidato.
- Restituisce l'identificatore di luogo di Google per un indirizzo convalidato.
- Utilizza la certificazione CASS (Coding Accuracy Support System) di United States Postal Service (USPS) per la convalida degli indirizzi.
- Restituisce informazioni sul fatto che un indirizzo convalidato sia un'attività, una residenza o una casella postale.
- Restituisce i metadati di consegna dello United States Postal Service (USPS) per un indirizzo convalidato.
- Restituisce una versione in lingua inglese di un indirizzo convalidato. Anteprima
- Restituisce il Plus Code di un indirizzo convalidato.