Envía una solicitud de validación de dirección

Envía una solicitud de validación de dirección mediante la emisión de una solicitud POST a uno de los siguientes extremos:

Tu solicitud también debe pasar el cuerpo de la solicitud JSON a la solicitud que define la dirección que se validará. El siguiente cuerpo de la solicitud contiene un campo y tres subcampos:

curl -X POST -d '{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  }
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:validateAddress?key=API_KEY"

También puedes omitir locality y especificarlo como un elemento en el arreglo addressLines:

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

Campos de la solicitud de dirección

El cuerpo de la solicitud consta de un solo campo:

  • address: Es un campo de tipo PostalAddress, que debe contener al menos una entrada en addressLines.

Cuando envías el campo address a la API de Address Validation, solo necesitas proporcionar un campo: addressLines. Sin embargo, la solicitud de dirección más simple debe contener los siguientes subcampos:

  • regionCode: Recomendado. Este es un campo opcional, pero si se omite, la API de Address Validation infiere la región a partir de la dirección. Sin embargo, para obtener mejores resultados, incluye regionCode si lo conoces. Para obtener la lista de regiones admitidas, consulta las regiones compatibles.
  • addressLines: Obligatorio. Un array con direcciones que describen la estructura inferior de la dirección
Consulta PostalAddress en la guía de referencia.

Opción CASSTM de USPS

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.

Solo en las regiones de EE.UU. y PR, puedes habilitar el procesamiento de CASS si configuras enableUspsCass como true en el cuerpo de la solicitud. Para obtener mejores resultados cuando uses el CASS, proporciona una dirección que incluya la calle y el número de la calle junto con la ciudad, el estado y el código postal:

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

  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.