Como criar OpenWeather API key

O serviço de dados meteorológicos em tempo real OpenWeather oferece uma série de APIs especiais, para a incorporação destes mesmos dados em sites, programas e aplicativos. Antes de fazer uso dessa interface de programação de aplicações, contudo, você deverá gerar uma chave de acesso secreta e exclusiva, chamada de OpenWeather API key. O nosso passo a passo lhe guiará por todo o processo.

O que é OpenWeather?

OpenWeather é uma empresa da internet que oferece serviços de dados meteorológicos em tempo real e previsões meteorológicas globais, por meio de interfaces de programação de aplicações (APIs). Entre os recursos disponibilizados estão o fornecimento de dados meteorológicos globais em tempo real (previsões de tempo, avisos e alertas) e de dados históricos relativos a regiões geográficas.

Para a geração dos dados a serem disponibilizados, a OpenWeather combina aprendizado de máquina (machine learning) e redes neurais (neural networks) artificiais. Os dados processados pelas previsões e análises englobam informações provenientes de estações meteorológicas de aeroportos, radares, satélites, estações automatizadas e dados de outros serviços meteorológicos.

O que é OpenWeather API?

Na verdade, o OpenWeather oferece mais de uma API capaz de integrar dados meteorológicos a aplicações próprias. A lista de APIs é vasta, oferece funcionalidades distintas e atende a diferentes tipos de necessidade. Cada interface de programação de aplicações autoriza que programas acessem as informações disponibilizadas, garantindo o estabelecimento de uma comunicação segura e confiável para a transferência dos dados. Por padrão, tanto o plano gratuito quanto os planos pagos do OpenWeather oferecem a API “Current Weather Data”, assim como previsões que abrangem os próximos 5 dias (estas são atualizadas de 3 em 3 horas).

A API gratuita dispõe de dados meteorológicos para diferentes regiões, por acompanhar o tempo em mais de 200 mil cidades do mundo. Dados e informações provenientes das diversas fontes confiáveis consultadas, por sua vez, são formatados em HTML, XML ou JSON. Por suposto, as APIs pagas oferecem recursos mais abrangentes, que serão apresentados mais a diante por este artigo.

A seguir, destacamos as opções de APIs gratuitas e pagas oferecidas a desenvolvedores pelo OpenWeather. Você deverá escolher a sua com base nas necessidades específicas da sua aplicação e no seu orçamento.

One Call API 3.0

A interface de programação de aplicações One Call API 3.0 é a opção de uso gratuito. Ela permite a realização de até 1.000 solicitações à API, sem cobrar pelo serviço. Se você precisar ultrapassar esse limite, todavia, o OpenWeather lhe sugerirá a assinatura de um plano de cobrança ou do pacote “Pay as you call”, que cobra cerca de US$ 0,0015 por solicitação à API. Entre os dados meteorológicos gratuitamente disponibilizados a desenvolvedores estão:

• Informações e previsões em tempo real para a próxima hora
• Previsões de hora em hora para as próximas 48 horas
• Previsões para os próximos 8 dias
• Dados meteorológicos históricos, que retroagem até 40 anos no tempo
• Avisos e alertas meteorológicos, a depender dos dados apontados pela previsão

APIs para integração profissional

O OpenWeather também oferece planos pagos e diferenciados de APIs, que têm como público-alvo aplicações de maior porte, projetos especializados e grandes empresas. Esses planos costumam incluir uma maior gama de recursos, tais como:

