Para proteger os produtos da Plataforma Google Maps contra uso não autorizado, as chamadas de API ficam restritas àquelas com as credenciais de autenticação adequadas. Essas credenciais vêm na forma de uma chave de API, uma string alfanumérica exclusiva que associa a conta de faturamento do Google ao seu projeto e à API ou ao SDK específico.
Neste guia, mostramos como criar, restringir e usar uma chave de API para a Plataforma Google Maps.
Criar chaves de API
A chave de API é um identificador exclusivo que autentica solicitações associadas ao seu projeto para fins de uso e faturamento. Você precisa ter pelo menos uma chave de API associada ao projeto.
Para criar uma chave de API, siga estas etapas:
Console
-
Acesse a página Plataforma Google Maps > Credenciais.
-
Na página Credenciais, clique em Criar credenciais > Chave de API.
A caixa de diálogo Chave de API criada exibirá sua chave recém-criada. -
Clique em Fechar.
A nova chave vai aparecer na página Credenciais, em Chaves de API.
Lembre-se de restringir a chave de API antes de usar na produção.
SDK Cloud
gcloud alpha services api-keys create \
--project "PROJECT" \
--display-name "DISPLAY_NAME"
Saiba mais sobre o SDK Google Cloud, a instalação do SDK Cloud e os seguintes comandos:
Restringir chaves de API
O Google recomenda que você restrinja as chaves de API limitando o uso somente às APIs necessárias para o aplicativo. Isso deixa o app mais seguro, protegendo contra solicitações não autorizadas. Para mais informações, consulte Práticas recomendadas de segurança de APIs.
Para restringir uma chave de API, faça o seguinte:
Console
-
Acesse a página Plataforma Google Maps > Credenciais.
- Selecione a chave de API em que você quer definir uma restrição. A página de propriedades será exibida.
- Em Restrições de chave, defina as seguintes opções:
- Restrições do aplicativo:
- Para aceitar as solicitações da lista de endereços IP do servidor da Web que você forneceu, selecione Endereços IP (servidores da Web, cron jobs etc.) na lista de Restrições do aplicativo. Especifique um ou mais endereços IPv4 ou IPv6 ou uma sub-rede usando a notação CIDR. Os endereços IP precisam corresponder ao endereço de origem que os servidores da Plataforma Google Maps observam. Se você usar conversão de endereços de rede (NAT), isso normalmente corresponderia ao endereço IP público da sua máquina.
- Restrições de API:
- Clique em Restringir chave.
- Escolha API Map Tiles no menu suspenso Selecionar APIs. Você vai precisar enable a API Map Tiles se ela não aparecer nessa lista.
- Para concluir as mudanças, clique em Salvar.
SDK Cloud
Liste as chaves atuais.
gcloud services api-keys list --project="PROJECT"
Limpe as restrições atuais na chave.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
--clear-restrictions
Defina novas restrições para as chaves atuais.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
--api-target="tile.googleapis.com"
--allowed-ips="IP_ADDRESS"
Saiba mais sobre o SDK Google Cloud, a instalação do SDK Cloud e os seguintes comandos:
Adicionar a chave de API à solicitação
É necessário incluir uma chave de API em todas as solicitações da API Map Tiles. No exemplo a seguir, substitua YOUR_API_KEY pela chave de API.
https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY
O HTTPS é obrigatório para solicitações que usam uma chave de API.
A seguir
Obter blocos 2D
Depois de conseguir sua chave de API, use-a para criar um token de sessão. Você vai usar sua chave de API e o token de sessão nas solicitações de blocos de mapas 2D e blocos do Street View.
Obter blocos 3D
Depois de receber a chave de API, você poderá usá-la para acessar Blocos 3D.