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
uspsDatapara 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
- Servicio que se habilitará:
addressvalidation.googleapis.com - Autenticación: Clave de API, OAuth 2.0, cuenta de servicio
- Comienza: Configura la API de Address Validation
- Referencia: Referencia de la API de Address Validation
- Precios: Uso y facturación de la API de Address Validation
- Políticas: Políticas de la API de Address Validation
- Notas de la versión: Notas de la versión de la API de Address Validation
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
addressCompletese omite del veredicto cuando su valor esfalse, 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 propiedadaddressCompletefaltante comofalseo 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: IncluyeregionCodeenPostalAddresscuando lo sepas. Consulta /maps/documentation/address-validation/requests-validate-address. - Problema: No se garantiza que el objeto
uspsDatase complete por completo para cada dirección validada de EE.UU. Solución: No confíes enuspsDatacomo 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
provideValidationFeedbackdeben hacer referencia alresponseIdde la primera llamada devalidateAddressde la secuencia, no a una posterior. Solución: Almacena elresponseIdde la primera respuesta devalidateAddressy 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.
- Devuelve una dirección validada para una dirección especificada o parcial.
- Devolver las coordenadas de latitud y longitud de una dirección validada
- Devuelve el identificador de lugar de Google para una dirección validada.
- Usa la certificación del Coding Accuracy Support System (CASS) del United States Postal Service (USPS) para la validación de direcciones.
- Devuelve información sobre si una dirección validada es una empresa, una residencia o un apartado postal.
- Devuelve los metadatos de entrega del Servicio Postal de Estados Unidos (USPS) para una dirección validada.
- Devuelve una versión en inglés de una dirección validada. Versión preliminar
- Devuelve el Plus Code de una dirección validada.