Passo 10
Chave de API: ligar o clima e o mapa, e saber se a chave funcionou
Na implantação, quando o painel mostra o espaço do clima vazio ou o mapa abre sem rua nenhuma. São duas integrações que o sistema não traz de fábrica porque a chave é da empresa, não nossa — e cada uma se prova de um jeito diferente.
Antes de começar
- A chave em mãos, copiada inteira. Espaço sobrando no fim é a causa boba mais comum de 'chave inválida'.
- Saber que chave de API é cobrada por uso no fornecedor. Quem paga a conta é o cliente, e o sistema não limita isso por você.
- Lembrar que ligar o mapa GIS substitui os mapas offline: a tela passa a depender da internet do servidor.
Passo a passo
- 01
Cada integração tem seu cartão na coluna da esquerda. Começo pela do clima, porque ela é a que sabe se provar.
- 02
A chave de cima liga a integração. Repare que ligar e guardar a credencial são duas coisas: desligado aqui, o sistema continua guardando a chave, só não usa.
- 03
A chave fica neste campo. Ele é do tipo senha — nem você nem quem estiver olhando a tela lê o que está escrito, e no banco ela fica cifrada. Aqui ela já está colada; numa instalação nova, é aqui que você cola a sua.
- 04
Testar não pergunta ao nosso servidor se ele gostou da chave: ele vai até a OpenWeatherMap com ela e volta com a temperatura de agora.
- 05
E esta é a diferença que importa. A faixa verde traz a cidade, a temperatura e a umidade deste minuto — um número que só existe se a chave funcionou de verdade. Teste que responde apenas 'conexão ok' prova bem menos do que parece.
- 06
Salvar guarda a chave e o estado da chavinha. Testar sem salvar não configura nada: o teste é sobre o que está no campo, não sobre o que está guardado.
- 07
O Google Maps é o mesmo cartão, com uma diferença que vale saber de antemão: aqui NÃO há botão de testar. Você cola a chave, salva, e a prova está noutro lugar — abrir o Mapa Interativo e ver se a base de ruas carrega.
Como conferir
Clima: a faixa verde já é a prova, e depois de salvar o dado aparece nos Dashboards. Mapa: abra o Mapa Interativo. Se as ruas carregarem, a chave presta; se a tela ficar cinza, a chave foi recusada, não tem a API de mapas liberada, ou está restrita a outro domínio. Vale conferir no painel do fornecedor se a cobrança começou a aparecer — é o sinal de que as chamadas estão chegando lá.
Se der errado
- A chave é válida e mesmo assim o teste recusa
- Chave nova da OpenWeatherMap demora a valer — costuma levar algumas horas até ser aceita. Espere antes de trocar.
- O mapa continua cinza depois de salvar
- Não há teste nesta tela para ajudar, então olhe do lado do Google: a chave precisa ter a API de mapas habilitada, e restrição por domínio ou por IP derruba a chamada do servidor mesmo com a chave certa.
- Liguei o mapa GIS e o mapa offline sumiu
- É o esperado: o GIS substitui o mapa offline. Desligue a chavinha para voltar ao anterior.