O endpoint forecast:minutes fornece previsões de precipitação de alta resolução, minuto a minuto (também conhecidas como nowcasting) para um local específico.
A API retorna as seguintes informações para um período de seis horas:
- Horário de início e término do período de previsão
- Fuso horário do local solicitado
- Horário de início e término de cada segmento de previsão
- Tipo, probabilidade, quantidade e intensidade previstos de precipitação durante cada segmento
Termos
Esses termos são emitidos de acordo com a seção 6 (Termos de ofertas pré-disponibilidade geral) 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 atribuição ao Google 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 meteorológico cujo objetivo principal seja fornecer informações sobre o clima).
1.3 Armazenamento em cache. Os clientes podem armazenar temporariamente em cache o conteúdo aplicável do Google Maps da API Weather para 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 armazenamento em 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 de minutos | Uma hora, após a qual o cliente precisa excluir o conteúdo do Google Maps armazenado em cache |
Sobre solicitações de previsão de minutos
Para solicitar previsões de minutos, 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 será definida como |
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 respostas de previsão de minutos
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. Ele é 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 de minutos, 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 probabilidade prevista de precipitação durante esse segmento. Os valores estão em 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 de 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 de minutos
O exemplo a seguir solicita informações de previsão de minutos 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 de previsão geral:
{ "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" }, ... ] }