Method: currentConditions.lookup

Zwraca aktualne warunki pogodowe w podanej 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 sprawdzić aktualne warunki pogodowe.
unitsSystem

enum (UnitsSystem)

Opcjonalnie. System jednostek, który ma być używany w zwracanych warunkach pogodowych. Jeśli nie podasz tego parametru, zwrócone warunki pogodowe będą podane w systemie metrycznym (wartość domyślna = METRIC).
languageCode

string

Opcjonalnie. Umożliwia klientowi wybór języka odpowiedzi. Jeśli nie można podać danych w tym 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 – reprezentuje aktualne warunki pogodowe w żądanej 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)

Bieżący czas (UTC) powiązany ze zwracanymi 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)

Wskaźnik temperatury odczuwalnej w wybranej lokalizacji.
dewPoint

object (Temperature)

bieżąca temperatura punktu rosy,
heatIndex

object (Temperature)

bieżąca temperatura odczuwalna,
windChill

object (Temperature)

bieżąca temperatura odczuwalna, czyli temperatura powietrza odczuwana na skórze;

Uwaga: w przypadku lokalizacji w Japonii i Korei Południowej to pole zwraca pusty obiekt.
precipitation

object (Precipitation)

Aktualne prawdopodobieństwo opadów i ilość opadów w ciągu ostatniej godziny.
airPressure

object (AirPressure)

Bieżące warunki ciśnienia powietrza.
wind

object (Wind)

aktualne warunki wietrzne,
visibility

object (Visibility)

Bieżąca widoczność.

Uwaga: w przypadku lokalizacji w Japonii i Korei Południowej to pole zwraca pusty obiekt.
currentConditionsHistory

object (CurrentConditionsHistory)

Zmiany w aktualnych warunkach w ciągu ostatnich 24 godzin.
isDaytime

boolean

Prawda, jeśli bieżący czas 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 a następnym wschodem słońca).
relativeHumidity

integer

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

integer

aktualny indeks promieniowania ultrafioletowego (UV);
thunderstormProbability

integer

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

Uwaga: to pole jest pomijane w odpowiedzi w przypadku lokalizacji w Japonii i Korei Południowej.
cloudCover

integer

Aktualny procent nieba pokrytego chmurami (wartości od 0 do 100).

Uwaga: to pole jest pomijane w odpowiedzi w przypadku lokalizacji w Japonii i Korei Południowej.

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)

Maksymalna (wysoka) temperatura w ciągu ostatnich 24 godzin.
minTemperature

object (Temperature)

Minimalna (niska) temperatura w ciągu ostatnich 24 godzin.
snowQpf

object (QuantitativePrecipitationForecast)

Ilość śniegu, która ma spaść w określonym czasie, przy założeniu, że nie będzie się topić ani ubijać. Uwaga: jest to rzeczywista ilość śniegu, a nie jego odpowiednik w postaci wody. QPF to skrót od Quantitative Precipitation Forecast (więcej informacji znajdziesz w definicji QuantitativePrecipitationForecast).
qpf

object (QuantitativePrecipitationForecast)

Całkowity równoważnik wodny wszystkich opadów (deszczu, śniegu, lodu itp.), które mają wystąpić w danym okresie. Uwaga: QPF to skrót od Quantitative Precipitation Forecast (więcej informacji znajdziesz w definicji QuantitativePrecipitationForecast).