Controla direcciones de Estados Unidos

Este producto o función está en versión preliminar (fase previa a la DG). Los productos y las funciones que se encuentran en la fase previa a la DG pueden tener asistencia limitada, y los cambios en estos productos y funciones podrían no ser compatibles con otras versiones de la fase previa a la DG. Las ofertas que se encuentran en la fase previa a la DG se rigen por las Condiciones Específicas de los Servicios de Google Maps Platform. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En este documento, se abarca la validación de direcciones específica para Estados Unidos:

• Cómo usar los datos del USPS en tu flujo de trabajo
• Campos de USPS Delivery Point Verification (dpv)
• Mensajes de seguridad

Datos de USPS en tu flujo de trabajo

Cuando se validan direcciones en Estados Unidos, la API de Address Validation también puede propagar la parte uspsData de la respuesta.

Punto clave: Si tu sistema controla principalmente o de forma exclusiva las direcciones de EE.UU., puedes optar por usar este objeto de respuesta como primer punto de referencia en tu lógica de verificación. Sin embargo, es importante saber que no se garantiza que el objeto uspsData esté completamente propagado para cada dirección que valide el servicio.

Dado que este objeto no siempre se completa, no debes confiar en esta propiedad como el único medio para validar direcciones, sino que también debes incorporar el veredicto y los componentes de la dirección en tu sistema.

Verificación del punto de entrega (DPV) del USPS

Como parte de la respuesta de uspsData, el campo dpvConfirmation devuelve un solo carácter para informarte si el USPS puede realizar la entrega en la dirección proporcionada.

Puedes usar este campo para determinar lo siguiente:

• validez de la dirección.
• Si falta el número de una subinstalación en la dirección
• Si el número de subinstalación no existe en el sistema de datos del USPS

El servicio devuelve uno de los cuatro valores de dpvConfirmation o no devuelve ningún valor de dpvConfirmation. En la siguiente tabla, se muestra el comportamiento recomendado que debe usar tu lógica para cada uno de los 5 resultados posibles. Para obtener más detalles sobre esta lógica, consulta Descripción general del flujo de trabajo en Crea tu lógica de validación.

Valor	Comportamiento	Descripción
N o vacío	Cómo corregir la dirección	No se confirmó la dirección con el DPV. Esto significa que el USPS no reconoce el número de la dirección ingresada que existe en la calle (ruta) ingresada y no puede realizar la entrega allí.
D	Cómo corregir la dirección	La dirección se confirmó con el DPV solo para el número principal, y faltaba la información del número secundario. Esto significa que el número de la propiedad ingresado existe en la calle ingresada, pero, para llegar a una dirección completamente verificada o apta para la entrega, también se debe proporcionar un número de subpropiedad válido. En otras palabras, faltaba la subpremisa en la entrada.
S	Confirma la dirección	La dirección se confirmó con el DPV solo para el número principal, y la información del número secundario estaba presente, pero no se confirmó. Esto significa que el número de la dirección ingresada existe en la ruta ingresada, pero la subdirección proporcionada no existe dentro de ese edificio, según el USPS.
Y	Acepta la dirección	Se confirmó la dirección con el DPV para el número principal y cualquier número secundario. Esto significa que el USPS puede entregar el paquete en la dirección, incluido el número de subinstalación, si corresponde.

En el resto de esta sección, se analizan situaciones del mundo real en las que se usan los códigos de DPV.

Ejemplo de DPV N: Corrige la dirección

En este ejemplo, se usa un número de calle inexistente en una dirección que, de otro modo, sería válida.

• Dirección ingresada: 12 Amphitheatre Parkway, Mountain View, CA, 94043
• Región: EE.UU.
• El campo dpvConfirmation devuelve: N

Esta es una señal extremadamente fuerte de que este número de instalaciones no existe en esta ruta. Al igual que con otras direcciones problemáticas, tu sistema debe solicitarle al usuario que realice correcciones.

Ejemplo de DPV D: Corrige la dirección

En este ejemplo, se usa la oficina de Google en Nueva York, pero no contiene una subinstalación, que es una parte obligatoria de la dirección. Puedes comprobarlo usando la dirección en la demostración sin información de subinstalaciones.

• Dirección ingresada: 111 8th Avenue, Nueva York, NY, 10011
• Región: EE.UU.
• El campo dpvConfirmation devuelve: D

Esto confirma que faltaba la subpremisa en la entrada. Para llegar a un DPV de Y, se debe incluir una subpremisa válida como parte de la entrada. Por ejemplo, puedes incluir una subinstalación válida de FL 4 (piso 4) para obtener un valor de dpvConfirmation de Y.

Ejemplo de DPV S: Confirma la dirección

En este ejemplo, se usa un número de subinstalación que no existe dentro del edificio:

• Dirección ingresada: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
• Región: EE.UU.
• El campo dpvConfirmation devuelve: S

Esto indica que, si bien 1600 Amphitheatre Parkway existe como una dirección que puede aceptar correo, la subinstalación Ste 101 no es una parte válida de la dirección. Tu sistema debe confirmar esta información con el usuario y brindarle la oportunidad de corregirla.

Ejemplo de DPV Y: acepta la dirección

En este ejemplo, se usa la dirección de Googleplex en Mountain View, California, como una dirección de calidad conocida.

• Dirección ingresada: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
• Región: EE.UU.
• El campo dpvConfirmation devuelve: Y

El USPS puede realizar envíos a la dirección. Esto te brinda un alto grado de confianza en que la API devolvió una dirección de buena calidad, y puedes usarla tal como se proporcionó.

Nota: El DPV no indica si la API de Address Validation realizó algún cambio en la entrada, como una corrección ortográfica.

Mensajes de seguridad para direcciones de EE.UU.

En esta sección, se abordan las marcas de seguridad que se proporcionan en los datos del USPS para las direcciones creadas de forma artificial. Esta medida de seguridad está diseñada para evitar la creación artificial de una lista de direcciones, ya que detecta cuando una dirección enviada parece haberse creado de forma artificial y no se obtuvo de forma legítima. Esto debería ocurrir muy rara vez.

Cuando el USPS identifica una dirección creada de forma artificial, el campo errorMessage de la propiedad uspsData de la respuesta contiene un mensaje de error que describe el problema. Por ejemplo:

AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.

Nota: Cuando uspsData indica una dirección artificial, la respuesta para otras propiedades en la respuesta de la API de Address Validation no se ve afectada.