Envía una solicitud de validación de dirección a través de una solicitud POST a uno de los siguientes extremos:
- validateAddress (REST)
- ValidateAddress (gRPC)
Tu solicitud también debe pasar un cuerpo de 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 array addressLines
:
{
"address": {
"regionCode": "US",
"addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
},
}
Campos de solicitud de dirección
El cuerpo de la solicitud consta de un solo campo:
address
: Es un campo de tipoPostalAddress
, que debe contener en al menos una entrada enaddressLines
.
Cuando envíes el campo address
a la API de Address Validation, solo necesitas
Proporciona 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, el La API de Address Validation infiere la región a partir de la dirección. Sin embargo, para obtener mejores resultados, incluye elregionCode
si lo conoces. Para obtener la lista de regiones compatibles, consulta regiones compatibles.addressLines
: Obligatorio. Es un array con direcciones que describen la estructura inferior de la dirección.
Consulta PostalAddress en la guía de referencia. |
Opción USPS CASSTM
El United States Postal Service® (USPS®)1 mantiene Código de asistencia de precisión de la codificación (CASSTM) para respaldar y certificar proveedores de validación de direcciones.
Solo para regiones de EE.UU. y PR, puedes habilitar el procesamiento CASS estableciendo
enableUspsCass
a true
en el cuerpo de la solicitud. Para obtener mejores resultados al usar
CASS, proporciona una dirección que incluya la calle y el número 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
}
Pruébalo
El Explorador de APIs te permite realizar solicitudes de muestra para que puedes familiarizarte con la API y sus opciones.
Selecciona el ícono de la API, , en el lado derecho de la página.
De manera opcional, puedes expandir Mostrar parámetros estándar (Show standard parameters) y establecer el
fields
parámetro al campo máscara.De manera opcional, edita el Cuerpo de la solicitud.
Selecciona el botón Ejecutar. En el cuadro de diálogo, elige la cuenta que quieres usar para hacer la solicitud.
En el panel Explorador de APIs, selecciona el ícono de expansión, , para expandir la ventana del Explorador de API
-
Google Maps Platform es un licenciatario no exclusivo de Estados Unidos. Postal Service®. Las siguientes marcas comerciales son propiedad de Estados Unidos Postal Service® y se usa con el permiso United States Postal Service®, CASSTM y CASS CertifiedTM. ↩