Prognoza minutowa (eksperymentalna)

Punkt końcowy forecast:minutes zapewnia wysokiej rozdzielczości, minutowe prognozy opadów (znane również jako prognozy krótkoterminowe) dla danej lokalizacji.

Interfejs API zwraca te informacje dotyczące 6-godzinnego przedziału czasu:

  • czas rozpoczęcia i zakończenia okresu prognozy,
  • strefę czasową żądanej lokalizacji,
  • czas rozpoczęcia i zakończenia każdego segmentu prognozy,
  • Przewidywany typ, prawdopodobieństwo, ilość i intensywność opadów w każdym segmencie

Warunki

Te warunki są wydawane na podstawie artykułu 6 (Warunki ofert przed GA) Szczegółowych warunków korzystania z usługi Google Maps Platform, które zostały uzgodnione przez Google i Ciebie.

1.1 Wymagania dotyczące podania źródła. Jeśli Klient korzysta z treści Map Google z interfejsu Weather API, musi podać Google informacje o autorstwie zgodnie z Dokumentacją.

1.2 Ograniczenia. Klienci nie mogą używać treści z Map Google pobranych z interfejsu Weather API do odtwarzania usługi lub produktu Google (np. używać danych pobranych z interfejsu Weather API w aplikacji pogodowej lub modelu pogodowym, których głównym celem jest dostarczanie informacji o pogodzie).

1.3 Zapisywanie w pamięci podręcznej. Klienci mogą tymczasowo zapisywać w pamięci podręcznej odpowiednie Treści Map Google z interfejsu Weather API przez odpowiedni Okres przechowywania w pamięci podręcznej, zgodnie z opisem w tabeli 1.3.1 (Uprawnienia do zapisywania w pamięci podręcznej).

Tabela 1.3.1 (Uprawnienia do buforowania)

Te uprawnienia stanowią uzupełnienie uprawnień opisanych w tabeli 17.2.1 Szczegółowych warunków korzystania z usługi Google Maps Platform.

Treści w Mapach Google Okres przechowywania w pamięci podręcznej
Wartości prognozy minutowej 1 godzina, po której Klient musi usunąć treści Map Google zapisane w pamięci podręcznej.

Informacje o prośbach o prognozę minutową

Aby poprosić o prognozy minutowe, wyślij żądanie GET HTTP na adres:

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

W parametrach żądania podaj współrzędne szerokości i długości geograficznej lokalizacji.

Parametry żądania

Punkt końcowy forecast.minutes akceptuje te parametry żądania:

Parametr Opis Wymagana czy opcjonalna
location.latitude Współrzędne szerokości geograficznej żądanej lokalizacji. Wymagane
location.longitude Współrzędne długości geograficznej żądanej lokalizacji. Wymagane
unitsSystem Żądany system jednostek. Dostępne wartości:
  • UNITS_SYSTEM_UNSPECIFIED
  • IMPERIAL
  • METRIC

Jeśli nie określisz systemu jednostek, w odpowiedzi zostanie użyty domyślny system METRIC.

 Opcjonalny
pageSize Określa maksymalną liczbę wyników do zwrócenia. Opcjonalny
pageToken Token strony otrzymany z poprzedniego żądania. Aby pobrać następną stronę danych, przekaż pageToken jako parametr wejściowy w następnym żądaniu. Opcjonalny

Odpowiedzi prognozy minutowej

Interfejs Weather API zwraca w treści odpowiedzi te pola:

Pole Opis
overallPredictionTimeframe Ogólny przedział czasu prognoz.
overallPredictionTimeframe.startTime Czas rozpoczęcia przedziału czasowego prognozy. Odzwierciedla to początkowy punkt odniesienia.
overallPredictionTimeframe.endTime Czas zakończenia okresu prognozowania. Jest on ustawiony na 6 godzin po godzinie rozpoczęcia.
timeZone Strefa czasowa wybranej lokalizacji.
segments Segmenty prognozowania na poziomie minuty, oznaczone symbolem timeFrame.
segments.timeFrame Okres, którego dotyczy segment.
segments.timeFrame.startTime Czas rozpoczęcia segmentu.
segments.timeFrame.endTime Czas zakończenia segmentu.
segments.type Przewidywany typ opadów w danym segmencie. Dostępne wartości:
  • DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED
  • NONE
  • RAIN
  • SNOW
  • HAIL
segments.probability Przewidywane prawdopodobieństwo wystąpienia opadów w tym segmencie. Wartości są podawane w procentach w zakresie od 0 do 100.
segments.qpf ilościowa prognoza opadów,
segments.qpf.quantity Prognozowana ilość opadów w danym segmencie.
segments.qpf.unit Jednostka używana do pomiaru ilości skumulowanych opadów (np. MILLIMETERS, INCHES).
segments.snowfallAmount Prognozowana ilość śniegu w danym segmencie.
segments.snowfallAmount.quantity Przewidywana ilość śniegu (jako odpowiednik wody w stanie ciekłym) w danym segmencie.
segments.snowfallAmount.unit Jednostka używana do pomiaru ilości nagromadzonego śniegu (np. MILLIMETERS, INCHES).
segments.intensity Intensywność opadów w segmencie. Dostępne wartości:
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • LIGHT
  • MODERATE
  • HEAVY
nextPageToken Token, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Przykład prognozy minutowej

W przykładzie poniżej wysyłamy prośbę o prognozę minutową dla lokalizacji w stanie Wirginia Zachodnia:

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"

W odpowiedzi obiekt segments wskazuje każdy segment ogólnego przedziału czasu prognozy:

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