Como criar OpenWe­ather API key

O serviço de dados me­te­o­ro­ló­gi­cos em tempo real OpenWe­ather oferece uma série de APIs especiais, para a in­cor­po­ra­ção destes mesmos dados em sites, programas e apli­ca­ti­vos. Antes de fazer uso dessa interface de pro­gra­ma­ção de apli­ca­ções, contudo, você deverá gerar uma chave de acesso secreta e exclusiva, chamada de OpenWe­ather API key. O nosso passo a passo lhe guiará por todo o processo.

O que é OpenWe­ather?

OpenWe­ather é uma empresa da internet que oferece serviços de dados me­te­o­ro­ló­gi­cos em tempo real e previsões me­te­o­ro­ló­gi­cas globais, por meio de in­ter­fa­ces de pro­gra­ma­ção de apli­ca­ções (APIs). Entre os recursos dis­po­ni­bi­li­za­dos estão o for­ne­ci­mento de dados me­te­o­ro­ló­gi­cos globais em tempo real (previsões de tempo, avisos e alertas) e de dados his­tó­ri­cos relativos a regiões ge­o­grá­fi­cas.

Para a geração dos dados a serem dis­po­ni­bi­li­za­dos, a OpenWe­ather combina apren­di­zado de máquina (machine learning) e redes neurais (neural networks) ar­ti­fi­ci­ais. Os dados pro­ces­sa­dos pelas previsões e análises englobam in­for­ma­ções pro­ve­ni­en­tes de estações me­te­o­ro­ló­gi­cas de ae­ro­por­tos, radares, satélites, estações au­to­ma­ti­za­das e dados de outros serviços me­te­o­ro­ló­gi­cos.

O que é OpenWe­ather API?

Na verdade, o OpenWe­ather oferece mais de uma API capaz de integrar dados me­te­o­ro­ló­gi­cos a apli­ca­ções próprias. A lista de APIs é vasta, oferece fun­ci­o­na­li­da­des distintas e atende a di­fe­ren­tes tipos de ne­ces­si­dade. Cada interface de pro­gra­ma­ção de apli­ca­ções autoriza que programas acessem as in­for­ma­ções dis­po­ni­bi­li­za­das, ga­ran­tindo o es­ta­be­le­ci­mento de uma co­mu­ni­ca­ção segura e confiável para a trans­fe­rên­cia dos dados. Por padrão, tanto o plano gratuito quanto os planos pagos do OpenWe­ather oferecem a API “Current Weather Data”, assim como previsões que abrangem os próximos 5 dias (estas são atu­a­li­za­das de 3 em 3 horas).

A API gratuita dispõe de dados me­te­o­ro­ló­gi­cos para di­fe­ren­tes regiões, por acom­pa­nhar o tempo em mais de 200 mil cidades do mundo. Dados e in­for­ma­ções pro­ve­ni­en­tes das diversas fontes con­fiá­veis con­sul­ta­das, por sua vez, são for­ma­ta­dos em HTML, XML ou JSON. Por suposto, as APIs pagas oferecem recursos mais abran­gen­tes, que serão apre­sen­ta­dos mais a diante por este artigo.

A seguir, des­ta­ca­mos as opções de APIs gratuitas e pagas ofe­re­ci­das a de­sen­vol­ve­do­res pelo OpenWe­ather. Você deverá escolher a sua com base nas ne­ces­si­da­des es­pe­cí­fi­cas da sua aplicação e no seu orçamento.

One Call API 3.0

A interface de pro­gra­ma­ção de apli­ca­ções One Call API 3.0 é a opção de uso gratuito. Ela permite a re­a­li­za­ção de até 1.000 so­li­ci­ta­ções à API, sem cobrar pelo serviço. Se você precisar ul­tra­pas­sar esse limite, todavia, o OpenWe­ather lhe sugerirá a as­si­na­tura de um plano de cobrança ou do pacote “Pay as you call”, que cobra cerca de US$ 0,0015 por so­li­ci­ta­ção à API. Entre os dados me­te­o­ro­ló­gi­cos gra­tui­ta­mente dis­po­ni­bi­li­za­dos a de­sen­vol­ve­do­res estão:

• In­for­ma­çõ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 me­te­o­ro­ló­gi­cos his­tó­ri­cos, que retroagem até 40 anos no tempo
• Avisos e alertas me­te­o­ro­ló­gi­cos, a depender dos dados apontados pela previsão

Close

APIs para in­te­gra­ção pro­fis­si­o­nal

O OpenWe­ather também oferece planos pagos e di­fe­ren­ci­a­dos de APIs, que têm como público-alvo apli­ca­ções de maior porte, projetos es­pe­ci­a­li­za­dos e grandes empresas. Esses planos costumam incluir uma maior gama de recursos, tais como:

