Descripción general de la API de Address Validation
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Desarrolladores del Espacio Económico Europeo (EEE)
Introducción
La API de Address Validation es un servicio que acepta una dirección.
Identifica los componentes de la dirección y los valida. También estandariza la dirección para el envío por correo y encuentra las coordenadas de latitud y longitud más conocidas para ella.
De manera opcional, para las direcciones de Estados Unidos y Puerto Rico, puedes habilitar el Coding Accuracy Support System (CASS™).
Por qué usar la API de Address Validation
Con la API de Address Validation, puedes mejorar la previsibilidad de las entregas y reducir los errores en ellas, lo que mejora la experiencia del cliente. Para ello, detecta las direcciones incorrectas y obtiene un mejor conocimiento de las características de las direcciones.
La API de Geocoding podría ser más adecuada para tus necesidades si no necesitas validar los componentes de dirección individuales. La API de Geocoding convierte direcciones en coordenadas de latitud y longitud. La API de Address Validation valida la corrección de las direcciones. Consulta Cómo crear una capacidad de validación de ubicaciones con Google Maps Platform en el Centro de arquitectura para obtener una comparación detallada.
Con la API de Address Validation, puedes determinar si una dirección hace referencia a un lugar real. Si la dirección no hace referencia a un lugar real, la API puede identificar componentes posiblemente incorrectos que puedes presentar a tus clientes para que los corrijan. A continuación, se muestra un flujo de trabajo de ejemplo con la API:
El cliente ingresa una dirección: En la siguiente imagen, se muestra un formulario básico que permite que un cliente ingrese una dirección, posiblemente como parte de un flujo de confirmación de compra.
La app envía la dirección a la API: La aplicación pasa esta dirección como entrada a la API de Address Validation.
La API valida y estandariza la dirección: En su respuesta, la API de Address Validation devuelve la dirección completa según lo determina la API o indica dónde falta información.
El cliente confirma o corrige la dirección: Según lo que devuelva la API, puedes proporcionar las siguientes indicaciones al cliente:
A. Confirma la dirección recomendada. B. Proporciona la información faltante.
C. Corrige la dirección.
Cómo funciona la API de Address Validation
La validación de direcciones acepta una solicitud POST con la dirección en forma de un cuerpo JSON. Separa la dirección en sus componentes individuales y, luego, intenta lo siguiente:
Corrige: Proporciona verificaciones de validación a nivel del componente, incluidas las subinstalaciones cuando están disponibles.
Completa: Intenta inferir los componentes de dirección faltantes o incorrectos.
Formatos: Limpia y estandariza el formato de los componentes de la dirección.
Recursos
En la siguiente tabla, se resumen los recursos disponibles a través de la API de Address Validation junto con los datos que devuelve. Para obtener detalles específicos, consulta la referencia de la API de Address Validation.
Explora la demostración
con una variedad de formularios de direcciones, tanto correctos como incorrectos.
La demostración proporciona una forma útil de explorar tanto los valores de devolución del servicio como la respuesta de la API con formato JSON.
2
Comprobar la cobertura
Revisa los detalles de cobertura para ver qué países y regiones admite la API de Address Validation.
Comienza con una dirección básica y, luego, para mayor precisión, puedes
habilitar CASS (solo para direcciones de EE.UU. y Puerto Rico). Consulta Cómo solicitar una validación de dirección.
5
Procesa una respuesta
La respuesta de la API de Address Validation proporciona dos propiedades, cada una de las cuales se usa de diferentes maneras.
Consulta Cómo comprender una respuesta básica.
6
Mejora la precisión de la validación
Puedes ayudar a mejorar la precisión de las direcciones proporcionando comentarios sobre las respuestas de la API de Address Validation. Consulta Cómo controlar las direcciones actualizadas.
Bibliotecas cliente disponibles
Para obtener una lista de las bibliotecas cliente disponibles para la API de Address Validation, consulta Bibliotecas cliente.
Acerca de CASS™
El United States Postal Service® (USPS®)1 mantiene el Coding Accuracy Support System (CASS™) para respaldar y certificar a los proveedores de validación de direcciones. Se confirmó que un servicio con certificación CASS Certified™, como la API de Address Validation, tiene la capacidad de completar la información que falta en una dirección, estandarizarla y actualizarla para brindarte la dirección más actual y precisa.
CASS no está habilitado de forma predeterminada y solo se admite en las regiones de "US" y "PR". Para habilitar CASS, establece enableUspsCass en true como parte de una solicitud de validación. Para obtener más información, consulta Cómo validar una dirección.
Como parte de nuestro uso de los servicios de USPS, esta empresa evalúa las solicitudes de direcciones creadas artificialmente. Si el USPS identifica una dirección de entrada como creada de forma artificial, Google debe dejar de validar direcciones para el cliente y debe informar al USPS la información de contacto del cliente (nombre y dirección), la dirección de entrada pertinente y los datos de uso agregados. Cuando usas la API, aceptas estas Condiciones Específicas del Servicio.
Google Maps Platform es licenciatario no exclusivo del United States Postal Service®. Las siguientes marcas son propiedad del United States Postal Service® y se utilizan con el permiso correspondiente: United States Postal Service®, CASS™, CASS Certified™. ↩
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)"]]