• Hourly Forecast 4 Days: Os dados são atualizados em tempo real + Divulga previsões de hora em hora para os próximos 4 dias + Disponibiliza dados para até 96 timestamps + Suporta os formatos JSON e XML.
• Daily Forecast 16 Days: Realiza previsões mundiais para os próximos 16 dias + Suporta os formatos JSON e XML + Dados das previsões do tempo são atualizados diariamente.
• Climatic Forecast 30 Days: Realiza previsões mundiais para os próximos 30 dias + Suporta o formato JSON.
• Bulk Download: Permite o download dos dados meteorológicos atualizados, de diferentes tipos de previsão e do histórico relativo aos últimos 7 dias + Ordena os dados e por tipo e por região + Suporta os formatos CSV e JSON.
• Global Weather Alerts Push Notifications: Coleta e disponibiliza todos os alertas de agências meteorológicas nacionais + Envia notificações por push em tempo real sobre todos os alertas ativos mundialmente + Inclui hora, local e descrição nas notificações.
• Road Risk API: Fornece dados e alertas meteorológicos específicos para as rotas rodoviárias selecionadas + Exibe dados em tempo real, além de previsões e dados históricos relativos a rota escolhida.

Para explorar as APIs disponibilizadas pelo OpenWeather em mais detalhes, e comparar o plano gratuito e os pagos, basta acessar a página de APIs do OpenWeather.

Como criar uma OpenWeather API key?

Para incorporar funções do serviço OpenWeather à sua aplicação, você precisará da respectiva API key — somente a chave de API lhe permitirá acessar a interface de programação de aplicações que deseja utilizar. Semelhantes a senhas, API keys garantem o tráfego confiável de dados, bem como o acesso autenticado por contas autorizadas. Ainda, é com a ajuda de chaves de API que o OpenWeather controla o número de solicitações à API, de modo a evitar que o limite do plano escolhido seja excedido.

OpenWeather API key gratuita

Para obter uma chave para a API gratuita do OpenWeather, como para os planos “Current Weather” e “5 Days / 3 Hours”, você deverá seguir os seguintes passos:

• Passo 1: Faça login na página de usuário do OpenWeather ou crie uma nova conta, caso você ainda não tenha se registrado.
• Passo 2: Ao se registrar pela primeira vez, você deverá informar o seu endereço de e-mail e aguardar pelo e-mail de confirmação. É nele que você encontrará a OpenWeather API key referente ao seu plano gratuito.

OpenWeather API key paga

Se você pretende assinar um plano pago da OpenWeather API, como o “Professional” ou o “Enterprise”, deverá realizar outro procedimento. Acompanhe:

• Passo 1: Faça login na página de usuário do OpenWeather ou crie uma nova conta, caso você ainda não tenha se registrado.
• Passo 2: Para contratar um plano pago, acesse a página de APIs do OpenWeather, escolha a API que deseja incorporar ao seu projeto e clique no botão “Subscribe”.
• Passo 3: Preencha o formulário de cobrança e conclua o processo de cadastro. Não se esqueça de vincular o seu plano a uma chave de API, para conseguir acessar a respectiva API.
• Passo 4: No e-mail de confirmação que o OpenWeather lhe enviará, você poderá encontrar o IP do servidor correspondente ao plano que você assinou.

Acessar OpenWeather API keys pagas

Para gerar uma nova chave de API do OpenWeather ou resgatar uma chave anteriormente criada, você deverá seguir os passos abaixo:

1. Faça login na página de usuário do OpenWeather.
2. No painel, procure pelo nome da sua conta, que estará localizado no canto superior direito da tela. Em seguida, clique em “My API”, no menu suspenso. Lá, você encontrará todas as chaves de API geradas até então, acompanhadas das respectivas informações importantes.
3. Ao clicar em “Create key”, você também poderá gerar uma nova chave de API para associá-la ao seu projeto.

O que acontece se o limite de solicitações à API for atingido?

Por meio da chave de API, o OpenWeather é capaz de controlar o número de solicitações provenientes de uma conta. Tanto os planos gratuitos quanto os planos pagos possuem um limite máximo de solicitações, que deve ser respeitado para que a API funcione corretamente. Assim que atingir o limite contratado, você receberá uma notificação automática. Na mensagem, o OpenWeather sugerirá a contratação de um plano alternativo que dispõe de um maior número de solicitações.

Caso o desenvolvedor contatado não reaja à notificação de limite máximo, a OpenWeather API key correspondente será desativada. Para reativar a chave de API de uma conta, é preciso entrar em contato com o atendimento ao cliente.