Method: forecast.days.lookup

Zwraca prognozy dzienne na maksymalnie 10 dni w danym miejscu, począwszy 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 ma być wyświetlana prognoza dzienna.
unitsSystem

enum (UnitsSystem)

Opcjonalnie: System jednostek, który ma być używany w przypadku zwracanych warunków pogodowych. Jeśli nie podasz tego parametru, 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 stronie – 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 następnej strony.
days

integer

Opcjonalnie: Ogranicza liczbę dni do pobrania, począwszy od bieżącego dnia – wartość od 1 do 10 (włącznie). Wartość domyślna to maksymalna dozwolona wartość 10.
languageCode

string

Opcjonalnie: Umożliwia klientowi wybór języka odpowiedzi. Jeśli dane nie mogą zostać podane w danym języku, interfejs API używa najbliższego dopasowania. Dozwolone wartości są zgodne ze standardem IETF BCP-47. Wartość domyślna to „en”.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na wywołanie 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 żądanej lokalizacji.
nextPageToken

string

Token do pobrania następnej strony.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

ForecastDay

Reprezentuje rekord prognozy dziennej 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)
  }
}
Pola
interval

object (Interval)

Przedział czasu UTC, w którym rozpoczyna się (włącznie) i kończy (wyłącznie) prognozowany dzień. Uwaga: dzień zaczyna się o 7:00 i kończy o 7:00 następnego dnia czasu lokalnego. Jeśli na przykład lokalna strefa czasowa 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)

Lokalna data w strefie czasowej lokalizacji (czas cywilny), dla której obliczana jest prognoza dzienna. To pole może być używane do wyświetlania informacji na urządzeniu klienta.
daytimeForecast

object (ForecastDayPart)

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

object (ForecastDayPart)

Prognozowane warunki pogodowe w nocy (od 19:00 do 7:00 następnego dnia czasu lokalnego).
maxTemperature

object (Temperature)

Maksymalna temperatura w ciągu dnia.
minTemperature

object (Temperature)

Minimalna (najniższa) temperatura w ciągu dnia.
feelsLikeMaxTemperature

object (Temperature)

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

object (Temperature)

Minimalna (najniższa) temperatura odczuwalna w ciągu dnia.
maxHeatIndex

object (Temperature)

Maksymalna temperatura odczuwalna w ciągu dnia.
sunEvents

object (SunEvents)

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

object (MoonEvents)

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

Data

Reprezentuje pełną lub częściową datę kalendarzową, np. datę urodzin. Pora dnia i strefa czasowa są określone w innym miejscu lub nie mają znaczenia. Data jest podana w kalendarzu gregoriańskim. Może to być jedna z tych wartości:

  • Pełna data z wartościami roku, miesiąca i dnia różnymi od zera.
  • Miesiąc i dzień z zerowym rokiem (np. rocznica).
  • Sam rok, z miesiącem i dniem o wartości zero.
  • Rok i miesiąc z dniem zerowym (np. data ważności karty kredytowej).

Powiązane typy:

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

integer

Rok daty. Musi mieścić się w zakresie od 1 do 9999 lub wynosić 0, jeśli określasz datę bez roku.
month

integer

Miesiąc roku. Musi mieścić się w zakresie od 1 do 12 lub wynosić 0, jeśli określasz rok bez miesiąca i dnia.
day

integer

Dzień miesiąca. Wartość musi mieścić się w zakresie od 1 do 31 i być prawidłowa w przypadku danego roku i miesiąca lub wynosić 0, jeśli określasz sam rok albo rok i miesiąc, w których dzień nie ma znaczenia.

ForecastDayPart

Reprezentuje rekord prognozy dla części dnia.

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

object (Interval)

Data i godzina w czasie UTC, kiedy rozpoczyna się (włącznie) i kończy (wyłącznie) ta część dnia. Uwaga: część dnia rozpoczyna się o 7:00 i kończy o 19:00 tego samego dnia czasu lokalnego. Przykład: jeśli lokalna strefa czasowa to UTC-7, przedział czasu w ciągu dnia rozpocznie się o godzinie 14:00:00.000Z i zakończy o godzinie 02:00:00.000Z następnego dnia, a przedział czasu w nocy rozpocznie się o godzinie 02:00:00.000Z następnego dnia i zakończy o godzinie 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 maksymalna prędkość i porywy wiatru;
iceThickness

object (IceThickness)

Łączna ilość lodu w danym okresie dnia.
relativeHumidity

integer

Prognozowany procent wilgotności względnej (wartości od 0 do 100).
uvIndex

integer

Maksymalny prognozowany indeks ultrafioletowy (UV).
thunderstormProbability

integer

Średnie prawdopodobieństwo wystąpienia burzy z piorunami.
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)

Godzina wschodu słońca.

UWAGA: w niektórych wyjątkowych przypadkach (np. na północ od koła podbiegunowego) w danym dniu może nie być wschodu słońca. W takich przypadkach to pole zostanie wyczyszczone.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane 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)

Godzina zachodu słońca.

UWAGA: w niektórych wyjątkowych przypadkach (np. na północ od koła podbiegunowego) może nie być czasu zachodu słońca w danym dniu. W takich przypadkach to pole zostanie wyczyszczone.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane 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 wschód Księżyca. W innych przypadkach lista może być pusta (np. gdy księżyc wschodzi po północy następnego dnia). W wyjątkowych przypadkach (np. w regionach polarnych) lista może zawierać więcej niż 1 wartość. W takich przypadkach wartości są sortowane w kolejności rosnącej.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane 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)

Moment, 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 każdego dnia będzie tylko 1 godzina zachodu Księżyca. W innych przypadkach lista może być pusta (np. gdy księżyc zachodzi po północy następnego dnia). W wyjątkowych przypadkach (np. w regionach polarnych) lista może zawierać więcej niż 1 wartość. W takich przypadkach wartości są sortowane w kolejności rosnącej.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane 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.

MoonPhase

Oznacza fazę księżyca.

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 w 0–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 W przypadku półkuli północnej Księżyc jest oświetlony w 50–100% po lewej stronie 🌖, a w przypadku półkuli południowej – po prawej stronie 🌔.
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 W przypadku półkuli północnej oświetlona jest lewa strona Księżyca (0–50%) 🌘, a w przypadku półkuli południowej – prawa strona (0–50%) 🌒.