Enviar uma solicitação de validação de endereço

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 transmitir um corpo de solicitação JSON para a solicitação 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 matriz addressLines:

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

Com o APIs Explorer, você pode fazer solicitações em tempo real para se familiarizar com a API e as opções dela:

Campos de solicitação de endereço

O corpo da solicitação consiste em um único campo:

• address: um campo do tipo PostalAddress, que precisa conter pelo menos uma entrada em addressLines.

Ao enviar o campo address para a API Address Validation, você só precisa fornecer um campo: addressLines. No entanto, a solicitação de endereço mais simples deve conter os seguintes subcampos:

• regionCode: recomendado. Esse campo é opcional, mas, se for omitido, a API Address Validation vai inferir a região do endereço. No entanto, para melhores resultados, inclua o regionCode se você o conhece. Para conferir a lista de regiões aceitas, consulte regiões aceitas.
• addressLines: obrigatório. Uma matriz com endereços que descrevem a estrutura inferior do endereço.

Opção USPS CASS™

O United States Postal Service® (USPS®)¹ mantém o Coding Accuracy Support System (CASS™) para auxiliar e certificar provedores de validação de endereço.

Somente para as regiões dos EUA e de Porto Rico, é possível ativar o processamento do CASS definindo enableUspsCass como true no corpo da solicitação. Para ter os melhores resultados ao usar o CASS, forneça um endereço que inclua a rua e o número da rua, além da cidade, do estado e do 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 dela.

1. Selecione o ícone da API api no lado direito da página.

2. Se quiser, edite os parâmetros da solicitação.

3. Selecione o botão Executar. Na caixa de diálogo, escolha a conta que você quer usar para fazer a solicitação.

4. No painel do APIs Explorer, selecione o ícone de tela cheia fullscreen para expandir a janela do APIs Explorer.