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 de boa reputação 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 clima do Google oferece uma ampla variedade de soluções para diversas necessidades. Os modelos do WeatherNext (GraphCast e GenCast) fornecem previsões brutas baseadas em IA, incluindo parâmetros ideais para pesquisa, modelagem e análise. Eles são disponibilizados usando código de código aberto e conjuntos de dados climáticos históricos ou atuais com as APIs do Earth Engine e do 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 fácil de usar 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 dos desenvolvedores.

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

O Google usa várias fontes de entrada para o modelo de clima, incluindo observações de estações meteorológicas, modelos numéricos de previsão do tempo e modelos de IA climática. O motivo para usar essas várias fontes de entrada é que as observações das estações meteorológicas fornecem apenas informações sobre o clima no local da estação no momento da medição. As observações da estação meteorológica podem ser muito precisas para um local específico, mas fenômenos climáticos como precipitação, especialmente de pancadas de chuva 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 não está chovendo. 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 geralmente fornecem leituras de hora em hora ou de meia em meia hora. Mesmo que sejam fornecidas quase em tempo real, ainda pode haver um pequeno atraso entre os eventos de precipitação reais e o relatório deles. Os modelos também ajudam a aproximar as condições atuais da realidade vivida 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. No lançamento inicial, vamos oferecer suporte a áreas povoadas, 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 Weather?

A resolução dos dados é tal que as previsões são criadas em um raio de poucos 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 diária Histórico por hora
Taxa de atualização 15 minutos (periodicamente dentro da hora) 30 minutos (periodicamente dentro da hora) 30 minutos (atualizada ao mesmo tempo que a previsão por hora) Duas vezes por dia (7h e 19h, horário padrão do Pacífico).

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

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

A API Weather fornece valores separados de UVA e UVB?

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

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

Como mostrado no diagrama abaixo, as previsões da API Weather são criadas com base em um sistema interno de previsão que usa modelos e observações de agências meteorológicas globais como entradas. Os dados de sensores meteorológicos públicos de informações empíricas 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 clima?

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

No mundo todo, a previsão do tempo do Google supera as previsões de agências governamentais líderes. Para a Europa e a América do Norte, os dados do Google Clima têm um erro menor do que os modelos governamentais regionais mais precisos, pelo menos na parte final 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 difícil de prever com precisão.

A Tabela 1 lista os valores médios de REMQ para todos os horizontes de previsão relevantes para cada combinação de modelo de região. Um valor menor indica um desempenho melhor. As previsões do tempo do Google têm os valores de RMSE médios 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 REMQ para cada combinação relevante de modelo regional

A Tabela 2 lista os valores médios de REMQ para os horizontes de previsão relevantes de 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 a menor RMSE média são destacados em verde escuro. Os parâmetros e os horizontes de previsão para os quais o Google tem a menor REQM média, junto com outros modelos, são destacados em verde claro.

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

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

Os dados meteorológicos históricos são principalmente resultados modelados. Embora incorpore observações de agências meteorológicas globais e modelos numéricos de previsão do tempo (NWP), elas são assimiladas no modelo do Google Tempo para criar um registro histórico completo e consistente. As medições reais das estações são consideradas "verdade fundamental" nos locais específicos, mas a distribuição global limitada as torna insuficientes para uma imagem completa do mundo.

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 precipitação 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 período e local especificados.

Como posso saber se está chovendo 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 fraca, forte, contínua ou esparsa e também para diferenciar chuva de neve. Dependendo do seu caso de uso específico (por exemplo, se ele considera apenas chuvas fortes), você pode usar apenas um subconjunto relevante dessas condições.

As "condições atuais" são equivalentes às observações nas 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 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 é uma quantidade estimada, não 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?

A API Weather tem 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ário ter uma conta de faturamento válida para usar a API Weather. Consulte Ativar o faturamento para configurar seu projeto com uma conta de faturamento.

O que acontece se eu consultar um local que não é compatível?

Se a latitude e a longitude não estiverem na lista de países aceitos, 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."