• Hourly Forecast 4 Days: Os dados são atu­a­li­za­dos em tempo real + Divulga previsões de hora em hora para os próximos 4 dias + Dis­po­ni­bi­liza dados para até 96 ti­mes­tamps + 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 atu­a­li­za­dos di­a­ri­a­mente.
• 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 me­te­o­ro­ló­gi­cos atu­a­li­za­dos, de di­fe­ren­tes 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 No­ti­fi­ca­ti­ons: Coleta e dis­po­ni­bi­liza todos os alertas de agências me­te­o­ro­ló­gi­cas nacionais + Envia no­ti­fi­ca­ções por push em tempo real sobre todos os alertas ativos mun­di­al­mente + Inclui hora, local e descrição nas no­ti­fi­ca­ções.
• Road Risk API: Fornece dados e alertas me­te­o­ro­ló­gi­cos es­pe­cí­fi­cos para as rotas ro­do­viá­rias se­le­ci­o­na­das + Exibe dados em tempo real, além de previsões e dados his­tó­ri­cos relativos a rota escolhida.

Close

Para explorar as APIs dis­po­ni­bi­li­za­das pelo OpenWe­ather em mais detalhes, e comparar o plano gratuito e os pagos, basta acessar a página de APIs do OpenWe­ather.

Como criar uma OpenWe­ather API key?

Para in­cor­po­rar funções do serviço OpenWe­ather à sua aplicação, você precisará da res­pec­tiva API key — somente a chave de API lhe permitirá acessar a interface de pro­gra­ma­ção de apli­ca­ções que deseja utilizar. Se­me­lhan­tes a senhas, API keys garantem o tráfego confiável de dados, bem como o acesso au­ten­ti­cado por contas au­to­ri­za­das. Ainda, é com a ajuda de chaves de API que o OpenWe­ather controla o número de so­li­ci­ta­ções à API, de modo a evitar que o limite do plano escolhido seja excedido.

OpenWe­ather API key gratuita

Para obter uma chave para a API gratuita do OpenWe­ather, 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 OpenWe­ather ou crie uma nova conta, caso você ainda não tenha se re­gis­trado.
• Passo 2: Ao se registrar pela primeira vez, você deverá informar o seu endereço de e-mail e aguardar pelo e-mail de con­fir­ma­ção. É nele que você en­con­trará a OpenWe­ather API key referente ao seu plano gratuito.

OpenWe­ather API key paga

Se você pretende assinar um plano pago da OpenWe­ather API, como o “Pro­fes­si­o­nal” ou o “En­ter­prise”, deverá realizar outro pro­ce­di­mento. Acompanhe:

• Passo 1: Faça login na página de usuário do OpenWe­ather ou crie uma nova conta, caso você ainda não tenha se re­gis­trado.
• Passo 2: Para contratar um plano pago, acesse a página de APIs do OpenWe­ather, escolha a API que deseja in­cor­po­rar ao seu projeto e clique no botão “Subscribe”.
• Passo 3: Preencha o for­mu­lá­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 res­pec­tiva API.
• Passo 4: No e-mail de con­fir­ma­ção que o OpenWe­ather lhe enviará, você poderá encontrar o IP do servidor cor­res­pon­dente ao plano que você assinou.

Acessar OpenWe­ather API keys pagas

Para gerar uma nova chave de API do OpenWe­ather ou resgatar uma chave an­te­ri­or­mente criada, você deverá seguir os passos abaixo:

1. Faça login na página de usuário do OpenWe­ather.
2. No painel, procure pelo nome da sua conta, que estará lo­ca­li­zado no canto superior direito da tela. Em seguida, clique em “My API”, no menu suspenso. Lá, você en­con­trará todas as chaves de API geradas até então, acom­pa­nha­das das res­pec­ti­vas in­for­ma­ções im­por­tan­tes.
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 so­li­ci­ta­ções à API for atingido?

Por meio da chave de API, o OpenWe­ather é capaz de controlar o número de so­li­ci­ta­ções pro­ve­ni­en­tes de uma conta. Tanto os planos gratuitos quanto os planos pagos possuem um limite máximo de so­li­ci­ta­ções, que deve ser res­pei­tado para que a API funcione cor­re­ta­mente. Assim que atingir o limite con­tra­tado, você receberá uma no­ti­fi­ca­ção au­to­má­tica. Na mensagem, o OpenWe­ather sugerirá a con­tra­ta­ção de um plano al­ter­na­tivo que dispõe de um maior número de so­li­ci­ta­ções.

Caso o de­sen­vol­ve­dor contatado não reaja à no­ti­fi­ca­ção de limite máximo, a OpenWe­ather API key cor­res­pon­dente será de­sa­ti­vada. Para reativar a chave de API de uma conta, é preciso entrar em contato com o aten­di­mento ao cliente.