Se você precisar adicionar informações meteorológicas ao seusite ou aplicativo que você está desenvolvendo, a primeira coisa que você precisa é de uma fonte confiável de dados climáticos. Mas isso não é tudo, você também precisa de um método para buscar esses dados. Não seria ótimo se houvesse uma ferramenta que permitisse buscar facilmente vários tipos de dados climáticos e incluí-los em seu aplicativo ou site? Bem, existe. É chamada de API do Weatherstack e foi criada para fazer exatamente isso. Hoje, estamos analisando detalhadamente essa API, o que ela pode fazer por você e como você pode usá-la.

Sobre dados meteorológicos
Conforme definido pela Wikipedia, “Meteorologia é um ramodas ciências atmosféricas, que inclui a química atmosférica e a física atmosférica, com foco principal na previsão do tempo. ”E embora haja mais do que previsão do tempo nessa ciência, é seu ramo principal. Por enquanto, sempre quisemos - e muitas vezes precisávamos - prever como seria o tempo. Ao longo dos séculos, essa ciência - como todas as outras - evoluiu consideravelmente para uma ciência relativamente precisa que é agora. Obviamente, a previsão do tempo é um campo propenso a erros e todos nós fomos pegos por um banho inesperado em um ponto ou outro.
Hoje, várias agências nacionais ou particularesas organizações fornecem serviços de previsão e observação do tempo que cobrem praticamente todo o mundo. E, embora as informações exatas que cada grupo fornece e como ele é formatado possam variar, elas tendem a ser cada vez mais uniformes, tornando mais fácil para as organizações internacionais obter dados semelhantes sobre diferentes locais.
Adicionando dados meteorológicos ao seu site ou aplicativo
Existem muitas razões pelas quais alguém gostaria deincorporar dados climáticos em seu aplicativo ou site. O motivo mais básico seria alguém criar um site ou aplicativo meteorológico. E, usando uma ferramenta como a API do Weatherstack, é possível buscar facilmente dados meteorológicos para quase qualquer local do mundo e apresentá-los da maneira que desejarem. Tudo o que você precisa fazer é determinar quais informações você deseja apresentar aos seus usuários e como deseja apresentá-las. Dois aplicativos ou sites diferentes poderiam estar buscando os mesmos dados do Weatherstack, mas apresentá-los de uma maneira completamente diferente.
Mas construir aplicativos climáticos de sites não é ouse somente para dados meteorológicos. Imagine que você administre uma bela pousada na costa do mar. Não seria legal se você pudesse incluir o clima e a previsão atuais na sua página inicial? Bem, um provedor de dados meteorológicos como o Weatherstack permitirá que você faça exatamente isso. Melhor ainda, ele fará isso automaticamente para você. Tudo que você precisa é adicionar o código apropriado ao seu site e pronto! Você tem a previsão do tempo no seu site.
Poderíamos facilmente pensar em um bando de usos semelhantespara quem desejar adicionar qualquer tipo de dados climáticos ao aplicativo ou site. Se, por exemplo, você executar qualquer tipo de operação em ambiente externo, poderá fornecer aos seus clientes alguns dados meteorológicos atuais ou uma previsão futura.
Poderíamos continuar para sempre com bons exemplos deusando dados meteorológicos no seu site em um aplicativo. A verdade é que o único limite para o que pode ser feito com isso é apenas a imaginação de alguém. Vi sites que não tinham nada a ver com o clima, mas ainda incluíam alguns dados climáticos.
Uma primeira olhada na API do Weatherstack
o API do Weatherstack é realmente bastante simples. É um serviço baseado na Web que você pode usar para buscar dados climáticos sobre praticamente qualquer local. Depois de ter os dados, o que você faz com eles depende inteiramente de você. O que a API fornece é apenas uma fonte de dados meteorológicos internacionais ao vivo e atualizados. A ferramenta é super simples de usar e seu modelo de preços facilita o pagamento do que você precisa.
o API do Weatherstack oferece em tempo real, histórico e futuro(previsão) informações meteorológicas. Sua principal clientela alvo são grandes e pequenas organizações, além de desenvolvedores, freelancers e indivíduos. É um dos provedores de API REST de dados climáticos mais populares no mercado devido à sua facilidade de implementação e consistência dos dados.
Weatherstack é um serviço de Apilayer, uma empresa de software com sede em Londres, Reino Unido e Viena, Áustria. Ele está por trás de alguns dos produtos API e SaaS mais populares do mundo. Isso inclui coisas como Ipstack, Currencylayer, Invoicelye Eversign. A API está usando dados climáticos licenciados dealgumas das maiores estações meteorológicas e provedores de dados meteorológicos do mundo. Além disso, todas as fontes de dados são monitoradas de perto quanto à consistência e precisão dos dados o tempo todo. Você sempre obtém o mais alto nível de confiabilidade, consistência e precisão.
Embora a frequência atual dos dados climáticos seja diferente de uma fonte para outra, todos os dados retornados pelo API do WeatherstackAtual, passado e futuro é sempre o maisinformações atualizadas disponíveis no momento atual. Os dados meteorológicos são sempre atualizados em tempo real. Você pode usá-lo com confiança e com a certeza de que são os dados mais atuais disponíveis.
Uma coisa é ter dados atuais, mas também é importante poder buscá-los sempre que você precisar. E nessa frente, o API do Weatherstack não deixa nada a desejar. Ele tem um histórico de tempo de atividade estelar e, embora a empresa anuncie um tempo de atividade de 99,9%, estatísticas recentes mostram que o serviço não caiu uma vez nos últimos trinta dias. Mas não está apenas disponível, mas também apresenta um bom desempenho. Todos os dados meteorológicos são retornados no formato JSON, o que contribui para uma resposta rápida. O tempo de resposta da consulta raramente é superior a meio segundo e geralmente é muito menor. Obviamente, sua experiência pode variar e vários problemas fora do controle do provedor podem atrasar o processo.

