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:
Jeśli nie określono systemu jednostek, odpowiedź domyślnie używa systemu |
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:
|
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:
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" }, ... ] }