- Żą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 sprawdzić aktualne warunki pogodowe. | 
| units | 
 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). | 
| language | 
 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 currentConditions.lookup – przedstawia aktualne warunki pogodowe w żądanej lokalizacji.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
| Zapis JSON | 
|---|
| { "currentTime": string, "timeZone": { object ( | 
| Pola | |
|---|---|
| current | 
 Aktualny czas (UTC) powiązany z zwróconymi danymi. 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:  | 
| time | 
 Strefa czasowa w wybranym miejscu. | 
| weather | 
 bieżące warunki pogodowe; | 
| temperature | 
 bieżąca temperatura, | 
| feels | 
 Pomiar temperatury odczuwalnej w określonej lokalizacji. | 
| dew | 
 bieżąca temperatura punktu rosy, | 
| heat | 
 bieżąca temperatura odczuwalna; | 
| wind | 
 Aktualny odczuwalny chłód, czyli temperatura powietrza odczuwana na skórze. | 
| precipitation | 
 Aktualne prawdopodobieństwo opadów i ich ilość nagromadzona w ciągu ostatniej godziny. | 
| air | 
 bieżące warunki ciśnienia powietrza; | 
| wind | 
 bieżące warunki wiatrowe; | 
| visibility | 
 Bieżąca widoczność. | 
| current | 
 zmiany w obecnych warunkach w ciągu ostatnich 24 godzin; | 
| is | 
 Prawda, jeśli bieżąca godzina w wymaganej lokalizacji przypada między lokalnym wschodem słońca (włącznie) a zachodem słońca (wykluczając). W przeciwnym razie jest noc (między zachodem a kolejnym wschodem słońca). | 
| relative | 
 Aktualna wilgotność względna wyrażona w procentach (wartości od 0 do 100). | 
| uv | 
 Aktualny indeks promieniowania ultrafioletowego (UV). | 
| thunderstorm | 
 Aktualne prawdopodobieństwo wystąpienia burzy (wartości od 0 do 100). | 
| cloud | 
 Aktualny procent nieba pokrytego chmurami (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 bieżących warunków w ciągu ostatnich 24 godzin.
| Zapis JSON | 
|---|
| { "temperatureChange": { object ( | 
| Pola | |
|---|---|
| temperature | 
 Różnica między bieżącą temperaturą a temperaturą sprzed 24 godzin. | 
| max | 
 Maksymalna (wysoka) temperatura w ciągu ostatnich 24 godzin. | 
| min | 
 Najniższa (niska) temperatura w ciągu ostatnich 24 godzin. | 
| qpf | 
 Ilość opadów (deszczu lub śniegu) w ekwiwalencie wody w ciągu ostatnich 24 godzin. Uwaga: QPF to skrót od Quantitative Precipitation Forecast (Prognozowana wielkość opadów) (więcej informacji znajdziesz w definicji QuantitativePrecipitationForecast). |