O endpoint forecast:minutes fornece previsão de precipitação de alta resolução, minuto a minuto (também conhecida como previsão imediata) para um determinado local.
A API retorna as seguintes informações para um período de 6 horas:
- Os horários de início e término do período de previsão
- O fuso horário do local solicitado
- Os horários de início e término de cada segmento de previsão
- O tipo, a probabilidade, a quantidade e a intensidade previstas de precipitação durante cada segmento
Termos
Estes termos são emitidos de acordo com a Seção 6 (Termos das Soluções pré-GA) dos Termos de Serviço específicos da Plataforma Google Maps, conforme acordado entre o Google e você.
1.1 Requisitos de atribuição. O Cliente precisa fornecer ao Google a atribuição de acordo com a Documentação se usar o Conteúdo do Google Maps da API Weather.
1.2 Restrições. Os clientes não podem usar o conteúdo do Google Maps recuperado da API Weather para recriar um serviço ou produto do Google (por exemplo, usar dados recuperados da API Weather em um app ou modelo de clima cujo objetivo principal seja fornecer informações meteorológicas).
1.3 Armazenamento em cache. Os clientes podem armazenar temporariamente em cache o Conteúdo do Google Maps aplicável da API Weather durante o Período de armazenamento em cache aplicável, conforme descrito na Tabela 1.3.1 (Permissões de armazenamento em cache).
Tabela 1.3.1 (permissões de cache)
Essas permissões são adicionais às descritas na Tabela 17.2.1 dos Termos de Serviço específicos da Plataforma Google Maps.
| Conteúdo do Google Maps | Período de armazenamento em cache |
|---|---|
| Valores de previsão por minuto | Uma hora, após a qual o Cliente precisa excluir o Conteúdo do Google Maps armazenado em cache. |
Sobre as solicitações de previsão por minuto
Para solicitar previsões por minuto, envie uma solicitação GET HTTP para:
https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE
Inclua as coordenadas de latitude e longitude do local nos parâmetros da solicitação.
Parâmetros de solicitação
O endpoint forecast.minutes aceita os seguintes parâmetros de solicitação:
| Parâmetro | Descrição | Obrigatório ou opcional |
|---|---|---|
location.latitude |
As coordenadas de latitude do local solicitado. | Obrigatório |
location.longitude |
As coordenadas de longitude do local solicitado. | Obrigatório |
unitsSystem |
O sistema de unidades solicitado. Os valores incluem:
Se nenhum sistema de unidades for especificado, a resposta vai usar |
Opcional |
pageSize |
Especifica o número máximo de resultados a serem retornados. | Opcional |
pageToken |
Um token de página recebido de uma solicitação anterior. Para recuperar a próxima página de dados, transmita pageToken como um parâmetro de entrada na próxima solicitação. |
Opcional |
Sobre as respostas de previsão por minuto
A API Weather retorna os seguintes campos no corpo da resposta:
| Campo | Descrição |
|---|---|
overallPredictionTimeframe |
O período geral das previsões. |
overallPredictionTimeframe.startTime |
O horário de início do período de previsão. Isso reflete o ponto de referência inicial. |
overallPredictionTimeframe.endTime |
O horário de término do período de previsão. Isso é definido seis horas após o horário de início. |
timeZone |
O fuso horário do local solicitado. |
segments |
Os segmentos de previsão por minuto, indicados por timeFrame. |
segments.timeFrame |
O período relevante para o segmento. |
segments.timeFrame.startTime |
O horário de início do segmento. |
segments.timeFrame.endTime |
O horário de término do segmento. |
segments.type |
O tipo previsto de precipitação durante esse segmento. Os valores incluem:
|
segments.probability |
A chance prevista de precipitação durante esse período. Os valores são porcentagens que variam de 0 a 100. |
segments.qpf |
A previsão quantitativa de precipitação. |
segments.qpf.quantity |
A quantidade prevista de precipitação durante esse segmento. |
segments.qpf.unit |
A unidade usada para medir a quantidade de precipitação acumulada (por exemplo, MILLIMETERS, INCHES). |
segments.snowfallAmount |
A quantidade prevista de neve durante esse segmento. |
segments.snowfallAmount.quantity |
A quantidade prevista de neve (como equivalente de água líquida) durante esse segmento. |
segments.snowfallAmount.unit |
A unidade usada para medir a quantidade de neve acumulada (por exemplo, MILLIMETERS, INCHES). |
segments.intensity |
A intensidade da precipitação do segmento. Os valores incluem:
|
nextPageToken |
Um token que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes. |
Exemplo de previsão por minuto
O exemplo a seguir solicita informações de previsão por minuto para um local na Virgínia Ocidental:
curl -H "Content-Type: application/json" -X GET "https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=37.60451&location.longitude=-80.59044&unitsSystem=METRIC&pageSize=5"
Na resposta, o objeto segments indica cada segmento do período geral de previsão:
{ "overallPredictionTimeframe": { "startTime": "2026-05-11T12:10:00Z", "endTime": "2026-05-11T18:12:00Z" }, "timeZone": { "id": "America/New_York" }, "segments": [ { "timeFrame": { "startTime": "2026-05-11T12:20:00Z", "endTime": "2026-05-11T12:22:00Z" }, "type": "RAIN", "probability": 21, "qpf": { "quantity": 0.1333, "unit": "MILLIMETERS" }, "snowfallAmount": { "quantity": 0.0, "unit": "MILLIMETERS" }, "intensity": "MODERATE" }, { "timeFrame": { "startTime": "2026-05-11T12:22:00Z", "endTime": "2026-05-11T12:24:00Z" }, "type": "RAIN", "probability": 21, "qpf": { "quantity": 0.1333, "unit": "MILLIMETERS" }, "snowfallAmount": { "quantity": 0.0, "unit": "MILLIMETERS" }, "intensity": "MODERATE" }, ... ] }