- Żądanie HTTP
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- CurrentConditionsHistory
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 |
Wymagane. Lokalizacja, dla której chcesz uzyskać aktualne warunki pogodowe. |
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 |
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 ( |
| Pola | |
|---|---|
currentTime |
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: |
timeZone |
Strefa czasowa w żądanej lokalizacji. |
weatherCondition |
Aktualne warunki pogodowe. |
temperature |
bieżąca temperatura, |
feelsLikeTemperature |
Miara tego, jak temperatura jest obecnie odczuwana w wybranej lokalizacji. |
dewPoint |
bieżąca temperatura punktu rosy, |
heatIndex |
bieżąca temperatura odczuwalna, |
windChill |
Aktualna temperatura odczuwalna, czyli temperatura powietrza odczuwana na skórze. |
precipitation |
Aktualne prawdopodobieństwo opadów i ilość opadów z ostatniej godziny. |
airPressure |
Aktualne warunki ciśnienia powietrza. |
wind |
bieżące warunki wiatrowe, |
visibility |
bieżąca widoczność, |
currentConditionsHistory |
Zmiany w obecnych warunkach w ciągu ostatnich 24 godzin. |
isDaytime |
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 |
Obecny procent wilgotności względnej (wartości od 0 do 100). |
uvIndex |
Obecny indeks promieniowania ultrafioletowego (UV). |
thunderstormProbability |
Aktualne prawdopodobieństwo wystąpienia burzy (wartości od 0 do 100). |
cloudCover |
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 ( |
| Pola | |
|---|---|
temperatureChange |
bieżąca temperatura minus temperatura sprzed 24 godzin, |
maxTemperature |
Najwyższa temperatura w ciągu ostatnich 24 godzin. |
minTemperature |
Minimalna (najniższa) temperatura w ciągu ostatnich 24 godzin. |
snowQpf |
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 |
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). |