Descripción general de Address Validation

Desarrolladores del Espacio Económico Europeo (EEE)

¿Por qué usar la API de Address Validation en la API de Maps JavaScript?

La biblioteca de Address Validation toma una dirección como entrada para identificar y validar los componentes de la dirección. También estandariza la dirección para los envíos 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™).

Con la API de Address Validation, puedes mejorar la previsibilidad de las entregas y reducir los errores, 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.

Qué puedes hacer con la API de Address Validation en la API de Maps JavaScript

Con la API de Address Validation en la API de Maps JavaScript, 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. Este es un ejemplo de flujo de trabajo:

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

    Es la dirección que ingresó el cliente.

  2. La app envía la dirección a la API: La aplicación pasa esta dirección con el método fetchAddressValidation.

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

  4. El cliente confirma o corrige la dirección: Según lo que devuelva la API, puedes proporcionar las siguientes indicaciones al cliente:

    1. Confirma la dirección recomendada.
    2. Proporciona la información faltante.
    3. Corrige la dirección.
    El cliente puede confirmar la dirección corregida. El cliente puede proporcionar la información faltante. El cliente puede corregir la dirección.

Cómo funciona Address Validation en la API de Maps JavaScript

Cuando se realiza una llamada a fetchAddressValidation, la API 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.

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 faltante de 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 "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 USPS identifica una dirección de entrada como creada de forma artificial, Google debe dejar de validar direcciones para el cliente y debe informar a 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.

Próximos pasos

  1. 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™. ↩