o API do Weatherstack também é altamente escalável. É apoiado por uma infraestrutura de nuvem criada e mantida pelo Apilayer, capaz de lidar com bilhões de solicitações por dia. E se a segurança é importante para você - como provavelmente é - as consultas e respostas podem ser protegidas usando a criptografia HTTPS (SSL) de 256 bits padrão do setor. Esse é o mesmo nível de criptografia que você obtém nos sites bancários.
E como qualquer produto - e especialmente uma API - é tão bom quanto sua documentação, você apreciará a documentação completa fornecida com o API do Weatherstack. Você encontrará um documento fácil de entender parapraticamente todos os casos de uso possíveis. Além disso, é fornecida uma série de exemplos de códigos interativos em vários idiomas. Em muitos casos, o uso da API será uma simples questão de copiar o código dos exemplos para o seu próprio aplicativo. Dificilmente poderia ser mais fácil.
Os principais recursos da API do Weatherstack
O conjunto de recursos do API do Weatherstack é impressionante. Isso varia de acordo com o plano escolhido e, é claro, com o preço pago. (Mais sobre preços abaixo). Vamos dar uma olhada mais profunda no que está realmente disponível em termos de recursos.
Tempo em tempo real é o API do WeatherstackÉ o recurso mais básico e o único que éincluído em todos os planos, mesmo o gratuito. O que oferece é acesso instantâneo aos dados meteorológicos atuais para milhões de localidades globais. É, é claro, alimentado por fontes de dados sólidas e atualizadas em tempo real.
o Pesquisa de local e preenchimento automático O módulo está disponível apenas com planos pagos. Ele fornece um ponto de extremidade flexível da API de pesquisa e preenchimento automático que pode ajudá-lo a identificar facilmente qualquer cidade ou região de sua escolha. Você pode pesquisar por nome, código postal, coordenadas geográficas ou mesmo por endereço IP. Esse último recurso pode ser muito útil se você quiser incluir dados meteorológicos localizados para os visitantes do seu site. Ele usa técnicas de geolocalização para encontrar a localização física de seus visitantes com base no endereço IP.
o Astronomia e dados lunares disponível em todos os planos pagos, permite que o API do Weatherstack fornecer uma série de valiosos pontos de dados de astronomia. Isso inclui informações como o nascer do sol e a lua e os horários definidos, a fase da lua e os níveis de iluminação da lua.
o API do Weatherstack também oferece Dados hora a hora em todos os planos pagos. Você obterá dados meteorológicos muito precisos em tempo real e históricos detalhados por hora nas últimas 24 horas, incluindo temperatura, vento, umidade, chuva e muito mais.
E se você deseja obter dados mais antigos, todos os planos pagos incluem Dados meteorológicos históricos que permite informações meteorológicas históricas completas e detalhadas globalmente desde o ano de 2008. Esse recurso também está incluído em todos os planos pagos.
Quando se trata de clima, porém, geralmente estamos mais interessados no que o futuro nos reserva do que no passado. Aqui é onde então Dados da previsão do tempo módulo é útil. Ele fornecerá dados confiáveis de previsão do tempo por 7 a 14 dias no futuro (dependendo do seu plano), atualizados em tempo real e 24 horas por dia.
Nem todo mundo fala inglês e os criadores do API do Weatherstack sabe disso. É por isso que a API está disponível em 40 idiomas diferentes com o Profissional e O negócio planos. Os idiomas disponíveis incluem inglês (é claro), chinês, árabe, francês, espanhol e alemão, apenas para citar alguns.
Agora, se você precisar buscar muitos dados climáticos, a execução de várias consultas individuais pode ser complicada, complicada e bastante lenta. Felizmente, o API do Weatherstack vem com o API em massa característica. As consultas em massa permitem procurar dados meteorológicos em tempo real, históricos ou futuros para vários locais globais em uma única solicitação de API.
Usando o Weatherstack
Vamos dar uma olhada em como você pode usar o API do Weatherstack. Nosso objetivo não é fornecer uma descrição detalhadatutorial - a excelente documentação disponível no site da API do Weathersrack pode ser usada para isso -, mas para fornecer uma visão geral de como é fácil usar o serviço e como os dados retornados podem ser.
Invocando o API do Weatherstack é tão simples quanto enviar uma solicitação get para a API.weatherstack.com. Esse URL é estendido para especificar o tipo de solicitação. Portanto, você usaria api.weatherstack.com/current, api.weatherstack.com/historical ou api.weatherstack / forecast. Se precisar de criptografia, basta prefixar a chamada com https: // em vez de http: //.
Você precisa, é claro, enviar alguns parâmetroscom o seu pedido. A primeira - e mais importante - é a sua chave de API. Essa é uma chave exclusiva que é atribuída a você quando você solicita o serviço. Outro parâmetro necessário é chamado de "consulta". É a consulta real que você deseja executar. Esse é o local para o qual você deseja recuperar dados. Pode ser um único local como "Londres, Reino Unido", mas também vários locais separados por ponto e vírgula como "Londres, Madri, Nova York". O mecanismo de pesquisa é inteligente o suficiente para que você não precise digitar mais do que apenas o nome da cidade para os locais mais conhecidos. A menos que, é claro, você precise de algo específico, como o clima em Londres, Ontário, Canadá.
Há também alguns parâmetros opcionaisque permitem aos usuários especificar parâmetros como o número de dias a prever, as unidades de medida, do idioma. E como a resposta está no formato JSON, você também pode especificar uma função de retorno de chamada JSONP que manipulará a resposta. Isso é muito poderoso.
Depois de enviar sua solicitação, veja uma visão geral da resposta que você receberá:
{ "request": { "type": "City", "query": "New York, United States of America", "language": "en", "unit": "m" }, "location": { "name": "New York", "country": "United States of America", "region": "New York", "lat": "40.714", "lon": "-74.006", "timezone_id": "America/New_York", "localtime": "2019-09-07 11:38", "localtime_epoch": 1567856280, "utc_offset": "-4.0" }, "current": { "observation_time": "03:38 PM", "temperature": 18, "weather_code": 113, "weather_icons": [ "https://assets.weatherstack.com/images/wsymbols01_png_64/wsymbol_0001_sunny.png" ], "weather_descriptions": [ "Sunny" ], "wind_speed": 0, "wind_degree": 345, "wind_dir": "NNW", "pressure": 1011, "precip": 0, "humidity": 58, "cloudcover": 0, "feelslike": 18, "uv_index": 5, "visibility": 16 }, "forecast": { "2019-09-07": { "date": "2019-09-07", "date_epoch": 1567814400, "astro": { "sunrise": "06:28 AM", "sunset": "07:19 PM", "moonrise": "03:33 PM", "moonset": "12:17 AM", "moon_phase": "First Quarter", "moon_illumination": 54 }, "mintemp": 17, "maxtemp": 25, "avgtemp": 21, "totalsnow": 0, "sunhour": 10.3, "uv_index": 5, "hourly": [ { "time": "0", "temperature": 18, "wind_speed": 28, "wind_degree": 15, "wind_dir": "NNE", "weather_code": 122, "weather_icons": [ "https://assets.weatherstack.com/images/wsymbols01_png_64/wsymbol_0004_black_low_cloud.png" ], "weather_descriptions": [ "Overcast" ], "precip": 0, "humidity": 68, "visibility": 10, "pressure": 1008, "cloudcover": 75, "heatindex": 18, "dewpoint": 12, "windchill": 18, "windgust": 35, "feelslike": 18, "chanceofrain": 0, "chanceofremdry": 87, "chanceofwindy": 0, "chanceofovercast": 90, "chanceofsunshine": 15, "chanceoffrost": 0, "chanceofhightemp": 0, "chanceoffog": 0, "chanceofsnow": 0, "chanceofthunder": 0, "uv_index": 0 }, { "time": 300, ... }, { "time": 600, ... }, // 6 more items ] } } }
Como você pode ver, são muitas informações. Você obtém dados meteorológicos atuais completos, como temperatura, direção e velocidade do vento, umidade, pressão barométrica e índice de UV, entre outros. A seção de previsão é igualmente detalhada e inclui, por exemplo, a chance de precipitação em porcentagem, índice de calor, fator de resfriamento do vento e ponto de orvalho. Uma última coisa que vale a pena notar é que a resposta também inclui URLs para ícones que você pode usar para adicionar interesse visual aos seus dados meteorológicos.
Poderíamos gastar um pouco de tempo analisando todas as opções e os vários bits de dados incluídos nas respostas da consulta. No entanto, desde o API do Weatherstack site possui documentação tão detalhada, nóspercebi que não era necessário. E se você precisar de exemplos concretos de como usar a API Weatherstack com sua linguagem de programação preferida, a documentação on-line possui vários exemplos de código em PHP, Python, Nodejs, jQuery, Go e Ruby.
Informações sobre preços
o API do Weatherstack está disponível em vários planos diferentes. Como vimos, os planos variam no número de recursos que cada um oferece, mas também no número máximo de chamadas de API que você pode fazer a cada mês.
O plano mais básico é o Livre plano. Não custa nada e nem é necessário um cartão de crédito para se inscrever nesse plano. No entanto, é severamente limitado, pois permitirá apenas mil chamadas de API por mês. Seu uso principal é para fins de teste.
Em seguida é o Padrão planejar com muito mais recursos - só faltao módulo de previsão e os vários idiomas - e uma alocação mensal de até cinquenta mil chamadas. Este plano está disponível por US $ 9,99 / mês ou US $ 7,99 / mês, se você pagar anualmente.

O plano intermediário - e também o mais popular - é o Profissional plano. Nesse nível, você obtém o conjunto completo de recursos e o suporte multilíngue, além de uma alocação estendida de até trezentos mil chamadas por mês. Este custa US $ 49,99 ou US $ 39,99 se cobrado anualmente.
O plano superior - chamado de O negócio plano - oferece o mesmo conjunto completo de recursos que oprofissional, mas aumenta a alocação mensal para um milhão de chamadas por mês. É, obviamente, o plano mais caro em US $ 99,99 / mês ou US $ 79,99 com pagamentos anuais.
E se nenhum desses planos corresponder às suas necessidades, entre em contato com Apilayer e providenciar um serviço personalizado Empreendimento plano. Ele incluirá os recursos necessários e a alocação mensal necessária. Esse nível também oferece suporte dedicado, além da possibilidade de soluções personalizadas que atendem às suas necessidades específicas.
Bottom Line
Se você precisar adicionar dados climáticos a um site ou aplicativo que está desenvolvendo, o API do Weatherstack pode fornecer exatamente o que você precisa em umpreço muito razoável. O produto é fácil de usar e se integra facilmente ao seu ambiente existente. O serviço é rápido e eficiente, sua disponibilidade é excelente e sua qualidade é inigualável. Com um plano gratuito disponível, experimente e veja por si mesmo como essa ferramenta pode ajudá-lo a alcançar seus objetivos.
Comentários