Obter uma chave/autenticação

Todos os aplicativos do Google Maps Roads API exigem autenticação com uma chave de API. Incluir uma chave na sua solicitação permite monitorar o uso de API do seu aplicativo no Google API Console, acessar uma boa cota diária gratuita e garante que a Google possa contatar você para falar sobre o seu aplicativo, se necessário.

• - Clientes da API padrão precisam de uma chave de API configurada em um projeto da sua escolha.
• Clientes do Google Maps APIs Premium Plan precisam de uma chave de API configurada no projeto do Google Maps Premium (o projeto criado para você quando solicitou o Google Maps Roads API). Se você ainda não adquiriu o acesso à API, entre em contato com o departamento de vendas.

Chaves de API

Se você estiver usando o Google Maps Roads API padrão:

Clique no botão abaixo. Você será direcionado ao Google API Console e orientado pelo processo e o Google Maps Roads API será ativado automaticamente.

Obter uma chave

Como alternativa, siga as etapas a seguir para obter uma chave de API:

1. Acesse o Google API Console.
2. Crie ou selecione um projeto.
3. Clique em Continue para ativar a API.
4. Na página Credentials, obtenha uma chave de API (e defina as restrições dela).
   Observação: Se você já tem uma chave de API irrestrita ou uma com restrições a servidor, pode usá-la.
5. Para evitar o roubo de cota, proteja sua chave de API seguindo estas práticas recomendadas.
6. (Opcional) Ative a cobrança. Consulte Limites de uso para saber mais.

Se você comprou uma licença do Google Maps APIs Premium Plan:

Para começar a usar o Google Maps Roads API, clique no botão abaixo para seguir para o Google API Console, que orienta você sobre o processo. Importante: no menu suspenso Project, selecione o projeto criado para você quando comprou o Premium Plan.*

Obter uma chave

Como alternativa, siga as etapas a seguir para obter uma chave de API:

1. Acesse o Google API Console.
2. No menu suspenso Project, selecione o projeto do Google Maps Premium.*
3. Clique em Continue.
4. Na página Credentials, obtenha uma chave de API (e defina as restrições dela).
   Observação: Se você já tem uma chave de API irrestrita ou uma com restrições a servidor, pode usá-la.
5. Para evitar o roubo de cota, proteja sua chave de API seguindo estas práticas recomendadas.

* Observação: no menu suspenso Project, você deve selecionar o projeto criado quando comprou o Premium Plan. Dependendo do seu contrato, o nome do projeto começa com Google Maps APIs for Business or Google Maps for Work or Google Maps.

Também é possível procurar uma chave existente no Google API Console.

Para saber mais sobre como usar o Google API Console, consulte a Ajuda do API Console.

Tipos de restrição da chave de API

As Google Maps APIs estão disponíveis para aplicativos Android e iOS, navegadores e via serviços Web HTTP. APIs de qualquer plataforma podem usar uma chave de API genérica (irrestrita). Você tem a opção de adicionar uma restrição (por exemplo, endereço IP) à chave de API. Depois de aplicar a restrição, a chave só funcionará em plataformas compatíveis com esse tipo de restrição. Saiba mais sobre chaves e credenciais.

Especificar uma chave na solicitação

Para especificar uma chave em sua solicitação, inclua-a como o valor de um parâmetro key.

Por exemplo:

https://roads.googleapis.com/v1/snapToRoads?path=-35.27801,149.12958|-35.28032,149.12907|-35.28099,149.12929|-35.28144,149.12984|-35.28194,149.13003|-35.28282,149.12956|-35.28302,149.12881|-35.28473,149.12836 &interpolate=true &key=YOUR_API_KEY