Referencia rápida de la API de Address Validation

La API de Address Validation acepta una dirección, identifica sus componentes y los valida, estandariza la dirección para los envíos por correo y devuelve las mejores coordenadas de latitud y longitud conocidas para ella. En el caso de las direcciones de EE.UU. y Puerto Rico, puedes habilitar el procesamiento de CASS del USPS de forma opcional.

API de Address Validation: Datos clave

  • Producto: API de Address Validation
  • Categoría: Lugares
  • Plataforma: Servicio web (REST)
  • Se ejecuta en: Servidor (código de backend)
  • Etapa de lanzamiento: GA
  • Ciclo de vida: Activo
  • Descripción general: Descripción general de la API de Address Validation
  • Disponibilidad regional: Limitada. Los países admitidos y la calidad de los datos varían según el país, y algunos países están en versión preliminar. Los metadatos residenciales y comerciales solo se devuelven para los países marcados en la página de cobertura. El CASS de USPS solo se admite en EE.UU. y Puerto Rico. (detalles de la cobertura)

API de Address Validation: Cuándo usarla

Usa la API de Address Validation en los siguientes casos:

  • Debes verificar si una dirección hace referencia a un lugar real y encontrar qué componentes faltan o podrían ser incorrectos.
  • Necesitas estandarizar y completar una dirección para los envíos por correo, por ejemplo, durante un proceso de confirmación de compra.
  • Necesitas la validación con certificación CASS del USPS y uspsData para las direcciones de EE.UU. o Puerto Rico.
  • Necesitas metadatos de direcciones residenciales o comerciales de un país que aparezca en la página de cobertura.

No uses la API de Address Validation en los siguientes casos:

  • Solo necesitas convertir una dirección en latitud/longitud y no necesitas validar los componentes individuales de la dirección. En su lugar, usa la API de Geocoding.
  • Necesitas detalles de destinos hiperlocales, como entradas de edificios, contornos de edificios o puntos de navegación. En su lugar, usa la API de Geocoding.

API de Address Validation: Configuración

Paquetes oficiales de la API de Address Validation:

  • npm: @googlemaps/addressvalidation
  • pypi: google-maps-addressvalidation
  • go: cloud.google.com/go/maps

API de Address Validation: Errores comunes

  • Problema: La propiedad addressComplete se omite del veredicto cuando su valor es false, por lo que el código que espera que el campo esté presente puede interpretar de forma incorrecta las direcciones incompletas. Solución: Trata una propiedad addressComplete faltante como false o verifica la presencia de la propiedad. Consulta /maps/documentation/address-validation/understand-response.
  • Problema: Si se omite regionCode, la API infiere la región a partir de la dirección, lo que puede generar resultados menos precisos. Solución: Incluye regionCode en PostalAddress cuando lo sepas. Consulta /maps/documentation/address-validation/requests-validate-address.
  • Problema: No se garantiza que el objeto uspsData se complete por completo para cada dirección validada de EE.UU. Solución: No confíes en uspsData como la única señal de validación; también usa los componentes de veredicto y dirección. Consulta /maps/documentation/address-validation/handle-us-address.
  • Problema: Los comentarios enviados con provideValidationFeedback deben hacer referencia al responseId de la primera llamada de validateAddress de la secuencia, no a una posterior. Solución: Almacena el responseId de la primera respuesta de validateAddress y envíalo en la solicitud de comentarios. Consulta /maps/documentation/address-validation/handle-updated-address.

Qué puedes hacer con la API de Address Validation

Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.