Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Sviluppatori dello Spazio economico europeo (SEE)
Introduzione
L'API Address Validation è un servizio che accetta un indirizzo.
Identifica i componenti dell'indirizzo e li convalida. Inoltre, standardizza l'indirizzo per l'invio per posta e trova le coordinate di latitudine/longitudine più conosciute.
Se vuoi, per gli indirizzi negli Stati Uniti e a Portorico, puoi attivare
il Coding Accuracy Support System (CASS™).
Perché utilizzare l'API Address Validation
Con l'API Address Validation, puoi migliorare la prevedibilità della consegna e ridurre
gli errori di consegna, offrendo così una migliore customer experience. In questo modo
puoi individuare gli indirizzi errati e ottenere una migliore consapevolezza delle caratteristiche
degli indirizzi.
L'API Geocoding potrebbe essere più adatta alle tue esigenze se
non devi convalidare i singoli componenti dell'indirizzo. L'API Geocoding
converte gli indirizzi in coordinate di latitudine e longitudine. L'API
Address Validation convalida gli indirizzi per verificarne la correttezza. Per un confronto dettagliato, consulta la sezione
Creare una funzionalità di convalida della posizione dell'edificio utilizzando Google Maps Platform
nel Centro architettura.
Con l'API Address Validation, puoi determinare se un indirizzo
si riferisce a un luogo reale. Se l'indirizzo non si riferisce a un luogo reale, l'API può identificare componenti potenzialmente errati che puoi presentare ai tuoi clienti per la correzione. Ecco un flusso di lavoro di esempio che utilizza l'API:
Il cliente inserisce un indirizzo: l'immagine seguente mostra un modulo di base
che consente a un cliente di inserire un indirizzo, possibilmente nell'ambito di un flusso di pagamento.
L'app invia l'indirizzo all'API: l'applicazione passa questo indirizzo
come input all'API Address Validation.
L'API convalida e standardizza l'indirizzo: nella risposta, l'API
Address Validation restituisce l'indirizzo completo determinato dall'API oppure
indica dove mancano informazioni.
Il cliente conferma o corregge l'indirizzo: a seconda
di ciò che restituisce l'API, puoi fornire al cliente i seguenti prompt:
A. Conferma l'indirizzo consigliato. B. Fornisci le informazioni mancanti.
C. Correggi l'indirizzo.
Come funziona l'API Address Validation
La convalida dell'indirizzo accetta una richiesta POST con l'indirizzo sotto forma di corpo JSON. Separa l'indirizzo nei suoi singoli componenti e
poi tenta le seguenti operazioni:
Correzioni: fornisce controlli di convalida a livello di componente, inclusi
i locali secondari, se disponibili.
Completa: tenta di dedurre i componenti dell'indirizzo mancanti o errati.
Formati: pulisce e standardizza il formato dei componenti dell'indirizzo.
Risorse
Nella tabella seguente sono riepilogate le risorse disponibili tramite l'API Address Validation insieme ai dati che restituisce. Per dettagli specifici, consulta il
Riferimento API Address Validation.
Esplora la demo
con una serie di moduli di indirizzo, sia corretti che errati.
La demo offre un modo utile per esplorare sia i valori restituiti dal servizio sia la risposta dell'API in formato JSON.
2
Controllare la copertura
Consulta i dettagli della copertura
per scoprire quali paesi e regioni sono supportati dall'API Address Validation.
Inizia con un indirizzo di base e poi, per una maggiore precisione, puoi
attivare CASS (solo per indirizzi di Stati Uniti e Porto Rico). Consulta Richiedere una convalida dell'indirizzo.
5
Elaborare una risposta
La risposta dell'API Address Validation fornisce due proprietà, ognuna delle quali
utilizzi in modi diversi.
Consulta Comprendere una risposta di base.
6
Migliorare l'accuratezza della convalida
Puoi contribuire a migliorare l'accuratezza degli indirizzi fornendo feedback sulle
risposte dell'API Address Validation. Consulta Gestire gli indirizzi aggiornati.
Librerie client disponibili
Per un elenco delle librerie client disponibili per l'API Address Validation, consulta
Librerie client.
Informazioni su CASS™
United States Postal Service® (USPS®)1 utilizza il
Coding Accuracy Support System (CASS™)
per supportare e certificare i fornitori di convalida degli indirizzi. Un servizio con certificazione CASS™,
come l'API Address Validation, è stato confermato per la sua
capacità di compilare le informazioni mancanti in un indirizzo, standardizzarlo e
aggiornarlo per fornirti l'indirizzo più attuale e preciso.
CASS non è attivato per impostazione predefinita ed è supportato solo per le regioni "US" e "PR". Per attivare CASS, imposta enableUspsCass su true nell'ambito di una richiesta di convalida. Per ulteriori informazioni, vedi
Convalidare un indirizzo.
Nell'ambito del nostro utilizzo dei servizi USPS, USPS valuta le richieste di indirizzi creati artificialmente. Se l'USPS identifica un indirizzo inserito come creato artificialmente, Google è tenuta a interrompere la convalida degli indirizzi per il cliente e deve comunicare all'USPS i dati di contatto del cliente (nome e indirizzo), l'indirizzo inserito pertinente e i dati di utilizzo aggregati. Utilizzando l'API, acconsenti
a questi
Termini di servizio specifici.
Google Maps Platform è un licenziatario non esclusivo di United States
Postal Service®. I seguenti marchi sono di proprietà di United States
Postal Service® e vengono utilizzati dietro autorizzazione: United States Postal Service®,
CASS™, CASS Certified™. ↩
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-31 UTC."],[[["\u003cp\u003eThe Address Validation API validates, standardizes, and geocodes addresses, improving delivery predictability and customer experience.\u003c/p\u003e\n"],["\u003cp\u003eIt identifies address components, validates them for correctness, and provides suggestions for corrections, unlike the Geocoding API, which only converts addresses to coordinates.\u003c/p\u003e\n"],["\u003cp\u003eAddresses are processed by correcting, completing, and formatting components, with CASS™ support for US and Puerto Rico addresses for enhanced accuracy (requires enabling).\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can access resources like a demo, coverage details, setup instructions, validation requests, response understanding, and client libraries to utilize the API effectively.\u003c/p\u003e\n"],["\u003cp\u003eUSPS evaluates requests for artificially created addresses, and Google is obligated to stop validation and report relevant information to USPS in such cases.\u003c/p\u003e\n"]]],["The Address Validation API validates and standardizes addresses, identifying components and correcting errors. It can infer missing information, and determine if an address is a real place. The API accepts an address, validates it, and returns a complete address or flags missing information. Users can confirm, correct, or provide missing details. For US and Puerto Rico addresses, CASS can be enabled for enhanced accuracy. The Geocoding API may be preferred if address component validation is not needed.\n"],null,["**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq). \n\nIntroduction The Address Validation API is a service that accepts an address. It identifies address components and validates them. It also standardizes the address for mailing and finds the best known latitude/longitude coordinates for it. Optionally, for addresses in the United States and Puerto Rico, you can enable the [Coding Accuracy Support System (CASS™)](https://developers.google.com/maps/documentation/address-validation/overview#about-cass).\n\nWhy use the Address Validation API\n\nWith the Address Validation API, you can improve delivery predictability and reduce\ndelivery failures, thereby providing improved customer experience. You do this\nby catching bad addresses and obtaining better awareness of address\ncharacteristics.\n\nThe Geocoding API might be a better match for your needs if you\ndon't need to validate the individual address components. The Geocoding API\n**converts** addresses into latitude and longitude coordinates. The\nAddress Validation API validates addresses for **correctness** . See\n[Building location validation capability using Google Maps Platform](https://developers.google.com/maps/architecture/geocoding-address-validation)\nin the Architecture Center for a detailed comparison.\n\nWhat you can do with the Address Validation API\n\n[inputTry the demo](/maps/documentation/address-validation/demo) [](/maps/documentation/address-validation/demo)\n\nWith the Address Validation API, you can determine if an address\nrefers to a real place. If the address does not refer to a real\nplace, the API can identify possibly wrong components that you can present to\nyour customers to correct. Here is a sample workflow using the API:\n\n1. **Customer enters an address** -- The following image shows a basic form\n that allows a customer to enter an address, possibly as part of a checkout\n flow.\n\n2. **App sends the address to the API** -- The application passes this address\n as the input to the Address Validation API.\n\n3. **API validates and standardizes the address** -- In its response, the\n Address Validation API returns the complete address as determined by the API, or\n indicates where information is missing.\n\n4. **Customer confirms or corrects the address** -- Depending on\n what the API returns, you can provide the following prompts to the customer:\n **A.** Confirm the recommended address. **B.** Provide missing information.\n **C.** Fix the address.\n\nHow the Address Validation API works\n\nThe address validation accepts a POST request with the address in the form\nof a JSON body. It separates the address into its individual components, and\nthen attempts the following:\n\n- **Corrects**---Provides component-level validation checks, including sub-premises where available.\n- **Completes**---Attempts to infer missing or incorrect address components.\n- **Formats**---Cleans up and standardizes the format for address components.\n\nResources\n\nThe following table summarizes the resources available through the\nAddress Validation API along with the data it returns. For specific details, see the\n[Address Validation API reference](./reference/rest).\n\n\u003cbr /\u003e\n\n| Data resources | Data returned |\n|-------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Address components in JSON format.** See [Validate an address](/maps/documentation/address-validation/requests-validate-address). | Complete, validated address (if possible). Validation status of each address component. Where available for an address: - Geocode - Address precision - Postal services data, where available. See [Understand the validation response](/maps/documentation/address-validation/understand-response). |\n\n\u003cbr /\u003e\n\nHow to use the Address Validation API\n\n|---|-----------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Try the demo** | [Explore the demo](/maps/documentation/address-validation/demo) with a variety of address forms, both correct and incorrect. The demo provides a useful way to explore both the return values from the service, as well as the JSON formatted API response. |\n| 2 | **Check coverage** | Review [coverage details](/maps/documentation/address-validation/coverage) to see which countries and regions the Address Validation API supports. |\n| 3 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/address-validation/cloud-setup) and complete the instructions that follow. |\n| 4 | **Request an address validation** | Start with a basic address and then, for additional accuracy, you can enable CASS (for US and PR addresses only). See [Request an address validation.](/maps/documentation/address-validation/requests-validate-address) |\n| 5 | **Process a response** | The Address Validation API response provides two properties, each of which you use in different ways. See [Understand a basic response.](/maps/documentation/address-validation/understand-response) |\n| 6 | **Improve validation accuracy** | You can help improve address accuracy by providing feedback on Address Validation API responses. See [Handle updated addresses](/maps/documentation/address-validation/handle-updated-address). |\n\nAvailable client libraries\n\nFor a list of the available client libraries for Address Validation API,\nsee\n[Client libraries](/maps/documentation/address-validation/client_libraries).\n\nAbout CASS™\n\nThe United States Postal Service® (USPS®)^[1](#fn1)^ maintains the\n[Coding Accuracy Support System (CASS™)](https://postalpro.usps.com/certifications/cass)\nto support and certify address validation providers. A CASS Certified™ service,\nsuch as the Address Validation API, has been confirmed for its\nability to fill in information missing from an address, standardize it, and\nupdate it to give you the most current and most accurate address.\n\nCASS is not enabled by default and is only supported for the \"US\" and \"PR\"\nregions. To enable CASS, set `enableUspsCass` to `true` as part of a validation\nrequest. For more information, see\n[Validate an address](/maps/documentation/address-validation/requests-validate-address#enable-cass).\n\nAs part of our use of USPS services, USPS evaluates requests for artificially\ncreated addresses. If USPS identifies an input address as being artificially\ncreated, Google is required to stop validating addresses for the customer and\nmust report the customer's contact information (name and address), the relevant\ninput address, and aggregated usage data to USPS. By using the API you consent\nto these\n[Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms).\n\nWhat's next\n\n- **Try the demo** : Go to [Demo](/maps/documentation/address-validation/demo)\n- **Review coverage areas** : Go to [Country and region coverage details](/maps/documentation/address-validation/coverage)\n- **Try your first validation request** : Go to [Send an address validation request](/maps/documentation/address-validation/requests-validate-address)\n- **Process addresses at high volume** : Go to [Use Address Validation API to process addresses at high volume](/maps/architecture/high-volume-address-validation)\n\n*** ** * ** ***\n\n1. Google Maps Platform is a non-exclusive Licensee of the United States\n Postal Service®. The following trademark(s) are owned by the United States\n Postal Service® and used with permission: United States Postal Service®,\n CASS™, CASS Certified™. [↩](#fnref1)"]]
