Adicionar uma chave de API do Google Maps

NOTE: este artigo é destinado a criadores de relatórios incorporados com muito tráfego que contêm o Google Maps. Para realizar as tarefas descritas aqui, você precisa conhecer ou trabalhar com alguém que conheça o console do Google Cloud .

Quando a incorporação está ativada, um relatório do Data Studio aceita até 30.000 carregamentos do Google Maps sem custo financeiro por mês. Os carregamentos de mapa são contabilizados para visualizações incorporadas e não incorporadas do relatório, bem como para downloads de PDF e visualizações de e-mails. Se o relatório exceder a cota sem custo financeiro, o Google Maps vai mostrar um erro.

Para aumentar o número de carregamentos de mapa permitidos, adicione uma chave de API Google Maps ao relatório.

IMPORTANTE: os relatórios que usam uma chave de API não estão mais sujeitos à cota sem custo financeiro de 30.000 carregamentos de mapa. Cada carregamento de mapa é contabilizado no nível de preço da sua chave de API.

Criar uma chave de API Google Maps

Para criar e gerenciar chaves de API do Google Maps, consulte Como usar chaves de API (abre na documentação da Plataforma Google Maps). Você precisa ter um projeto de faturamento do Google Cloud configurado para concluir esta etapa.

  1. Na página Como usar chaves de API, clique em Acessar a página "Credenciais".
  2. Se solicitado, selecione o projeto de faturamento.
  3. No canto superior esquerdo, clique em + CRIAR CREDENCIAIS.
  4. (Opcional, mas recomendado) Clique em RESTRINGIR CHAVE.

Restringir a chave de API aos seus relatórios

Recomendamos que você restrinja a chave de API apenas aos relatórios que precisam usá-la. Para isso, adicione os URLs dos relatórios ao console do Cloud.

  1. Em Restrições de aplicativo, selecione Referenciadores HTTP (sites).
  2. Em Restrições de sites, clique em Adicionar um item.
  3. Insira o URL do relatório do Data Studio que vai usar essa chave de API.
  4. Adicione outros URLs para permitir que vários relatórios utilizem a chave.

É possível usar caracteres curinga para que os relatórios de várias páginas funcionem com sua chave de API. Se você estiver incorporando o relatório, também precisará incluir o URL de incorporação dele.

Por exemplo, para incluir várias páginas, use um URL como este:

https://datastudio.google.com/reporting/<some-report-id>/*

Para incluir um relatório incorporado, use um URL como este:

https://datastudio.google.com/embed/reporting/<some-report-id>/*

Dica: remova todas as partes de login múltiplo do URL, se houver. Por exemplo, se o URL for assim: https://datastudio.google.com/u/0/reporting/…, remova a parte /u/0 para que ele fique assim: https://datastudio.google.com/reporting/…

Adicionar a chave de API Google Maps aos seus relatórios

  1. Edite o relatório.
  2. Selecione Arquivo > Configurações do relatório.
  3. Insira a chave de API no campo API Google Maps.

Preços

Sua conta de faturamento será cobrada pelo uso da chave de API. Os seguintes níveis de preço se aplicam:

  • Dynamic Maps > API Maps JavaScript para carregamentos de mapa
  • Dynamic Street View > API Maps JavaScript para uso do Street View