Method: currentConditions.lookup

Zwraca aktualne warunki pogodowe w danej lokalizacji.

Żądanie HTTP

GET https://weather.googleapis.com/v1/currentConditions:lookup

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
location

object (LatLng)

Wymagane. Lokalizacja, dla której chcesz uzyskać aktualne warunki pogodowe.

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).

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 currentConditions.lookup – zawiera aktualne warunki pogodowe w wybranej lokalizacji.

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

Zapis JSON
{
  "currentTime": string,
  "timeZone": {
    object (TimeZone)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "currentConditionsHistory": {
    object (CurrentConditionsHistory)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Pola
currentTime

string (Timestamp format)

Aktualny czas (UTC) powiązany ze zwróconymi danymi.

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".

timeZone

object (TimeZone)

Strefa czasowa w żądanej lokalizacji.

weatherCondition

object (WeatherCondition)

Aktualne warunki pogodowe.

temperature

object (Temperature)

bieżąca temperatura,

feelsLikeTemperature

object (Temperature)

Miara tego, jak temperatura jest obecnie odczuwana w wybranej lokalizacji.

dewPoint

object (Temperature)

bieżąca temperatura punktu rosy,

heatIndex

object (Temperature)

bieżąca temperatura odczuwalna,

windChill

object (Temperature)

Aktualna temperatura odczuwalna, czyli temperatura powietrza odczuwana na skórze.

precipitation

object (Precipitation)

Aktualne prawdopodobieństwo opadów i ilość opadów z ostatniej godziny.

airPressure

object (AirPressure)

Aktualne warunki ciśnienia powietrza.

wind

object (Wind)

bieżące warunki wiatrowe,

visibility

object (Visibility)

bieżąca widoczność,

currentConditionsHistory

object (CurrentConditionsHistory)

Zmiany w obecnych warunkach w ciągu ostatnich 24 godzin.

isDaytime

boolean

Wartość „true”, jeśli bieżąca godzina w żądanej lokalizacji przypada między lokalnym wschodem słońca (włącznie) a zachodem słońca (wyłącznie). W przeciwnym razie jest noc (między zachodem słońca a następnym wschodem).

relativeHumidity

integer

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

uvIndex

integer

Obecny indeks promieniowania ultrafioletowego (UV).

thunderstormProbability

integer

Aktualne prawdopodobieństwo wystąpienia burzy (wartości od 0 do 100).

cloudCover

integer

Obecny procent pokrycia nieba przez chmury (wartości od 0 do 100).

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

CurrentConditionsHistory

Reprezentuje zestaw zmian w bieżących warunkach w ciągu ostatnich 24 godzin.

Zapis JSON
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Pola
temperatureChange

object (Temperature)

bieżąca temperatura minus temperatura sprzed 24 godzin,

maxTemperature

object (Temperature)

Najwyższa temperatura w ciągu ostatnich 24 godzin.

minTemperature

object (Temperature)

Minimalna (najniższa) temperatura w ciągu ostatnich 24 godzin.

snowQpf

object (QuantitativePrecipitationForecast)

Ilość śniegu, mierzona jako ekwiwalent wody w stanie ciekłym, która spadła w ciągu ostatnich 24 godzin. Uwaga: QPF to skrót od Quantitative Precipitation Forecast (więcej informacji znajdziesz w definicji QuantitativePrecipitationForecast).

qpf

object (QuantitativePrecipitationForecast)

Ilość opadów deszczu mierzona jako ekwiwalent wody w stanie ciekłym, która zgromadziła się w ciągu ostatnich 24 godzin. Uwaga: QPF to skrót od Quantitative Precipitation Forecast (więcej informacji znajdziesz w definicji QuantitativePrecipitationForecast).