Perguntas frequentes sobre a API Weather

Informações gerais

Como você diferenciaria a API Weather do Google de fornecedores especializados de dados meteorológicos?

O Google está integrando a tecnologia da nossa aquisição de uma empresa de meteorologia confiável com os avanços dos modelos de IA MetNet e WeatherNext do Google DeepMind (2025). Isso aproveita a confiabilidade comprovada da Plataforma Google Maps.

Qual é a diferença entre os dados meteorológicos disponíveis no Earth Engine e no BigQuery e a API Weather do Google?

O pacote de produtos de meteorologia do Google oferece uma variedade abrangente de soluções para diversas necessidades. Os modelos WeatherNext (nomeadamente GraphCast e GenCast) fornecem saídas de previsão de modelos brutos baseados em IA, incluindo parâmetros ideais para pesquisa, modelagem e análise, disponibilizados usando código de padrão aberto e conjuntos de dados meteorológicos históricos ou atuais usando as APIs Earth Engine e BigQuery.

Por outro lado, a API Weather da Plataforma Google Maps oferece dados meteorológicos processados para condições atuais, previsões por hora e previsões diárias, combinando IA e sistemas de previsão tradicionais em um formato adequado para desenvolvedores que se integra perfeitamente a apps e serviços da Web. Essa abordagem dupla atende às necessidades de pesquisa especializada e à ampla acessibilidade do desenvolvedor.

Por que o Google não confia apenas em medições de estações meteorológicas?

O Google usa várias fontes de entrada para o modelo meteorológico, incluindo observações de estações meteorológicas, modelos numéricos de previsão do tempo e modelos de IA meteorológica. O motivo para usar essas várias fontes de entrada é que as observações de estações meteorológicas só fornecem informações sobre o clima no local da estação no momento da medição. As observações de estações meteorológicas podem ser altamente precisas para esse local específico, mas fenômenos meteorológicos, como precipitação, especialmente de chuvas ou tempestades, geralmente são localizados e podem variar significativamente em uma curta distância.

Por exemplo, pode estar chovendo muito no local da estação, enquanto a alguns quilômetros de distância, há apenas uma garoa leve ou nenhuma chuva. Como uma única leitura de estação pode não ser representativa de uma área maior, os modelos são necessários para fornecer informações adicionais entre as estações.

Além disso, as estações meteorológicas normalmente fornecem leituras de hora em hora ou de meia em meia hora. Mesmo que elas sejam fornecidas quase em tempo real, ainda pode haver um pequeno atraso entre os eventos de precipitação reais e o relatório. Os modelos também ajudam a obter as condições atuais o mais próximo possível da realidade experimentada no local consultado.

Uso da API

Qual é a cobertura da API Weather?

A API Weather é compatível com todos os países do mundo, exceto Japão, Coreia e territórios proibidos. Para o lançamento inicial, estamos oferecendo suporte a áreas populosas (exceto locais remotos, como o meio do oceano, desertos e picos de montanhas). Estamos planejando melhorias contínuas de resolução e qualidade até 2025.

Qual é a granularidade espacial da API Google Clima?

A resolução dos dados é tal que as previsões são criadas em um raio de alguns quilômetros para qualquer local do mundo.

Qual é a frequência de atualização da API Weather?

Endpoint Condições atuais Previsão de hora em hora Previsão do dia Histórico por hora
Taxa de atualização 15 minutos (periodicamente dentro da hora) 30 minutos (periodicamente dentro da hora) 30 minutos (atualizado ao mesmo tempo que a previsão de hora em hora) Duas vezes por dia (7h e 19h, horário padrão do Pacífico).

A API Weather oferece previsão de precipitação imediata?

O Google não oferece previsão imediata (previsão de minutos) na API, mas oferece condições atuais, previsões por hora e previsões diárias.

A API Weather fornece valores separados de UVA e UVB?

O índice UV é um índice único que combina UVA e UVB. Não fornecemos um detalhamento por componente.

Como a API Weather produz uma saída de previsão?

Conforme mostrado no diagrama abaixo, as previsões da API Weather são criadas usando um sistema interno de previsão que utiliza modelos meteorológicos e observações de agências meteorológicas globais como entradas. Os dados de sensores meteorológicos públicos são usados para melhorar o modelo de previsão.

Diagrama do modelo de previsão da API Weather

Qual é a precisão da previsão do tempo do Google Clima, para diferentes regiões e horizontes de previsão, em comparação com as previsões das principais agências governamentais de meteorologia?

Os números na Tabela 1 comparam a raiz do erro quadrático médio (RMSE, na sigla em inglês) para temperatura e velocidade do vento para um horizonte de previsão de 240 horas (10 dias) entre dados meteorológicos do Google e modelos meteorológicos globais e regionais de agências governamentais em 11 meses (15 de agosto de 2024 a 1º de julho de 2025).

