Envie uma solicitação de validação de endereço emitindo uma solicitação POST para um dos seguintes endpoints:
- validateAddress (REST)
- ValidateAddress (gRPC)
Sua solicitação também precisa passar um corpo da solicitação JSON a ela que define o endereço a ser validado. O corpo da solicitação a seguir contém um campo e três 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"
Também é possível omitir locality
e especificá-lo como um elemento na
a matriz addressLines
:
{
"address": {
"regionCode": "US",
"addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
},
}
Campos de solicitação de endereço
O corpo da solicitação consiste em um único campo:
address
: um campo do tipoPostalAddress
, que deve conter em pelo menos uma entrada emaddressLines
.
Ao enviar o campo address
para a API Address Validation, você só precisa
forneça um campo: addressLines
. No entanto, a solicitação de endereço mais simples
deve conter os seguintes subcampos:
regionCode
— Recomendado. Este é um campo opcional, mas, se omitido, o A API Address Validation infere a região do endereço. No entanto, para melhores resultados, incluaregionCode
se souber. Para conferir a lista de regiões com suporte, consulte as regiões com suporte.addressLines
: obrigatório. Uma matriz com endereços que descrevem as estrutura do endereço.
Consulte PostalAddress no guia de referência. |
Opção USPS CASSTM
O United States Postal Service® (USPS®)1 mantém Sistema de suporte à precisão de programação (CASSTM, na sigla em inglês), que oferece suporte e certificação provedores de validação de endereço.
Somente para regiões dos EUA e PR, é possível ativar o processamento do CASS configurando
enableUspsCass
para true
no corpo da solicitação. Para melhores resultados ao usar
CASS, forneça um endereço que inclua a rua e o número, junto com
a cidade, o estado e o CEP:
{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"administrativeArea": "CA",
"postalCode": "94043",
"addressLines": ["1600 Amphitheatre Pkwy"]
},
"enableUspsCass": true
}
Confira!
Com o APIs Explorer, você pode fazer solicitações de amostra para se familiarizar com a API e as opções de API.
Selecione o ícone da API,
, no lado direito da página.
Como opção, expanda Mostrar parâmetros padrão e defina
fields
parâmetro ao campo máscara.É possível editar o Corpo da solicitação.
Selecione o botão Execute. Na caixa de diálogo, escolha a conta que que deseja usar para fazer a solicitação.
No painel do APIs Explorer, selecione o ícone de expansão,
para expandir a janela do APIs Explorer.
-
A Plataforma Google Maps é uma licenciada não exclusiva dos Estados Unidos Postal Service®. As marcas registradas a seguir são de propriedade dos Estados Unidos Postal Service® e usado com a permissão: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