Method: forecast.days.lookup

Zwraca prognozy dzienne na 10 dni w danej lokalizacji, licząc od bieżącego dnia.

Żądanie HTTP

GET https://weather.googleapis.com/v1/forecast/days:lookup

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
location

object (LatLng)

Wymagane. Lokalizacja, dla której chcesz uzyskać prognozę na dany dzień.
unitsSystem

enum (UnitsSystem)

Opcjonalnie: System jednostek do zastosowania w przypadku zwracanych warunków pogodowych. Jeśli nie podasz tej wartości, zwrócone warunki pogodowe będą podane w systemie metrycznym (domyślnie = METRIC).
pageSize

integer

Opcjonalnie: Maksymalna liczba rekordów prognozy dziennej do zwrócenia na stronę – wartość od 1 do 10 włącznie. Wartością domyślną jest 5.
pageToken

string

Opcjonalnie: Token strony otrzymany z poprzedniego żądania. Służy do pobierania kolejnych stron.
days

integer

Opcjonalnie: Ogranicza łączną liczbę dni do pobrania od bieżącego dnia – wartość od 1 do 10 (włącznie). Wartością domyślną jest maksymalna dozwolona wartość 10.
languageCode

string

Opcjonalnie: Umożliwia klientowi wybór języka odpowiedzi. Jeśli nie można podać danych w tym języku, interfejs API stosuje najbliższe dopasowanie. Dozwolone wartości są zgodne ze standardem IETF BCP-47. Wartość domyślna to „pl”.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź dla wywołania RPC days.lookup.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "forecastDays": [
    {
      object (ForecastDay)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Pola
forecastDays[]

object (ForecastDay)

Rekordy prognozy dziennej zgodnie z liczbą dni i rozmiarem strony określonymi w żądaniu.
timeZone

object (TimeZone)

Strefa czasowa w wybranym miejscu.
nextPageToken

string

Token do pobierania następnej strony.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/cloud-platform

ForecastDay

Reprezentuje rekord dziennej prognozy w danej lokalizacji.

Zapis JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDate": {
    object (Date)
  },
  "daytimeForecast": {
    object (ForecastDayPart)
  },
  "nighttimeForecast": {
    object (ForecastDayPart)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "feelsLikeMaxTemperature": {
    object (Temperature)
  },
  "feelsLikeMinTemperature": {
    object (Temperature)
  },
  "maxHeatIndex": {
    object (Temperature)
  },
  "sunEvents": {
    object (SunEvents)
  },
  "moonEvents": {
    object (MoonEvents)
  },
  "iceThickness": {
    object (IceThickness)
  }
}
Pola
interval

object (Interval)

Interwał czasu UTC, w którym zaczyna się (włącznie) i kończy (wyłącznie) prognozowany dzień. Uwaga: dzień zaczyna się o 7:00 rano i kończy o 7:00 rano następnego dnia czasu lokalnego. Jeśli na przykład strefa czasowa lokalna to UTC-7, przedział czasu rozpocznie się o godzinie 14:00:00.000Z i zakończy o tej samej godzinie następnego dnia.
displayDate

object (Date)

Data lokalna w strefie czasowej miejsca (czas cywilny), dla którego obliczono tę prognozę dzienną. To pole może być używane do wyświetlania danych na kliencie.
daytimeForecast

object (ForecastDayPart)

prognozowane warunki pogodowe w ciągu dnia (od 7:00 do 19:00 czasu lokalnego);
nighttimeForecast

object (ForecastDayPart)

prognozowane warunki pogodowe na noc (od 19:00 do 7:00 następnego dnia czasu lokalnego).
maxTemperature

object (Temperature)

Maksymalna (wysoka) temperatura w ciągu dnia.
minTemperature

object (Temperature)

Minimalna (niska) temperatura w ciągu dnia.
feelsLikeMaxTemperature

object (Temperature)

Maksymalna (wysoka) temperatura odczuwalna w ciągu dnia.
feelsLikeMinTemperature

object (Temperature)

Minimalna (niska) odczuwalna temperatura w ciągu dnia.
maxHeatIndex

object (Temperature)

Maksymalna temperatura według indeksu ciepła w ciągu dnia.
sunEvents

object (SunEvents)

Zdarzenia związane ze słońcem (np. wschód, zachód).
moonEvents

object (MoonEvents)

Zdarzenia związane z księżycem (np. wschód i zachód).
iceThickness

object (IceThickness)

Nagromadzona ilość lodu w ciągu całego dnia.

Data

Reprezentuje całą lub częściową datę kalendarzową, np. urodziny. Godzina i strefa czasowa są określone w innym miejscu lub nie mają znaczenia. Data jest podawana w kalendarzu gregoriańskim. Może to być:

  • Pełna data z wartościami roku, miesiąca i dnia innymi niż 0.
  • miesiąc i dzień z zerowym rokiem (np. rocznica).
  • Rok bez miesiąca i dnia.
  • Rok i miesiąc z zerowym dniem (np. data ważności karty kredytowej).

Powiązane typy:

Zapis JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Musi być liczbą z zakresu od 1 do 9999 lub 0, jeśli chcesz podać datę bez roku.
month

integer

Miesiąc w roku. Wartość musi mieścić się w przedziale od 1 do 12, lub 0, jeśli chcesz określić rok bez miesiąca i dnia.
day

integer

Dzień miesiąca. Musi zawierać wartość od 1 do 31 i być prawidłową dla roku lub miesiąca albo 0, aby określić tylko rok lub rok i miesiąc, w których przypadku dzień nie ma znaczenia.

ForecastDayPart

Reprezentuje rekord prognozy na część dnia.

Zapis JSON 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Pola
interval

object (Interval)

Data i godzina według czasu UTC, kiedy ta część dnia zaczyna się (włącznie) i kończy (wyłącznie). Uwaga: część dnia rozpoczyna się o 7:00 rano i kończy o 19:00 tego samego dnia czasu lokalnego. Jeśli na przykład strefa czasu lokalnego to UTC-7, interwał dzienny rozpocznie się o godzinie 14:00:00.000Z i zakończy o 02:00:00.000Z następnego dnia, a interwał nocny rozpocznie się o 02:00:00.000Z następnego dnia i zakończy o 14:00:00.000Z tego samego dnia.
weatherCondition

object (WeatherCondition)

Prognozowane warunki pogodowe.
precipitation

object (Precipitation)

prognozowane opady;
wind

object (Wind)

Średni kierunek wiatru oraz jego maksymalna prędkość i porywy.
relativeHumidity

integer

Przewidywana wilgotność względna w procentach (wartości od 0 do 100).
uvIndex

integer

Maksymalny prognozowany indeks ultrafioletu (UV).
thunderstormProbability

integer

Średnie prawdopodobieństwo burzy.
cloudCover

integer

Średni procent zachmurzenia.

SunEvents

Reprezentuje zdarzenia związane ze słońcem (np. wschód i zachód słońca).

Zapis JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Pola
sunriseTime

string (Timestamp format)

Czas, w którym wschodzi słońce.

UWAGA: w niektórych wyjątkowych przypadkach (np. na północ od koła podbiegunowego) w ciągu dnia może nie być wschodu słońca. W takich przypadkach to pole nie będzie ustawione.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
sunsetTime

string (Timestamp format)

Czas, w którym zachodzi słońce.

UWAGA: w niektórych wyjątkowych przypadkach (np. na północ od koła podbiegunowego) w ciągu dnia może nie być zachodu słońca. W takich przypadkach to pole nie będzie ustawione.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

MoonEvents

Reprezentuje wydarzenia związane z księżycem (np. wschód i zachód księżyca).

Zapis JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Pola
moonriseTimes[]

string (Timestamp format)

Czas, w którym górna krawędź księżyca pojawia się nad horyzontem (patrz https://en.wikipedia.org/wiki/Moonrise_and_moonset).

UWAGA: w większości przypadków w ciągu dnia występuje tylko 1 czas wschodu księżyca. W innych przypadkach lista może być pusta (np. gdy księżyc wschodzi po północy następnego dnia). W niektórych przypadkach (np. w regionach polarnych) lista może zawierać więcej niż jedną wartość. W takich przypadkach wartości są sortowane w kolejności rosnącej.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
moonsetTimes[]

string (Timestamp format)

Czas, w którym górna krawędź Księżyca znika poniżej horyzontu (patrz https://en.wikipedia.org/wiki/Moonrise_and_moonset).

UWAGA: w większości przypadków w ciągu dnia występuje tylko 1 czas zachodu Księżyca. W innych przypadkach lista może być pusta (np. gdy księżyc zachodzi po północy następnego dnia). W niektórych przypadkach (np. w regionach polarnych) lista może zawierać więcej niż jedną wartość. W takich przypadkach wartości są sortowane w kolejności rosnącej.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

faza księżyca (inaczej faza księżycowa).

MoonPhase

Oznacza fazę księżyca (inaczej fazę księżycową).

Wartości w polu enum
MOON_PHASE_UNSPECIFIED Nieokreślona faza księżyca.
NEW_MOON Księżyc nie jest oświetlony przez Słońce.
WAXING_CRESCENT Księżyc jest oświetlony od 0% do 50% po prawej stronie na półkuli północnej 🌒 i po lewej stronie na półkuli południowej 🌘.
FIRST_QUARTER Księżyc jest oświetlony w 50,1% po prawej stronie na półkuli północnej 🌓 i po lewej stronie na półkuli południowej 🌗.
WAXING_GIBBOUS Księżyc jest oświetlony w 50–100% po prawej stronie na półkuli północnej 🌔 i po lewej stronie na półkuli południowej 🌖.
FULL_MOON Księżyc jest w pełni oświetlony.
WANING_GIBBOUS Księżyc jest oświetlony w 50–100% po lewej stronie na półkuli północnej 🌖 i po prawej stronie na półkuli południowej 🌔.
LAST_QUARTER Księżyc jest oświetlony w 50,1% po lewej stronie na półkuli północnej 🌗 i po prawej stronie na półkuli południowej 🌓.
WANING_CRESCENT Księżyc jest oświetlony w 90–50% po lewej stronie na półkuli północnej 🌘 i po prawej stronie na półkuli południowej 🌒.