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 przedziału czasowego 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 oferty 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 jako źródło zgodnie z Dokumentacją.

1.2 Ograniczenia. Klienci nie mogą używać Treści Map Google pobranych z interfejsu Weather API do odtworzenia 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 Buforowanie. 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 buforowania
Wartości prognozy minutowej 1 godzina, po której Klient musi usunąć Treści Map Google z 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 Szerokość geograficzna żądanej lokalizacji. Wymagane
location.longitude Długość geograficzna lokalizacji, której dotyczy prośba. Wymagane
unitsSystem Żądany system jednostek. Dostępne wartości:
  • UNITS_SYSTEM_UNSPECIFIED
  • IMPERIAL
  • METRIC

Jeśli nie określono systemu jednostek, odpowiedź domyślnie używa systemu 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 dotyczące 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 przedziału czasu prognozy. Jest on ustawiony na 6 godzin po godzinie rozpoczęcia.
timeZone Strefa czasowa żądanej lokalizacji.
segments Segmenty prognozowania na poziomie minuty, oznaczone jako timeFrame.
segments.timeFrame Przedział czasu, 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 danym okresie. Wartości są podawane w procentach w zakresie od 0 do 100.
segments.qpf ilościowa prognoza opadów,
segments.qpf.quantity Przewidywana ilość opadów w tym okresie.
segments.qpf.unit Jednostka używana do pomiaru ilości opadów (np. MILLIMETERS, INCHES).
segments.snowfallAmount Przewidywana ilość śniegu w danym segmencie.
segments.snowfallAmount.quantity Przewidywana ilość śniegu (jako odpowiednik wody w stanie ciekłym) w danym okresie.
segments.snowfallAmount.unit Jednostka używana do pomiaru ilości nagromadzonego śniegu (np. MILLIMETERS, INCHES).
segments.intensity Natężenie opadów w segmencie (PrecipitationIntensity). Dostępne wartości:
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • MID_LIGHT
  • LIGHT
  • MID_MODERATE
  • MODERATE
  • MID_HEAVY
  • HEAVY

Uwaga: upewnij się, że klient może obsługiwać nieznane wartości.

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

Poniższy przykład dotyczy prośby 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"
    },
    ...
  ]
}