Os métodos da API Geocoding v4 têm uma cota padrão de 25 consultas por segundo (QPS). Para informações sobre como solicitar uma cota maior, consulte Ver e gerenciar cotas e selecione API Geocoding como o serviço.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Configurar a API Geocoding

Desenvolvedores do Espaço Econômico Europeu (EEE)

Neste documento, descrevemos as etapas para começar a usar a API Geocoding.

Verifique se você atende aos pré-requisitos.

Ative a API no seu projeto na nuvem do Google Cloud.

Configure uma chave de API ou OAuth para fazer uma solicitação de API autenticada.

Os produtos da Plataforma Google Maps exigem que as chamadas de API incluam uma chave de API ou um token OAuth para evitar o uso não autorizado. Escolha o procedimento de configuração que corresponde ao seu ambiente de implantação.

Criar um token OAuth

A API Geocoding é compatível com o OAuth 2.0 para autenticação. O Google é compatível com cenários comuns do OAuth 2.0, como os de um servidor da Web.

Neste documento, descrevemos como transmitir um token OAuth para uma chamada de API Geocoding no seu ambiente de desenvolvimento. Para mais informações sobre como usar o OAuth em um ambiente de produção, consulte Métodos de autenticação no Google.

É possível chamar as APIs Google Maps diretamente fazendo solicitações de API ao servidor ou usar bibliotecas de cliente para simplificar seu código. O Google Maps oferece bibliotecas de cliente para Go, Java, Node.js e Python. Para mais informações, consulte Bibliotecas de cliente da API Geocoding.

Visão geral do OAuth

É possível criar e gerenciar tokens de acesso com o OAuth de várias maneiras, dependendo do seu ambiente de implantação.

É possível usar o OAuth 2.0 para interações de servidor para servidor entre seu aplicativo e um serviço do Google. Nesse cenário, você usa uma conta de serviço associada ao aplicativo, em vez de um usuário individual. É possível fazer solicitações de API usando a conta de serviço sem envolver os usuários diretamente. Para mais informações sobre métodos de autenticação, consulte Métodos de autenticação no Google.

Como alternativa, é possível integrar a API Geocoding a um app para dispositivos móveis Android ou iOS. Para mais informações sobre como usar o OAuth e gerenciar tokens de acesso para diferentes ambientes de implantação, consulte Como usar o OAuth 2.0 para acessar as APIs do Google.

Escopos do OAuth

Para usar o OAuth com a API Geocoding, é necessário atribuir o escopo correto ao token do OAuth. A API Geocoding é compatível com os seguintes escopos:

https://www.googleapis.com/auth/maps-platform.geocode: use com todos os métodos da API Geocoding.
https://www.googleapis.com/auth/maps-platform.destinations: use apenas com SearchDestinations para consultas de destino e chegada.
https://www.googleapis.com/auth/maps-platform.geocode.address: use apenas com GeocodeAddress para geocodificação direta.
https://www.googleapis.com/auth/maps-platform.geocode.location: use apenas com GeocodeLocation para geocodificação inversa.
https://www.googleapis.com/auth/maps-platform.geocode.place: use apenas com GeocodePlace para geocodificação de lugares.

Também é possível usar o escopo geral https://www.googleapis.com/auth/cloud-platform para todos os métodos da API Geocoding. Esse escopo é útil durante o desenvolvimento, porque é o escopo padrão quando você cria tokens com a CLI gcloud.

Exemplo: testar chamadas de API REST no ambiente de desenvolvimento local

Se você não tiver um ambiente que gere tokens e quiser testar a API Geocoding com um token OAuth, use o procedimento nesta seção.

Este exemplo descreve como usar o token OAuth fornecido pelo Application Default Credentials (ADC) para fazer a chamada. Para mais informações sobre como usar o ADC para chamar APIs do Google com bibliotecas de cliente, consulte Autenticar usando bibliotecas de cliente.

Use o procedimento REST a seguir apenas para desenvolvimento ou teste, não para produção.

Pré-requisitos

Antes de fazer uma solicitação REST usando o ADC, use a CLI gcloud para fornecer credenciais ao ADC:

Instale e inicialize a CLI gcloud. Para mais informações, consulte Instalar a CLI gcloud.
Faça a autenticação com a gcloud CLI:
```
gcloud auth application-default login
```
Conclua o processo de login para salvar suas credenciais no arquivo de credenciais local usado pelo ADC.

Para mais informações, consulte Configurar o ADC para um ambiente de desenvolvimento local.

Fazer uma solicitação REST

Neste exemplo, você transmite dois cabeçalhos da solicitação:

Transmita o token OAuth no cabeçalho Authorization usando o seguinte comando para gerar o token:

gcloud auth application-default print-access-token

O token retornado tem um escopo de https://www.googleapis.com/auth/cloud-platform.
Transmita o ID ou o nome do projeto na nuvem do Google Cloud com o faturamento ativado no cabeçalho X-Goog-User-Project.

Para chamar a API Geocoding usando um token OAuth, siga estas etapas:

No exemplo de código a seguir, substitua PROJECT_ID pelo ID do projeto do Google Cloud:

curl -X GET -H 'Content-Type: application/json' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://geocode.googleapis.com/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"

Para copiar o comando curl, clique em Copiar no exemplo de código.
Cole o comando em uma janela do terminal e execute-o.

Solução de problemas

Se a solicitação retornar uma mensagem de erro informando que essa API não é compatível com credenciais de usuário final, consulte Resolver problemas de configuração do ADC.