Globalmente, a previsão do tempo do Google supera as previsões do tempo das principais agências governamentais. Para a Europa e a América do Norte, os dados meteorológicos do Google têm um erro menor do que os modelos governamentais regionais mais precisos para pelo menos a parte mais recente dos horizontes de previsão. O excelente desempenho dos dados meteorológicos do Google para horizontes de previsão mais longos é particularmente notável, o que pode ser o mais desafiador de prever com precisão.

A Tabela 1 lista os valores médios de RMSE para os horizontes de previsão relevantes para cada combinação de modelo de região. Um valor de RMSE menor indica um desempenho melhor. As previsões do tempo do Google têm os valores médios de RMSE mais baixos ou entre os mais baixos para quase todos os parâmetros, regiões e intervalos de horizonte de previsão.

Clique em uma imagem para ver uma versão ampliada.

Temperatura Velocidade do vento
Global
América do Norte
Europa

Tabela 1. Valores médios de RMSE para relevantes para cada combinação de modelo regional

A Tabela 2 lista os valores médios de RMSE para horizontes de previsão relevantes para cada modelo (valores do Google em negrito). Os parâmetros (temperatura, vento) e os horizontes de previsão para os quais o Google tem exclusivamente o RMSE médio mais baixo são destacados em verde escuro. Os parâmetros e os horizontes de previsão para os quais o Google tem o REQM médio mais baixo, juntamente com (um) outro(s) modelo(s), são destacados em verde claro.

Valores médios de REQM para os horizontes de previsão relevantes Tabela 2. Valores médios de RMSE para horizontes de previsão relevantes por modelo

O endpoint de dados históricos reflete dados meteorológicos reais (ou seja, verificados por medições locais)?

Os dados meteorológicos históricos são principalmente a saída modelada. Embora incorpore observações de agências meteorológicas globais e modelos numéricos de previsão do tempo (NWP, na sigla em inglês), eles são assimilados ao modelo do Google Clima para criar um registro histórico completo e consistente. As medições reais da estação são consideradas "verdade de campo" nos locais específicos, mas a distribuição global limitada as torna insuficientes para uma imagem mundial completa.

Esses campos fornecem insights distintos, mas relacionados, sobre precipitação e clima geral.

  • weatherCondition:esse campo fornece uma descrição geral e intuitiva das condições climáticas gerais na área consultada, considerando vários parâmetros para facilitar a compreensão.
  • precipitation.probability.percent (PoP) : representa a probabilidade de precipitação. A probabilidade de que a precipitação ocorra no local da previsão durante o período definido (normalmente por hora).
  • precipitation.qpf.quantity (QPF) : significa previsão quantitativa de precipitação e indica a quantidade esperada de precipitação, medida como uma profundidade (por exemplo, milímetros ou polegadas). Esse valor representa a quantidade de precipitação esperada se ela ocorrer no horário e local especificados.

Como posso determinar se está chovendo ou não em um determinado local?

Recomendamos usar o campo weatherCondition para entender se está chovendo ou não em um determinado local. Várias condições podem indicar que está chovendo (RAIN, LIGHT RAIN, RAIN SHOWERS, HEAVY RAIN, WIND AND RAIN, THUNDERSTORM, HEAVY THUNDERSTORM, THUNDERSHOWER, SCATTERED SHOWERS, LIGHT THUNDERSTORM RAIN, SCATTERED THUNDERSTORMS, RAIN AND SNOW). Essas condições foram projetadas para capturar todas as instâncias de chuva leve, forte, contínua ou dispersa e também diferenciar chuva de neve. Dependendo do seu caso de uso específico, por exemplo, se ele considerar apenas chuva forte, você poderá usar apenas um subconjunto relevante dessas condições.

As "condições atuais" são equivalentes às observações nos locais das estações meteorológicas? Como as "condições atuais" são determinadas em locais sem estações?

Nossas "condições atuais" fornecem as informações meteorológicas mais atualizadas combinando várias fontes de dados, mas elas não são estritamente equivalentes às observações diretas da estação em todos os casos.

Para precipitation.probability.percent e precipitation.qpf.quantity (acumulados na última hora), o valor apresentado na resposta currentConditions é sempre derivado da previsão mais recente. A probabilidade em si é uma quantidade modelada, em vez de observada diretamente.

Essa abordagem nos permite fornecer "condições atuais" abrangentes, mesmo em áreas sem cobertura direta de sensores, garantindo as melhores informações disponíveis em todos os momentos.

Limites e acesso da API

Há um limite de taxa na API?

Para a API Weather, há um limite de taxa padrão de 6.000 consultas por minuto.

Posso acessar os dados em massa?

Os dados em massa não estão disponíveis. Você pode consultar a API Weather dentro da cota (6.000 QPM) e respeitar os termos de armazenamento em cache descritos nos Termos de Serviço.

Preciso ativar o faturamento?

É necessária uma conta de faturamento válida para usar a API Weather. Consulte Ativar faturamento para configurar seu projeto com uma conta de faturamento.

O que acontece se eu consultar um local que está indisponível?

Se a latitude e a longitude não estiverem incluídas na lista de países com suporte, a resposta vai retornar um código de erro 404 com a mensagem "As informações não estão disponíveis para este local. Tente outro local".