Solução de problemas

Chave de API e erros de faturamento

Em algumas situações, um mapa escuro ou uma imagem "negativa" do Street View pode aparecer com a marca d'água "somente para fins de desenvolvimento". Normalmente, isso indica problemas com uma chave de API ou com o faturamento. Para usar os produtos da Plataforma Google Maps, o faturamento precisa estar ativado na sua conta, e todas as solicitações têm que incluir uma chave de API válida. O fluxo a seguir ajudará a resolver esse problema:

A chave de API é transmitida como o parâmetro key no URL usado para carregar a API Maps JavaScript. Confira algumas opções para verificar se você está usando uma chave de API:

  • Use a extensão Google Maps Platform API Checker do Chrome. Ela permite que você determine se o seu site está implementando as APIs licenciadas do Maps de forma correta.
  • Se você estiver usando uma biblioteca ou um plug-in para carregar a API Maps JavaScript, verifique as configurações dessa biblioteca e procure uma opção de chave de API.
  • Verifique os erros no navegador. Se as mensagens a seguir forem exibidas, significa que você não está usando a chave de API corretamente:

Para desenvolvedores Web:

  • Se você tiver acesso ao código-fonte do app, procure a tag <script>, que é usada para carregar a API Maps JavaScript. Ao carregar essa API, substitua YOUR_API_KEY no código abaixo pela sua chave de API. 
      <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
  • Verifique o tráfego de rede gerado pelo seu site no navegador. No Google Chrome, isso pode ser visto na guia Rede do DevTools. Aqui, você verá as solicitações de rede feitas pelo seu site. As solicitações feitas usando a API Maps JavaScript estarão no caminho maps/api/js. Aqui, você pode confirmar se as solicitações estão usando o parâmetro key. Pode ser útil filtrar o tráfego de rede por maps/api/js ao visualizar a guia Rede.

Para conseguir uma, clique no botão abaixo. Se a configuração guiada não aparecer, siga as instruções completas em Começar a usar a Plataforma Google Maps.
Como começar

Ótimo. Vamos verificar se há uma conta de faturamento vinculada ao seu projeto.

Acesse a página "Faturamento" no console do Google Cloud e selecione o projeto em que a chave de API foi criada. Para confirmar se a chave está associada ao projeto, siga estas etapas:

  1. Vá para a seção Credenciais na barra lateral esquerda, em Plataforma Google Maps > Credenciais.
  2. Verifique se a chave de API usada atualmente no seu site está listada. Se esse não for o caso, mude para outro projeto e verifique as credenciais.
  3. Se não for possível localizar o projeto da sua chave de API, é possível que você tenha perdido o acesso a ele. Peça ajuda na sua organização. Se não for possível localizar o projeto original, faça o seguinte:
    1. Crie um novo projeto. Selecione Novo projeto na lista de projetos ou escolha Criar projeto na página do Resource Manager.
    2. Crie outra chave de API. Isso pode ser feito na página Credenciais. Clique em Criar credenciais e selecione Chave de API.

Após localizar o projeto no console do Cloud, verifique se há uma conta de faturamento vinculada. Para fazer isso, acesse a seção Faturamento no menu à esquerda.

Acesse a página Ativar faturamento no console do Cloud e adicione uma conta de faturamento ao seu projeto. Para mais informações, consulte o artigo Começar a usar a Plataforma Google Maps.

Ótimo. Vamos verificar se o método de faturamento fornecido é válido.

É possível adicionar, remover ou atualizar uma forma de pagamento no console do Cloud.

Se você definiu um limite diário em qualquer uma das suas APIs (o que é comum para evitar aumentos inesperados), aumente seu limite diário para resolver esse problema.

Para conferir seus limites diários, acesse o Painel de APIs e serviços no console do Cloud. Depois, siga estas etapas:

  1. Selecione um projeto, se solicitado.
  2. Selecione uma API na lista e clique na guia Cotas.

As chaves de API com uma restrição a endereços IP só podem ser usadas com serviços da Web destinados ao uso do servidor (como a API Geocoding e outras APIs de serviços da Web). A maioria desses serviços da Web tem funções equivalentes na API Maps JavaScript (por exemplo, consulte o Serviço de geocodificação). Para usar os serviços do lado do cliente da API Maps JavaScript, crie uma chave de API que pode ser protegida com uma restrição a referenciadores HTTP (consulte Receber, adicionar e restringir uma chave de API).

Se o código não funciona:

Para que seu código de mapas funcione bem, Brendan Kenny e Mano Marks mostram neste vídeo alguns erros comuns e a correção deles.

  • Procure erros de digitação. A linguagem JavaScript diferencia maiúsculas de minúsculas.
  • Verifique os elementos básicos. Alguns dos problemas mais comuns ocorrem na criação inicial do mapa. Por exemplo:
    • Confirme se você especificou as propriedades zoom e center nas opções do mapa.
    • Verifique se declarou um elemento "div" que vai ser usado para mostrar o mapa na tela.
    • Confira se esse elemento tem uma altura. Por padrão, os elementos "div" são criados com uma altura de zero, o que os torna invisíveis.
    Consulte uma implementação de referência nos nossos exemplos.
  • Para identificar problemas, use um Depurador de JavaScript, como o disponível nas Ferramentas para desenvolvedores do Chrome. Comece procurando erros no Console JavaScript.
  • Faça perguntas no Stack Overflow. Confira na página Suporte orientações para postar boas perguntas.