Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Obtén el pronóstico por minuto (experimental)

El extremo forecast:minutes proporciona una previsión de precipitaciones de alta resolución minuto a minuto (también conocida como previsión inmediata) para una ubicación determinada.

La API devuelve la siguiente información para un período de 6 horas:

Hora de inicio y finalización del período de predicción
La zona horaria de la ubicación solicitada
La hora de inicio y de finalización de cada segmento de previsión
El tipo, la probabilidad, la cantidad y la intensidad previstas de las precipitaciones durante cada segmento

Condiciones

Estas condiciones se emiten en virtud del Artículo 6 (Condiciones de las Ofertas Previas a la DG) de las Condiciones Específicas del Servicio de Google Maps Platform, según lo acordado entre Google y tú.

1.1 Requisitos de Atribución. El Cliente debe proporcionar la atribución a Google de conformidad con la Documentación si utiliza Contenido de Google Maps de la API de Weather.

1.2 Restricciones. Los clientes no pueden usar el Contenido de Google Maps recuperado de la API de Weather para recrear un servicio o producto de Google (p.ej., usar los datos recuperados de la API de Weather en una app o un modelo meteorológico cuyo propósito principal sea proporcionar información sobre el clima).

1.3 Almacenamiento en caché. Los clientes pueden almacenar en caché temporalmente el Contenido de Google Maps aplicable de la API de Weather durante el Período de Almacenamiento en Caché aplicable, como se describe en la Tabla 1.3.1 (Permisos de Almacenamiento en Caché).

Tabla 1.3.1 (permisos de almacenamiento en caché)

Estos permisos se suman a los que se describen en la Tabla 17.2.1 de las Condiciones Específicas del Servicio de Google Maps Platform.

Contenido de Google Maps	Período de almacenamiento en caché
Valores de previsión por minuto	Una hora, después de la cual el Cliente debe borrar el Contenido de Google Maps almacenado en caché

Acerca de las solicitudes de previsión por minuto

Para solicitar previsiones por minuto, envía una solicitud GET a la siguiente URL:

https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE

Incluye las coordenadas de latitud y longitud de la ubicación en los parámetros de la solicitud.

Parámetros de solicitud

El extremo forecast.minutes acepta los siguientes parámetros de solicitud:

Parámetro	Descripción	Obligatorio u opcional
`location.latitude`	Son las coordenadas de latitud de la ubicación solicitada.	Obligatorio
`location.longitude`	Son las coordenadas de longitud de la ubicación solicitada.	Obligatorio
`unitsSystem`	Es el sistema de unidades solicitado. Entre los valores, se incluyen los siguientes: `UNITS_SYSTEM_UNSPECIFIED` `IMPERIAL` `METRIC` Si no se especifica ningún sistema de unidades, la respuesta se establece de forma predeterminada en `METRIC`.	Opcional
`pageSize`	Especifica la cantidad máxima de resultados que se devolverán.	Opcional
`pageToken`	Es un token de página que se recibió de una solicitud anterior. Para recuperar la siguiente página de datos, pasa `pageToken` como parámetro de entrada en la siguiente solicitud.	Opcional

Acerca de las respuestas de previsión por minuto

La API de Weather devuelve los siguientes campos en el cuerpo de la respuesta:

Campo	Descripción
`overallPredictionTimeframe`	Es el período general para las predicciones.
`overallPredictionTimeframe.startTime`	Es la hora de inicio del período de predicción. Esto refleja el punto de referencia inicial.
`overallPredictionTimeframe.endTime`	Es la hora de finalización del período de predicción. Esta se establece seis horas después de la hora de inicio.
`timeZone`	Zona horaria de la ubicación solicitada.
`segments`	Los segmentos de predicción a nivel de minutos, indicados por `timeFrame`.
`segments.timeFrame`	Es el período pertinente para el segmento.
`segments.timeFrame.startTime`	Es la hora de inicio del segmento.
`segments.timeFrame.endTime`	Es la hora de finalización del segmento.
`segments.type`	Es el tipo de precipitación previsto durante ese segmento. Entre los valores, se incluyen los siguientes: `DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED` `NONE` `RAIN` `SNOW` `HAIL`
`segments.probability`	La probabilidad prevista de precipitaciones durante ese segmento. Los valores son porcentajes que van del 0 al 100.
`segments.qpf`	Es el pronóstico cuantitativo de precipitaciones.
`segments.qpf.quantity`	La cantidad prevista de precipitaciones durante ese segmento.
`segments.qpf.unit`	Unidad que se usa para medir la cantidad de precipitación acumulada (por ejemplo, `MILLIMETERS`, `INCHES`).
`segments.snowfallAmount`	Es la cantidad de nieve prevista durante ese segmento.
`segments.snowfallAmount.quantity`	Cantidad de nieve prevista (como equivalente de agua líquida) durante ese segmento.
`segments.snowfallAmount.unit`	Es la unidad que se usa para medir la cantidad de nieve acumulada (por ejemplo, `MILLIMETERS` o `INCHES`).
`segments.intensity`	La intensidad de la precipitación del segmento. Entre los valores, se incluyen los siguientes: `PRECIPITATION_INTENSITY_UNSPECIFIED` `NO_INTENSITY` `LIGHT` `MODERATE` `HEAVY`
`nextPageToken`	Es un token que se puede enviar como `pageToken` para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Ejemplo de previsión por minuto

En el siguiente ejemplo, se solicita información del pronóstico por minuto para una ubicación en Virginia Occidental:

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"

En la respuesta, el objeto segments indica cada segmento del período de predicción general:

  {
  "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"
    },
    ...
  ]
}