Riferimento rapido all'API Address Validation

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

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à addressComplete viene 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à addressComplete mancante come false o verifica la presenza della proprietà. Consulta la pagina /maps/documentation/address-validation/understand-response.
  • Problema: se regionCode viene omesso, l'API deduce la regione dall'indirizzo, il che può fornire risultati meno precisi. Correzione: includi regionCode in PostalAddress quando lo conosci. Consulta /maps/documentation/address-validation/requests-validate-address.
  • Problema: Non è garantito che l'oggetto uspsData sia completamente popolato per ogni indirizzo statunitense convalidato. Correzione: non fare affidamento su uspsData come 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 provideValidationFeedback deve fare riferimento a responseId della prima chiamata validateAddress della sequenza, non a una successiva. Correzione: memorizza il responseId della prima risposta validateAddress e 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.