Prognoza minutowa (eksperymentalna)

Punkt końcowy forecast:minutes zapewnia prognozy opadów w wysokiej rozdzielczości, z dokładnością do minuty (znane też jako nowcasting) dla danej lokalizacji.

Interfejs API zwraca te informacje w 6-godzinnym przedziale czasu:

  • czas rozpoczęcia i zakończenia przedziału czasu 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 zgodnie z sekcją 6 (Warunki ofert przed GA) Szczegółowych warunków korzystania z usługi Google Maps Platform Terms, które zostały uzgodnione przez Google i Ciebie.

1.1 Wymagania dotyczące atrybucji. Jeśli Klient korzysta z Treści Map Google z interfejsu Weather API, musi podać Google atrybucję w zgodzie z Dokumentacją.

1.2 Ograniczenia. Klienci nie mogą używać Treści 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 Pamięć podręczna. 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 przechowywania w pamięci podręcznej).

Tabela 1.3.1 (Uprawnienia do przechowywania w pamięci podręcznej)

Te uprawnienia są dodatkowe w stosunku do uprawnień opisanych w tabeli 17.2.1 Szczegółowych warunków korzystania z usługi Google Maps Platform.

Treści Map Google Okres przechowywania w pamięci podręcznej
Wartości prognoz minutowych Godzina, po której Klient musi usunąć Treści Map Google zapisane w pamięci podręcznej

Informacje o żądaniach prognoz minutowych

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 uwzględnij współrzędne geograficzne (szerokość i długość) lokalizacji.

Parametry żądania

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

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

Jeśli nie określono systemu jednostek, w odpowiedzi domyślnie używany jest 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

Informacje o odpowiedziach na żądania prognoz minutowych

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

Pole Opis
overallPredictionTimeframe Ogólny przedział czasu prognoz.
overallPredictionTimeframe.startTime Godzina rozpoczęcia przedziału czasu prognozy. Odzwierciedla początkowy punkt odniesienia.
overallPredictionTimeframe.endTime Godzina zakończenia przedziału czasu prognozy. Jest ustawiana na 6 godzin po godzinie rozpoczęcia.
timeZone Strefa czasowa żądanej lokalizacji.
segments Segmenty prognozy na poziomie minutowym, oznaczone przez timeFrame.
segments.timeFrame Przedział czasu odpowiedni dla segmentu.
segments.timeFrame.startTime Godzina rozpoczęcia segmentu.
segments.timeFrame.endTime Godzina zakończenia segmentu.
segments.type Przewidywany typ opadów w tym 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 od 0 do 100.
segments.qpf Prognozowana wielkość opadów.
segments.qpf.quantity Przewidywana ilość opadów w tym segmencie.
segments.qpf.unit Jednostka używana do pomiaru ilości skumulowanych opadów (np. MILLIMETERS, INCHES).
segments.snowfallAmount Przewidywana ilość śniegu w tym segmencie.
segments.snowfallAmount.quantity Przewidywana ilość śniegu (w przeliczeniu na wodę w stanie ciekłym) w tym segmencie.
segments.snowfallAmount.unit Jednostka używana do pomiaru ilości skumulowanego ś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

Ten przykład pokazuje, jak poprosić o informacje o prognozie minutowej dla lokalizacji w Wirginii Zachodniej:

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