Descripción general de la API de Address Validation

Descripción general de Address Validation

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 Sistema de asistencia de precisión de la codificación (CASSTM).

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 de entrega, lo que brinda una experiencia del cliente mejorada. Para ello, detecta las direcciones incorrectas y obtén un mejor conocimiento de sus características.

Es posible que la API de Geocoding se adapte mejor a tus necesidades si no necesitas validar los componentes individuales de la dirección. La API de Geocoding convierte direcciones en coordenadas de latitud y longitud, mientras que la API de Address Validation valida las direcciones para garantizar su precisión. Consulta Cómo compilar la capacidad de validación de la ubicación con Google Maps Platform en el Centro de arquitectura para obtener una comparación detallada.

Qué puedes hacer con la API de Address Validation

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 posibles componentes incorrectos que puedes presentarles a los clientes para que los corrijan. A continuación, se muestra un flujo de trabajo de muestra con la API:

  1. El cliente ingresa una dirección: En la siguiente imagen, se muestra un formulario simple que permite que un cliente ingrese una dirección, posiblemente como parte de un flujo de confirmación de la compra.
    La dirección ingresada por el cliente.

  2. 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.

  3. La API valida y estandariza la dirección: en su respuesta, la API de Address Validation muestra la dirección completa según lo determinado por la API o indica dónde falta información.

  4. El cliente corrige o confirma la dirección recomendada: según lo que muestre la API, puedes proporcionarle los siguientes mensajes:

    • Presenta una dirección recomendada para que el cliente la confirme:
      Pídele al cliente que confirme la dirección según lo determinado por la API.

    • Pídele al cliente que agregue la información que falta:
      Pídele al cliente que ingrese la información de la dirección que falta.

    • Solicita al usuario que corrija la dirección si la API no puede validar la dirección de entrada debido a que falta información o es incorrecta:
      Pídele al cliente que corrija la información de 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 cuerpo JSON. Separa la dirección en sus componentes individuales y, luego, realiza las siguientes verificaciones y correcciones:

  • Correcto: Proporciona verificaciones de validación a nivel de componente, incluidas las sublocales cuando están disponibles.
  • Completo: Intenta inferir los componentes de la dirección faltantes o incorrectos.
  • Con el formato correcto: Limpia y estandariza el formato de los componentes de dirección.

Prueba la demostración para ver la API de Address Validation en acció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 muestra. Para obtener información específica, consulta la referencia de la API de Address Validation.

Recursos de datos Datos que se muestran

Componentes de dirección en formato JSON.

Consulta Valida una dirección.

Dirección completa y validada (si es posible).

Estado de validación de cada componente de la dirección

Si está disponible para una dirección:

  • Geocodificación
  • Precisión de la dirección
  • Datos de los servicios postales, cuando estén disponibles.

Consulta Información sobre la respuesta de validación.

Cómo usar la API de Address Validation

1 Probar la demostración Explora la demostración con una variedad de formularios de dirección, tanto correctos como incorrectos. La demostración proporciona una manera útil de explorar los valores que muestra el servicio y la respuesta de la API con formato JSON.
2 Cómo verificar la cobertura Consulta los detalles de cobertura para ver qué países y regiones admite la API de Address Validation.
3 Prepárate Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones que aparecen a continuación.
4 Cómo solicitar una validación de dirección Comienza con una dirección simple y, luego, para mayor precisión, puedes habilitar el CASS (solo para direcciones de EE.UU. y RR.PP.). 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 debes usar de manera diferente. Consulta Información para comprender una respuesta básica.
6 Mejora la exactitud de la validación Puedes ayudar a mejorar la precisión de las direcciones si proporcionas comentarios sobre las respuestas de la API de Address Validation. Consulta Administra direcciones actualizadas.

Bibliotecas cliente disponibles

Para obtener una lista de las bibliotecas cliente disponibles para la API de Address Validation, consulta Bibliotecas cliente.

Información acerca de CASSTM

El Servicio Postal de Estados Unidos® (USPS®)1 mantiene el Sistema de Asistencia de Precisión de la Codificación (CASSTM) para apoyar y certificar a los proveedores de validación de direcciones. Se confirmó que un servicio CASS CertifiedTM, como la API de Address Validation, es capaz de completar la información que falta en una dirección, estandarizarla y actualizarla para brindarte la dirección más actualizada y precisa.

CASS no está habilitado de forma predeterminada y solo es compatible con las regiones "US" y "PR". Para habilitar el CASS, establece enableUspsCass en true como parte de una solicitud de validación. Para obtener más información, consulta Valida una dirección.

Como parte de nuestro uso de los servicios del USPS, el servicio evalúa las solicitudes de direcciones creadas de forma artificial. Si el USPS identifica que una dirección de entrada se creó de forma artificial, Google debe dejar de validar las direcciones del cliente y debe informar la información de contacto del cliente (nombre y dirección), la dirección de entrada relevante y los datos de uso agregados al USPS. Si usas la API, aceptas estas Condiciones Específicas del Servicio.

Próximos pasos


  1. Google Maps Platform es licenciatario no exclusivo del United States Postal Service®. Las siguientes marcas son propiedad de United States Postal Service® y se utilizan con el permiso correspondiente: United States Postal Service®, CASSTM, CASS CertifiedTM.