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

Este producto o función está en versión experimental (fase previa a la DG). Los productos y las funciones que se encuentran en la fase previa a la DG pueden tener asistencia limitada, y los cambios en estos productos y funciones podrían no ser compatibles con otras versiones de la fase previa a la DG. Las ofertas que se encuentran en la fase previa a la DG se rigen por las Condiciones Específicas del Servicio de Google Maps Platform. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

El extremo forecast:minutes proporciona pronósticos de precipitaciones de alta resolución minuto a minuto (también conocidos como nowcasting) para una ubicación determinada.

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

• La 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 finalización de cada segmento de pronóstico
• El tipo, la probabilidad, la cantidad y la intensidad de las precipitaciones predichas durante cada segmento

Nota: Es posible que los pronósticos por minuto no estén sincronizados ni alineados con los mosaicos del mapa del clima.

Condiciones

Estas condiciones se emiten en virtud de la Sección 6 (Condiciones de las ofertas anteriores a la disponibilidad general) de las Condiciones Específicas del Servicio de Google Maps Platform, según lo acordado por Google y tú.

1.1 Requisitos de atribución. El Cliente debe proporcionar a Google la atribución de acuerdo con la Documentación si usa 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 datos recuperados de la API de Weather en una app o un modelo del clima 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 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 pronóstico 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 pronóstico por minuto

Para solicitar pronósticos por minuto, envía una solicitud GET HTTP a:

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	Las coordenadas de latitud de la ubicación solicitada.	Obligatorio
location.longitude	Las coordenadas de longitud de la ubicación solicitada.	Obligatorio
unitsSystem	El sistema de unidades solicitado. Los valores incluyen lo siguiente: UNITS_SYSTEM_UNSPECIFIED IMPERIAL METRIC Si no se especifica un sistema de unidades, la respuesta se establece de forma predeterminada en METRIC.	Opcional
pageSize	Especifica la cantidad máxima de resultados que se mostrarán.	Opcional
pageToken	Un token de página recibido 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 pronóstico por minuto

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

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

Ejemplo de pronóstico por minuto

En el siguiente ejemplo, se solicita información de 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"
    },
    ...
  ]
}