MCP Tools Reference: mapstools.googleapis.com

Narzędzie: lookup_weather

Pobiera kompleksowe informacje o środowisku w danej lokalizacji, w tym o pogodzie, jakości powietrza (AQI i zanieczyszczenia) oraz pyleniu (poziomy alergenów drzew, traw, chwastów i gatunków roślin): bieżące warunki, prognozy godzinowe/historia oraz prognozy dzienne dotyczące pogody i jakości powietrza. W przypadku pylenia dostępna jest tylko prognoza dzienna (od dziś do +4 dni, bez danych godzinowych i historycznych). Dostępne domeny i możliwości środowiskowe (capabilities: WEATHER, AIR_QUALITY, POLLEN – KRYTYCZNE): * Obowiązkowy wybór: w każdym wywołaniu MUSISZ uwzględnić co najmniej 1 z tych wartości: WEATHER, AIR_QUALITY lub POLLEN w capabilities. Pominięcie capabilities jest NIEDOZWOLONE. * Ogólne/niejednoznaczne zapytania dotyczące warunków na zewnątrz (pełny zestaw danych o warunkach na zewnątrz): jeśli użytkownik zada ogólne pytanie dotyczące warunków na zewnątrz, podróży lub sytuacji bez ograniczania się do konkretnej domeny (np. „Jakie są teraz warunki na zewnątrz do biegania?”), wyraźnie uwzględnij wszystkie 3 funkcje (capabilities: ["WEATHER", "AIR_QUALITY", "POLLEN"]), aby zwrócić pełny zestaw danych o warunkach na zewnątrz (pogoda + jakość powietrza + pyłki). W przypadku zapytania o date/hour pomiń POLLEN, który nie ma historii. * Wybór domeny docelowej (konkretne zapytania): jeśli użytkownik pyta o konkretne informacje z 1 lub 2 domen (np. „Jaki jest teraz indeks jakości powietrza w Seattle?”), uwzględnij tylko żądane funkcje (WEATHER, AIR_QUALITY lub POLLEN). Wykonane i zwrócone zostaną tylko żądane domeny. Konkretne dane dostępne według domeny: * Pogoda (weather): temperatura (aktualna, odczuwalna, maks./min., indeks ciepła), wiatr (prędkość, porywy, kierunek), zdarzenia astronomiczne (wschód/zachód słońca, faza księżyca), opady (rodzaj, prawdopodobieństwo, ilość/QPF) i warunki atmosferyczne (indeks UV, wilgotność, zachmurzenie, prawdopodobieństwo burzy, ciśnienie powietrza). * Jakość powietrza (air_quality): uniwersalne i lokalne indeksy jakości powietrza (wartość AQI, kategoria, dominujące zanieczyszczenie), zalecenia zdrowotne dla 7 grup wrażliwości i stężenia zanieczyszczeń (include_pollutant_concentration: true). Każdy indeks ma własne dominujące zanieczyszczenie.Podaj je dla każdego indeksu (np. nie podawaj zanieczyszczenia z uniwersalnego indeksu AQI dla indeksu AQI w USA). * Pyłki (pollen): dzienny uniwersalny indeks pyłkowy (UPI, 0–5) dla kategorii drzew, traw i chwastów oraz dla gatunków roślin (index.value z index.category, np. 1 = „Bardzo niski”), stan w sezonie, reakcje krzyżowe i zalecenia zdrowotne. * Brakujące pola dotyczące pyłków: brak pola in_season oznacza, że nie jest to sezon na dany pyłek. Pomiń gatunki roślin, które nie mają wartości index, chyba że użytkownik zapyta o daną roślinę. W takim przypadku powiedz, że nie ma dziś danych o pyleniu (nie podawaj poziomu). Reguły dotyczące lokalizacji (KRYTYCZNE): lokalizacja docelowa MUSI być określona w polu location za pomocą TYLKO JEDNEGO z tych pól podrzędnych oneof: 1. Współrzędne geograficzne (lat_lng): * Użyj, gdy znasz dokładne współrzędne szerokości i długości geograficznej. * Przykład: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} 2. Identyfikator miejsca (place_id): * Jednoznaczny identyfikator miejsca w Mapach Google (np. uzyskany z search_places lub resolve_names). * Przykład: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} 3. Ciąg znaków adresu (address): miasto/region, dzielnica, punkt orientacyjny lub interesujące miejsce, adres lub kod pocztowy, najlepiej z miastem/krajem. * Przykład: {"location": {"address": "Paris, France"}} Tryby czasu i użytkowania (date i hour – KRYTYCZNE): * Lokalna strefa czasowa: wszystkie dane wejściowe date ({year, month, day}) i hour (0-23) MUSZĄ być wyrażone w lokalnej strefie czasowej żądanego location (np. zapytanie dotyczące "Paris tomorrow at 13:00" używa lokalnej daty Europe/Paris i godziny 13), nigdy w strefie czasowej UTC ani strefie czasowej rozmówcy. * 1. Aktualne warunki (pominięto date ORAZ hour): * Podaj location i docelowy capabilities (WEATHER, AIR_QUALITY, POLLEN). NIE podawaj date ani hour. * Zwraca aktualne warunki (CC) w czasie rzeczywistym dla żądanych domen (aktualna pogoda, jakość powietrza w bieżącej godzinie lub prognoza pylenia na dziś). * W przypadku jakości powietrza bieżące warunki dotyczą jednej godziny: NIE używaj ich samodzielnie do odpowiadania na pytania dotyczące jakości powietrza lub ogólne pytania o warunki na zewnątrz dzisiaj (użyj zapytań dziennych poniżej). * 2. Prognoza godzinowa / historia (podano date ORAZ hour 0-23): * Podaj location, date ({year, month, day}), hour (0-23) i docelowy capabilities. Jeśli podane są minuty, zaokrąglij w dół do najbliższej godziny. * KRYTYCZNE OGRANICZENIE (date jest WYMAGANE, gdy ustawiono hour): podanie hour bez date (date pominięto, hour ustawiono) jest NIEDOZWOLONE i spowoduje błąd. Nawet jeśli użytkownik pyta o konkretną godzinę dzisiaj (np. "at 13:00 today"), MUSISZ wypełnić zarówno pole date (dzisiejsza data o location), jak i hour. * Sprawdza co godzinę pogodę lub jakość powietrza w YYYY-MM-DD-HH i codziennie poziom pyłków w YYYY-MM-DD. * Pytania o pogodę „kiedy”: w przypadku pytań o pogodę zawierających sformułowania kiedy / o której godzinie / najlepszy czas (np. "what time will it stop raining?") używaj wywołań godzinowych WEATHER (date + hour) dla odpowiednich godzin. Dzienna prognoza pogody nie zawiera wartości godzinowych. W przypadku ogólnych pytań dotyczących aktywności na zewnątrz typu „kiedy / najlepszy czas” (np. "when is the best time to go walking today?") wykonuj te cogodzinne wywołania WEATHER oprócz wywołania dotyczącego jakości powietrza (i pyłków) na cały dzień, opisanego w sekcji Zapytania codzienne. * 3. Zapytania dzienne (date określone ORAZ hour pominięte): * Podaj location, date ({year, month, day} w lokalnym czasie cywilnym żądanego location) bez hour oraz docelowy capabilities w przypadku zapytań całodniowych (np. "weather and pollen in London tomorrow"). * Pytania o jakość powietrza i ogólne pytania o warunki na zewnątrz dotyczące dzisiejszego dnia: w przypadku pytań o jakość powietrza i ogólnych pytań o warunki na zewnątrz (które obejmują jakość powietrza) dotyczących dzisiejszego dnia (np. "how will the air quality change today", "is today a good day for a picnic?") ustaw date na dzisiejszą datę o location (godzina pominięta), aby uzyskać godzinowe serie danych o jakości powietrza z danego dnia. Samo wywołanie bieżących warunków zwraca tylko aktualną godzinę jakości powietrza i nie wystarczy. Możesz je dodać, jeśli użytkownik pyta też o „teraz”. * Przedziały czasu dotyczące jakości powietrza: w przypadku pytania o jakość powietrza w danym przedziale czasu w ciągu jednego dnia (np. "air quality between noon and 6 PM") preferuj jedno wywołanie Daily dla tej daty i odczytaj godziny przedziału czasu z serii Air Quality, zamiast próbkować poszczególne godziny. Jeśli używasz połączeń godzinowych, uwzględnij każdą godzinę w oknie. * Zwraca prognozy dzienne dla żądanych danych pogodowych lub pylenia oraz godzinowe dane dotyczące jakości powietrza dla całego dnia (00:00–23:00 czasu lokalnego): 24 godziny historyczne dla daty z przeszłości, 24 godziny prognozy dla daty z przyszłości, a dla dnia dzisiejszego – wcześniejsze godziny (historia), bieżącą godzinę i pozostałe godziny (prognoza). Obsługiwane horyzonty czasowe według domeny: * Pogoda: co godzinę od 24 godzin wstecz do 240 godzin (10 dni) do przodu (w przypadku godzin z przeszłości wymagane są zarówno date, jak i hour); codziennie do 10 dni, w tym dzisiaj (od dzisiaj do +9 dni); brak historii dziennej. * Jakość powietrza: co godzinę od 720 godzin (30 dni) wstecz do 96 godzin (4 dni) do przodu; wywołanie całodniowe musi mieścić się w tym oknie (w praktyce od 29 dni wstecz do 3 dni do przodu). * Pyłki: tylko dane dzienne, od dzisiaj do +4 dni (5 dni, w tym dzisiaj); brak dat z przeszłości, a parametr hour jest ignorowany. * (Uwaga: jeśli żądanych jest kilka funkcji, a date/hour wykracza poza jeden z ich zakresów, wywołanie nadal się powiedzie i zwróci tylko obsługiwane funkcje). * Żądania spoza zakresu: jeśli żądana data lub godzina może wykraczać poza obsługiwany zakres domeny (np.Pollen w przypadku daty z przeszłości), nadal wywołuj lookup_weather dla żądanej daty/godziny. Stan błędu określa obsługiwany zakres. Nie podawaj innej daty, godziny ani domeny jako zamiennika. Opcje domeny i atrybucja: * Język (language_code): opcjonalny kod języka BCP-47 (np. "fr"). Domyślnie: "en". * Jednostki w aplikacji Pogoda (weather_options.units_system lub units_system): domyślnie METRIC. Ustaw IMPERIAL (Fahrenheit/mph), jeśli użytkownik sugeruje standardy amerykańskie lub wyraźnie prosi o jednostki imperialne. Obsługiwane zarówno w weather_options.units_system (preferowane), jak i w units_system najwyższego poziomu. Jeśli podano oba, nie mogą być ze sobą sprzeczne. * Opcje jakości powietrza (air_quality_options): ustaw include_pollutant_concentration: true, gdy potrzebne są konkretne stężenia zanieczyszczeń (PM2,5, PM10, O3, NO2, SO2, CO). Opcjonalnie ustaw index_region_code (dwuliterowy kod kraju w standardzie ISO, np. "US"), aby poprosić o konkretną regionalną skalę AQI. Domyślnie odpowiedź zawiera uniwersalny wskaźnik AQI i regionalny wskaźnik AQI lokalizacji. * Atrybucja: wygenerowane odpowiedzi MUSZĄ być przypisane do źródła za pomocą pola attribution w każdym zwróconym kontenerze domeny (weather.attribution, air_quality.attribution, pollen.attribution). * Zwrócone godziny: wartości date_time dotyczące jakości powietrza są już podane w czasie lokalnym (uwzględniono utc_offset). Przedstaw je w takiej postaci, w jakiej są. Dane date_time dotyczące pogody (bieżące i godzinowe) oraz godziny wschodu i zachodu słońca są podane w czasie UTC. Przekonwertuj je na czas lokalny za pomocą time_zone. Oznacz wszystkie godziny jako lokalne.

Poniższy przykładowy kod pokazuje, jak używać curl do wywoływania narzędzia MCP lookup_weather.

Żądanie Curl 
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "lookup_weather",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat wejściowy

Żądanie metody LookupWeather – reprezentuje warunki pogodowe w żądanej lokalizacji.

LookupWeatherRequest

Zapis JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],

  // Union field _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // Union field _hour can be only one of the following:
  "hour": integer
  // End of list of possible types for union field _hour.

  // Union field _language_code can be only one of the following:
  "languageCode": string
  // End of list of possible types for union field _language_code.

  // Union field _weather_options can be only one of the following:
  "weatherOptions": {
    object (WeatherOptions)
  }
  // End of list of possible types for union field _weather_options.

  // Union field _air_quality_options can be only one of the following:
  "airQualityOptions": {
    object (AirQualityOptions)
  }
  // End of list of possible types for union field _air_quality_options.
}
Pola
unitsSystem

enum (UnitsSystem)

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

object (Location)

Wymagane. Lokalizacja, dla której chcesz sprawdzić warunki pogodowe.
capabilities[]

enum (Capability)

Opcjonalnie. Możliwości środowiskowe, które mają być uwzględnione w odpowiedzi.

Pole zbiorcze _date.

Pole _date może mieć tylko jedną z tych wartości:
date

object (Date)

Opcjonalnie. Określa datę żądanych informacji o środowisku, względem lokalnej strefy czasowej lokalizacji określonej w polu location. Obsługiwane zakresy dat zależą od żądanych funkcji: – WEATHER: do 24 godzin wstecz (gdy ustawiono również hour) i do 10 dni (240 godzin) w przyszłość (od dziś do +9 dni w przypadku prognoz dziennych). - AIR_QUALITY: do 30 dni (720 godzin) wstecz i do 4 dni (96 godzin) do przodu. - POLLEN: od dziś do 4 dni do przodu (maksymalnie 5 dni, wliczając dzisiejszy; daty historyczne nie są obsługiwane).

Pole zbiorcze _hour.

Pole _hour może mieć tylko jedną z tych wartości:
hour

integer

Opcjonalnie. Określa godzinę, dla której mają zostać pobrane informacje o środowisku, w formacie 24-godzinnym (0–23), względem lokalnej strefy czasowej lokalizacji określonej w polu location. Wymaga określenia parametru date. Obsługiwane zakresy godzinowe zależą od żądanych możliwości: - WEATHER: do 24 godzin w przeszłości i do 240 godzin (10 dni) w przyszłości. - AIR_QUALITY: do 30 dni (720 godzin) wstecz i do 4 dni (96 godzin) do przodu. - POLLEN: zwraca tylko prognozy dzienne; parametr hour jest ignorowany w przypadku pyłków.

Pole zbiorcze _language_code.

Pole _language_code może mieć tylko jedną z tych wartości:
languageCode

string

Opcjonalnie. Kod języka w standardzie BCP-47 dla zlokalizowanego tekstu w odpowiedzi (np. „en”, „ja”, „fr-CA”). Jeśli nie zostanie podany, domyślnie przyjmuje się „en”.

Pole zbiorcze _weather_options.

Pole _weather_options może mieć tylko jedną z tych wartości:
weatherOptions

object (WeatherOptions)

Opcjonalnie. Opcje dotyczące zapytań o pogodę. Pole weather_options.units_system jest obsługiwane razem z polem units_system najwyższego poziomu (tag 4), aby zachować zgodność wsteczną z istniejącymi elementami wywołującymi. Jeśli oba pola określają sprzeczne systemy jednostek, zwracany jest błąd INVALID_ARGUMENT. Ignorowane, jeśli nie zażądano WEATHER w capabilities.

Pole zbiorcze _air_quality_options.

Pole _air_quality_options może mieć tylko jedną z tych wartości:
airQualityOptions

object (AirQualityOptions)

Opcjonalnie. Opcje dotyczące żądań związanych z jakością powietrza. Ignorowane, jeśli nie zażądano AIR_QUALITY w capabilities.

Data

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 lub rok i miesiąc, gdy dzień nie ma znaczenia.

Lokalizacja

Zapis JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
Pola
Pole zbiorcze location_type. Różne sposoby przedstawiania lokalizacji. location_type może mieć tylko jedną z tych wartości:
latLng

object (LatLng)

Punkt określony za pomocą współrzędnych geograficznych.
placeId

string

Identyfikator miejsca powiązany z lokalizacją.
address

string

Adres zrozumiały dla człowieka (np. ulica i numer, miasto lub kod pocztowy).

LatLng

Zapis JSON 
{
  "latitude": number,
  "longitude": number
}
Pola
latitude

number

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie [-90,0, +90,0].
longitude

number

Długość geograficzna w stopniach. Musi mieścić się w zakresie [-180,0, +180,0].

WeatherOptions

Zapis JSON 
{
  "unitsSystem": enum (UnitsSystem)
}
Pola
unitsSystem

enum (UnitsSystem)

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

AirQualityOptions

Zapis JSON 
{

  // Union field _include_pollutant_concentration can be only one of the
  // following:
  "includePollutantConcentration": boolean
  // End of list of possible types for union field
  // _include_pollutant_concentration.

  // Union field _index_region_code can be only one of the following:
  "indexRegionCode": string
  // End of list of possible types for union field _index_region_code.
}
Pola

Pole zbiorcze _include_pollutant_concentration.

Pole _include_pollutant_concentration może mieć tylko jedną z tych wartości:
includePollutantConcentration

boolean

Opcjonalnie. Jeśli ma wartość „true”, w odpowiedzi dotyczącej jakości powietrza uwzględniane są szczegółowe stężenia zanieczyszczeń i dodatkowe informacje (źródła i skutki).

Pole zbiorcze _index_region_code.

Pole _index_region_code może mieć tylko jedną z tych wartości:
indexRegionCode

string

Opcjonalnie. Dwuliterowy kod kraju/regionu w formacie ISO 3166-1 alfa-2 (np. „US”, „FR”, „CN”) używany do wybierania preferowanej lokalnej skali indeksu jakości powietrza (AQI) obok uniwersalnego indeksu jakości powietrza (UAQI). Jeśli nie podasz żadnej wartości, zostanie użyta domyślna wartość regionu żądanej lokalizacji.

UnitsSystem

Reprezentuje układ jednostek używany do pomiaru wartości.

Wartości w polu enum
UNITS_SYSTEM_UNSPECIFIED System jednostek jest nieokreślony.
IMPERIAL System jednostek imperialnych (np. stopnie Fahrenheita, mile).
METRIC System jednostek metrycznych (np. stopnie Celsjusza, kilometry).

Możliwości

Możliwości środowiskowe, o które można poprosić w LookupWeatherRequest.

Wartości w polu enum
CAPABILITY_UNSPECIFIED Nieokreślona funkcja.
WEATHER warunki pogodowe (temperatura, opady, wiatr, promieniowanie UV itp.);
AIR_QUALITY informacje o jakości powietrza (indeks jakości powietrza, zanieczyszczenia i zalecenia zdrowotne);
POLLEN informacje o pyłkach (poziomy alergenów drzew, traw, chwastów i gatunków roślin);

Schemat wyjściowy

Odpowiedź na wywołanie RPC LookupWeather – reprezentuje warunki pogodowe w żądanej lokalizacji.

Ta odpowiedź zawiera informacje godzinowe i dzienne, dlatego jest podzielona na 3 sekcje: godzinową, dzienną i udostępnioną. Pola Only-Hourly i Only-Daily są oznaczone jako opcjonalne. Niektóre pola, które są wspólne dla informacji godzinowych i dziennych, są zawsze obecne, więc nie są oznaczone jako opcjonalne, podczas gdy pozostałe są oznaczone jako opcjonalne, ponieważ nie zawsze są dostępne.

LookupWeatherResponse

Zapis JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "returnedLocation": {
    object (Location)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.

  // Union field _weather can be only one of the following:
  "weather": {
    object (WeatherResultData)
  }
  // End of list of possible types for union field _weather.

  // Union field _air_quality can be only one of the following:
  "airQuality": {
    object (AirQualityResultData)
  }
  // End of list of possible types for union field _air_quality.

  // Union field _pollen can be only one of the following:
  "pollen": {
    object (PollenResultData)
  }
  // End of list of possible types for union field _pollen.

  // Union field _time_zone can be only one of the following:
  "timeZone": string
  // End of list of possible types for union field _time_zone.
}
Pola
weatherCondition

object (WeatherCondition)

warunki pogodowe,
precipitation

object (Precipitation)

prawdopodobieństwo opadów i ilość opadów,
wind

object (Wind)

warunki wietrzne,
returnedLocation

object (Location)

Wymagane. Lokalizacja, dla której są zwracane informacje o pogodzie. Ta lokalizacja jest identyczna z lokalizacją w żądaniu, ale może się od niej różnić, jeśli żądana lokalizacja jest adresem w formie tekstu swobodnego, który wskazuje na przybliżoną lokalizację (np. „Mountain View, CA”).
attribution

object (Attribution)

Wymagane informacje o autorze, które mają się wyświetlać z pogodą.

Pole zbiorcze _temperature.

Pole _temperature może mieć tylko jedną z tych wartości:
temperature

object (Temperature)

temperatura w ciągu godziny,

Pole zbiorcze _feels_like_temperature.

Pole _feels_like_temperature może mieć tylko jedną z tych wartości:
feelsLikeTemperature

object (Temperature)

Godzinowa temperatura odczuwalna.

Pole zbiorcze _heat_index.

Pole _heat_index może mieć tylko jedną z tych wartości:
heatIndex

object (Temperature)

Godzinowa temperatura odczuwalna.

Pole zbiorcze _air_pressure.

Pole _air_pressure może mieć tylko jedną z tych wartości:
airPressure

object (AirPressure)

Ciśnienie powietrza w poszczególnych godzinach.

Pole zbiorcze _max_temperature.

Pole _max_temperature może mieć tylko jedną z tych wartości:
maxTemperature

object (Temperature)

Maksymalna (wysoka) temperatura w ciągu dnia.

Pole zbiorcze _min_temperature.

Pole _min_temperature może mieć tylko jedną z tych wartości:
minTemperature

object (Temperature)

Minimalna (niska) temperatura w ciągu dnia.

Pole zbiorcze _feels_like_max_temperature.

Pole _feels_like_max_temperature może mieć tylko jedną z tych wartości:
feelsLikeMaxTemperature

object (Temperature)

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

Pole zbiorcze _feels_like_min_temperature.

Pole _feels_like_min_temperature może mieć tylko jedną z tych wartości:
feelsLikeMinTemperature

object (Temperature)

Minimalna (niska) temperatura odczuwalna w ciągu dnia.

Pole zbiorcze _max_heat_index.

Pole _max_heat_index może mieć tylko jedną z tych wartości:
maxHeatIndex

object (Temperature)

Maksymalna temperatura odczuwalna w ciągu dnia.

Pole zbiorcze _sun_events.

Pole _sun_events może mieć tylko jedną z tych wartości:
sunEvents

object (SunEvents)

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

Pole zbiorcze _moon_events.

Pole _moon_events może mieć tylko jedną z tych wartości:
moonEvents

object (MoonEvents)

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

Pole zbiorcze _relative_humidity.

Pole _relative_humidity może mieć tylko jedną z tych wartości:
relativeHumidity

integer

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

Pole zbiorcze _uv_index.

Pole _uv_index może mieć tylko jedną z tych wartości:
uvIndex

integer

Maksymalny indeks promieniowania ultrafioletowego (UV).

Pole zbiorcze _thunderstorm_probability.

Pole _thunderstorm_probability może mieć tylko jedną z tych wartości:
thunderstormProbability

integer

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

Pole zbiorcze _cloud_cover.

Pole _cloud_cover może mieć tylko jedną z tych wartości:
cloudCover

integer

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

Pole zbiorcze _weather.

Pole _weather może mieć tylko jedną z tych wartości:
weather

object (WeatherResultData)

Warunki pogodowe w wybranej lokalizacji.

Pole zbiorcze _air_quality.

Pole _air_quality może mieć tylko jedną z tych wartości:
airQuality

object (AirQualityResultData)

Informacje o jakości powietrza w wybranej lokalizacji.

Pole zbiorcze _pollen.

Pole _pollen może mieć tylko jedną z tych wartości:
pollen

object (PollenResultData)

Informacje o pyłkach w wybranej lokalizacji.

Pole zbiorcze _time_zone.

Pole _time_zone może mieć tylko jedną z tych wartości:
timeZone

string

Rozpoznany ciąg znaków strefy czasowej IANA dla lokalizacji (np. „America/New_York”, „Asia/Tokyo”).

Temperatura

Zapis JSON 
{
  "unit": enum (Unit),

  // Union field _degrees can be only one of the following:
  "degrees": number
  // End of list of possible types for union field _degrees.
}
Pola
unit

enum (Unit)

Opcjonalnie. Kod jednostki używanej do pomiaru temperatury.

Pole zbiorcze _degrees.

Pole _degrees może mieć tylko jedną z tych wartości:
degrees

number

Wartość temperatury (w stopniach) w określonej jednostce.

AirPressure

Zapis JSON 
{

  // Union field _mean_sea_level_millibars can be only one of the following:
  "meanSeaLevelMillibars": number
  // End of list of possible types for union field _mean_sea_level_millibars.
}
Pola

Pole zbiorcze _mean_sea_level_millibars.

Pole _mean_sea_level_millibars może mieć tylko jedną z tych wartości:
meanSeaLevelMillibars

number

Średnie ciśnienie powietrza na poziomie morza w milibarach.

SunEvents

Zapis JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Pola
sunriseTime

string (Timestamp format)

Czas 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 nie będzie ustawione.

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)

Czas zachodu 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ć zachodu słońca. W takich przypadkach to pole nie będzie ustawione.

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

Sygnatura czasowa

Zapis JSON 
{
  "seconds": string,
  "nanos": integer
}
Pola
seconds

string (int64 format)

Reprezentuje sekundy czasu UTC od epoki uniksowej 1970-01-01T00:00:00Z. Musi mieścić się w zakresie od -62135596800 do 253402300799 włącznie (co odpowiada zakresowi od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59Z).
nanos

integer

Nieujemne ułamki sekundy w rozdzielczości nanosekundowej. To pole zawiera nanosekundową część czasu trwania, a nie alternatywę dla sekund. Ujemne wartości sekund z ułamkami muszą mieć nieujemne wartości nanosekund, które są liczone do przodu. Musi mieścić się w zakresie od 0 do 999 999 999 włącznie.

MoonEvents

Zapis JSON 
{
  "moonPhase": enum (Phase),
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ]
}
Pola
moonPhase

enum (Phase)

Opcjonalnie. Faza księżyca.
moonriseTimes[]

string (Timestamp format)

Czas, kiedy 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 księżyc wschodzi raz dziennie. W innych przypadkach lista może być pusta (np. gdy księżyc wschodzi po północy następnego dnia). Jednak 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)

Czas, 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 księżyc zachodzi raz dziennie. W innych przypadkach lista może być pusta (np. gdy księżyc zachodzi po północy następnego dnia). Jednak 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".

WeatherCondition

Zapis JSON 
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
Pola
iconBaseUri

string

Podstawowy identyfikator URI ikony bez rozszerzenia typu pliku. Aby wyświetlić ikonę, dołącz do tego identyfikatora URI motyw (jeśli chcesz) i rozszerzenie typu pliku (.png lub .svg). Domyślnie ikona jest w trybie jasnym, ale można dodać _dark, aby włączyć tryb ciemny. Na przykład: „https://maps.gstatic.com/weather/v1/dust.svg” lub „https://maps.gstatic.com/weather/v1/dust_dark.svg”, gdzie icon_base_uri to „https://maps.gstatic.com/weather/v1/dust”.
description

object (LocalizedText)

Opis tekstowy tych warunków pogodowych (zlokalizowany).
type

enum (Type)

Typ warunków pogodowych.

LocalizedText

Zapis JSON 
{
  "text": string,
  "languageCode": string
}
Pola
text

string

Zlokalizowany ciąg znaków w języku odpowiadającym google.type.LocalizedText.language_code poniżej.
languageCode

string

Kod języka tekstu w standardzie BCP-47, np. „en-US” lub „sr-Latn”.

Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

Opady

Zapis JSON 
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Pola
probability

object (PrecipitationProbability)

Prawdopodobieństwo opadów (wartości od 0 do 100).
snowQpf

object (QuantitativePrecipitationForecast)

Ilość śniegu, mierzona jako równoważnik wody, która nagromadziła się w danym okresie. 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 równoważnik wody w stanie ciekłym, która nagromadziła się w danym okresie. Uwaga: QPF to skrót od Quantitative Precipitation Forecast (więcej informacji znajdziesz w definicji QuantitativePrecipitationForecast).

PrecipitationProbability

Zapis JSON 
{
  "type": enum (Type),

  // Union field _percent can be only one of the following:
  "percent": integer
  // End of list of possible types for union field _percent.
}
Pola
type

enum (Type)

Opcjonalnie. Kod wskazujący typ opadów.

Pole zbiorcze _percent.

Pole _percent może mieć tylko jedną z tych wartości:
percent

integer

Wartość procentowa od 0 do 100, która wskazuje prawdopodobieństwo opadów.

QuantitativePrecipitationForecast

Zapis JSON 
{
  "unit": enum (Unit),

  // Union field _quantity can be only one of the following:
  "quantity": number
  // End of list of possible types for union field _quantity.
}
Pola
unit

enum (Unit)

Kod jednostki używanej do pomiaru ilości skumulowanych opadów.

Pole zbiorcze _quantity.

Pole _quantity może mieć tylko jedną z tych wartości:
quantity

number

Ilość opadów, mierzona jako równoważnik wody w stanie ciekłym, która nagromadziła się w danym okresie.

Wiatr

Zapis JSON 
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
Pola
direction

object (WindDirection)

Kierunek wiatru, kąt, pod którym wieje.
speed

object (WindSpeed)

Prędkość wiatru.
gust

object (WindSpeed)

poryw wiatru (nagły wzrost prędkości wiatru);

WindDirection

Zapis JSON 
{
  "cardinal": enum (Cardinal),

  // Union field _degrees can be only one of the following:
  "degrees": integer
  // End of list of possible types for union field _degrees.
}
Pola
cardinal

enum (Cardinal)

Opcjonalnie. Kod reprezentujący kierunek, z którego wieje wiatr.

Pole zbiorcze _degrees.

Pole _degrees może mieć tylko jedną z tych wartości:
degrees

integer

Kierunek wiatru w stopniach (wartości od 0 do 360).

WindSpeed

Zapis JSON 
{
  "unit": enum (Unit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
Pola
unit

enum (Unit)

Opcjonalnie. Kod reprezentujący jednostkę używaną do pomiaru prędkości wiatru.

Pole zbiorcze _value.

Pole _value może mieć tylko jedną z tych wartości:
value

number

Wartość prędkości wiatru.

Lokalizacja

Zapis JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
Pola
Pole zbiorcze location_type. Różne sposoby przedstawiania lokalizacji. location_type może mieć tylko jedną z tych wartości:
latLng

object (LatLng)

Punkt określony za pomocą współrzędnych geograficznych.
placeId

string

Identyfikator miejsca powiązany z lokalizacją.
address

string

Adres zrozumiały dla człowieka (np. ulica i numer, miasto lub kod pocztowy).

LatLng

Zapis JSON 
{
  "latitude": number,
  "longitude": number
}
Pola
latitude

number

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie [-90,0, +90,0].
longitude

number

Długość geograficzna w stopniach. Musi mieścić się w zakresie [-180,0, +180,0].

Atrybucja

Zapis JSON 
{
  "title": string,
  "url": string
}
Pola
title

string

Tytuł, który ma być wyświetlany w atrybucji.
url

string

Adres URL, do którego ma prowadzić link w atrybucji.

WeatherResultData

Zapis JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _date_time can be only one of the following:
  "dateTime": string
  // End of list of possible types for union field _date_time.

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.
}
Pola
weatherCondition

object (WeatherCondition)

Warunki pogodowe.
precipitation

object (Precipitation)

prawdopodobieństwo opadów i ich ilość;
wind

object (Wind)

Warunki wietrzne.
attribution

object (Attribution)

Wymagane informacje o autorze, które mają się wyświetlać z pogodą.

Pole zbiorcze _date_time.

Pole _date_time może mieć tylko jedną z tych wartości:
dateTime

string (Timestamp format)

Sygnatura czasowa tego wpisu dotyczącego pogody godzinowej lub bieżą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".

Pole zbiorcze _temperature.

Pole _temperature może mieć tylko jedną z tych wartości:
temperature

object (Temperature)

temperatura w ciągu dnia,

Pole zbiorcze _feels_like_temperature.

Pole _feels_like_temperature może mieć tylko jedną z tych wartości:
feelsLikeTemperature

object (Temperature)

Godzinowa temperatura odczuwalna.

Pole zbiorcze _heat_index.

Pole _heat_index może mieć tylko jedną z tych wartości:
heatIndex

object (Temperature)

Godzinowa temperatura odczuwalna.

Pole zbiorcze _air_pressure.

Pole _air_pressure może mieć tylko jedną z tych wartości:
airPressure

object (AirPressure)

Ciśnienie powietrza w poszczególnych godzinach.

Pole zbiorcze _date.

Pole _date może mieć tylko jedną z tych wartości:
date

object (Date)

Data kalendarzowa dziennej prognozy pogody.

Pole zbiorcze _max_temperature.

Pole _max_temperature może mieć tylko jedną z tych wartości:
maxTemperature

object (Temperature)

Maksymalna (wysoka) temperatura w ciągu dnia.

Pole zbiorcze _min_temperature.

Pole _min_temperature może mieć tylko jedną z tych wartości:
minTemperature

object (Temperature)

Minimalna (niska) temperatura w ciągu dnia.

Pole zbiorcze _feels_like_max_temperature.

Pole _feels_like_max_temperature może mieć tylko jedną z tych wartości:
feelsLikeMaxTemperature

object (Temperature)

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

Pole zbiorcze _feels_like_min_temperature.

Pole _feels_like_min_temperature może mieć tylko jedną z tych wartości:
feelsLikeMinTemperature

object (Temperature)

Minimalna (niska) temperatura odczuwalna w ciągu dnia.

Pole zbiorcze _max_heat_index.

Pole _max_heat_index może mieć tylko jedną z tych wartości:
maxHeatIndex

object (Temperature)

Maksymalna temperatura odczuwalna w ciągu dnia.

Pole zbiorcze _sun_events.

Pole _sun_events może mieć tylko jedną z tych wartości:
sunEvents

object (SunEvents)

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

Pole zbiorcze _moon_events.

Pole _moon_events może mieć tylko jedną z tych wartości:
moonEvents

object (MoonEvents)

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

Pole zbiorcze _relative_humidity.

Pole _relative_humidity może mieć tylko jedną z tych wartości:
relativeHumidity

integer

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

Pole zbiorcze _uv_index.

Pole _uv_index może mieć tylko jedną z tych wartości:
uvIndex

integer

Maksymalny indeks promieniowania ultrafioletowego (UV).

Pole zbiorcze _thunderstorm_probability.

Pole _thunderstorm_probability może mieć tylko jedną z tych wartości:
thunderstormProbability

integer

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

Pole zbiorcze _cloud_cover.

Pole _cloud_cover może mieć tylko jedną z tych wartości:
cloudCover

integer

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

Data

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 lub rok i miesiąc, gdy dzień nie ma znaczenia.

AirQualityResultData

Zapis JSON 
{
  "hourlyResults": [
    {
      object (AirQualityHourlyResult)
    }
  ],
  "attribution": {
    object (Attribution)
  }
}
Pola
hourlyResults[]

object (AirQualityHourlyResult)

Dane o jakości powietrza w ujęciu godzinowym dla żądanego czasu (zawierają 1 wpis dotyczący bieżących warunków lub zapytań o pojedynczą godzinę, do 24 wpisów dotyczących zapytań o datę w przeszłości lub przyszłości albo bieżące i pozostałe godziny, gdy data to dzisiaj).
attribution

object (Attribution)

Wymagane informacje o autorstwie, które mają być wyświetlane wraz z danymi o jakości powietrza.

AirQualityHourlyResult

Zapis JSON 
{
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  },
  "dateTime": {
    object (DateTime)
  }
}
Pola
indexes[]

object (AirQualityIndex)

indeksy jakości powietrza (np. uniwersalny i lokalny indeks jakości powietrza);
pollutants[]

object (Pollutant)

Szczegółowe informacje o zanieczyszczeniach, które są wypełniane, gdy parametr air_quality_options.include_pollutant_concentration ma wartość „true”.
healthRecommendations

object (HealthRecommendations)

zalecenia zdrowotne dla różnych grup ludności.
dateTime

object (DateTime)

Lokalna data i godzina w strefie czasowej lokalizacji dla tego godzinowego wpisu dotyczącego jakości powietrza (składa się z: year, month, day, hours, minutes, seconds i utc_offset).

AirQualityIndex

Zapis JSON 
{
  "displayName": string,
  "valueDisplay": string,
  "category": string,
  "dominantPollutant": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
Pola
displayName

string

Wyświetlana nazwa indeksu (np. „Uniwersalny AQI”, „US EPA AQI”).
valueDisplay

string

Sformatowany ciąg znaków reprezentujący wartość AQI.
category

string

Tekstowa kategoria jakości powietrza (np. „Dobra jakość powietrza”, „Umiarkowana jakość powietrza”).
dominantPollutant

string

Kod dominującego zanieczyszczenia (np. „pm25”, „o3”).

Pole zbiorcze _value.

Pole _value może mieć tylko jedną z tych wartości:
value

integer

Liczbowa wartość AQI.

Zanieczyszczenie

Zapis JSON 
{
  "displayName": string,
  "fullName": string,
  "concentration": {
    object (Concentration)
  },
  "additionalInfo": {
    object (AdditionalInfo)
  }
}
Pola
displayName

string

Krótka wyświetlana nazwa zanieczyszczenia (np. „PM2.5”, „O3”).
fullName

string

Pełna nazwa chemiczna lub potoczna zanieczyszczenia (np. „Pył zawieszony PM2.5”, „Ozon”).
concentration

object (Concentration)

Zmierzone stężenie zanieczyszczenia.
additionalInfo

object (AdditionalInfo)

Dodatkowe informacje o źródłach zanieczyszczeń i ich wpływie na zdrowie.

Stężenie

Zapis JSON 
{
  "unit": enum (Unit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
Pola
unit

enum (Unit)

Jednostka miary stężenia.

Pole zbiorcze _value.

Pole _value może mieć tylko jedną z tych wartości:
value

number

Liczbowa wartość stężenia.

AdditionalInfo

Zapis JSON 
{
  "sources": string,
  "effects": string
}
Pola
sources

string

Główne źródła emisji zanieczyszczeń.
effects

string

Potencjalny wpływ ekspozycji na zanieczyszczenia na zdrowie.

HealthRecommendations

Zapis JSON 
{
  "generalPopulation": string,
  "elderly": string,
  "lungDiseasePopulation": string,
  "heartDiseasePopulation": string,
  "athletes": string,
  "pregnantWomen": string,
  "children": string
}
Pola
generalPopulation

string

Wskazówki dla ogółu populacji.
elderly

string

Wskazówki dla osób starszych.
lungDiseasePopulation

string

Wskazówki dla osób z chorobami płuc lub układu oddechowego.
heartDiseasePopulation

string

Wskazówki dla osób z chorobami serca lub układu krążenia.
athletes

string

Wskazówki dla sportowców i osób aktywnie spędzających czas na świeżym powietrzu.
pregnantWomen

string

Wskazówki dla kobiet w ciąży.
children

string

Z nadzorem rodzicielskim.

DateTime

Zapis JSON 
{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}
Pola
year

integer

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

integer

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

integer

Opcjonalne. 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 datę i godzinę bez dnia.
hours

integer

Opcjonalne. Godziny w formacie 24-godzinnym. Wartość powinna mieścić się w zakresie od 0 do 23, a domyślnie wynosi 0 (północ). Interfejs API może zezwalać na wartość „24:00:00” w przypadku takich scenariuszy jak godzina zamknięcia firmy.
minutes

integer

Opcjonalne. Minuty w godzinie dnia. Wartość musi mieścić się w zakresie od 0 do 59, domyślnie jest to 0.
seconds

integer

Opcjonalne. Sekundy w minutach danej godziny. Zwykle musi mieścić się w zakresie od 0 do 59, domyślnie 0. Interfejs API może zezwalać na wartość 60, jeśli dopuszcza sekundy przestępne.
nanos

integer

Opcjonalne. Ułamki sekund w nanosekundach. Wartość musi mieścić się w zakresie od 0 do 999 999 999, domyślnie przyjmuje wartość 0.
Pole zbiorcze time_offset. Opcjonalne. Określa przesunięcie względem czasu UTC lub strefę czasową wartości DateTime. Dokonaj starannego wyboru, pamiętając, że dane strefy czasowej mogą się w przyszłości zmienić (np. kraj może zmodyfikować daty rozpoczęcia i zakończenia czasu letniego, a przyszłe wartości DateTime w zakresie, którego dotyczy zmiana, zostały już zapisane). Jeśli zostanie pominięta, zakłada się, że data i godzina są podane w czasie lokalnym. time_offset może mieć tylko jedną z tych wartości:
utcOffset

string (Duration format)

Przesunięcie względem UTC. Musi być liczbą całkowitą sekund z zakresu od –18 godzin do +18 godzin. Na przykład przesunięcie UTC wynoszące –4:00 będzie przedstawione jako { seconds: -14400 }.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".
timeZone

object (TimeZone)

Strefa czasowa.

Czas trwania

Zapis JSON 
{
  "seconds": string,
  "nanos": integer
}
Pola
seconds

string (int64 format)

Sekundy ze znakiem w przedziale czasu. Musi mieścić się w zakresie od -315 576 000 000 do +315 576 000 000 włącznie. Uwaga: te granice są obliczane na podstawie: 60 s/min * 60 min/godz. * 24 godz./dzień * 365,25 dnia/rok * 10 000 lat
nanos

integer

Ułamki sekundy ze znakiem w nanosekundowej rozdzielczości przedziału czasu. Czas trwania krótszy niż 1 sekunda jest reprezentowany przez pole seconds o wartości 0 oraz dodatnie lub ujemne pole nanos. W przypadku czasu trwania wynoszącego co najmniej 1 sekundę wartość pola nanos różna od zera musi mieć taki sam znak jak pole seconds. Wartość musi mieścić się w zakresie od -999 999 999 do +999 999 999 włącznie.

TimeZone

Zapis JSON 
{
  "id": string,
  "version": string
}
Pola
id

string

Strefa czasowa bazy danych stref czasowych IANA. Na przykład „America/New_York”.
version

string

Opcjonalne. Numer wersji bazy danych stref czasowych IANA. Na przykład „2019a”.

PollenResultData

Zapis JSON 
{
  "dailyForecast": {
    object (DailyPollenForecast)
  },
  "attribution": {
    object (Attribution)
  }
}
Pola
dailyForecast

object (DailyPollenForecast)

Dzienna prognoza pylenia dla wybranej daty.
attribution

object (Attribution)

Wymagane informacje o autorstwie, które mają być wyświetlane z danymi o pyleniu.

DailyPollenForecast

Zapis JSON 
{
  "date": {
    object (Date)
  },
  "categories": [
    {
      object (PollenCategoryInfo)
    }
  ],
  "plantSpecies": [
    {
      object (PlantSpeciesInfo)
    }
  ]
}
Pola
date

object (Date)

Data prognozy w kalendarzu cywilnym.
categories[]

object (PollenCategoryInfo)

Podział na ogólne kategorie pyłków (drzewa, trawy, chwasty).
plantSpecies[]

object (PlantSpeciesInfo)

szczegółowy podział gatunków roślin.

PollenCategoryInfo

Zapis JSON 
{
  "displayName": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "healthRecommendations": [
    string
  ]
}
Pola
displayName

string

Wyświetlana nazwa kategorii (np. „Drzewo”, „Trawa”, „Chwast”).
inSeason

boolean

Czy ta kategoria pyłków aktywnie kwitnie w danym regionie.
index

object (PollenIndex)

Pomiar uniwersalnego indeksu pylenia (Universal Pollen Index, UPI) dla tej kategorii.
healthRecommendations[]

string

praktyczne porady zdrowotne dla grup wrażliwych na pyłki;

PollenIndex

Zapis JSON 
{
  "category": string,
  "description": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
Pola
category

string

Zlokalizowana klasyfikacja kategorii (np. „Brak”, „Bardzo niska”, „Niska”, „Umiarkowana”, „Wysoka”, „Bardzo wysoka”).
description

string

Opis poziomu ryzyka pylenia.

Pole zbiorcze _value.

Pole _value może mieć tylko jedną z tych wartości:
value

integer

Liczbowa wartość UPI (skala od 0 do 5).

PlantSpeciesInfo

Zapis JSON 
{
  "code": string,
  "displayName": string,
  "family": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "season": string,
  "crossReactions": string
}
Pola
code

string

Kod gatunku w formacie czytelnym dla komputerów (np. „BIRCH”, „JAPANESE_CEDAR”, „RAGWEED”).
displayName

string

Zlokalizowana wyświetlana nazwa gatunku rośliny (np. „Brzoza”).
family

string

Nazwa rodziny botanicznej (np. „Betulaceae (brzozowate)”).
inSeason

boolean

Czy ten gatunek rośliny jest obecnie w sezonie.
index

object (PollenIndex)

Pomiar uniwersalnego indeksu pylenia (UPI) dla tego gatunku.
season

string

Opis typowego okresu kwitnienia (np. „Późna zima, wiosna”).
crossReactions

string

Znane alergeny reagujące krzyżowo (np. „Pyłki buka, dębu, leszczyny i olchy”).

Jednostka

Reprezentuje jednostkę używaną do pomiaru temperatury.

Wartości w polu enum
UNIT_UNSPECIFIED Jednostka temperatury nie została określona.
CELSIUS Temperatura jest mierzona w stopniach Celsjusza.
FAHRENHEIT Temperatura jest mierzona w stopniach Fahrenheita.

Faza

Wskazuje fazę księżyca.

Wartości w polu enum
PHASE_UNSPECIFIED Nieokreślona faza księżyca.
NEW_MOON Księżyc nie jest oświetlany 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 Księżyc jest oświetlony w 50–100% po lewej stronie na półkuli północnej 🌖 i po prawej stronie na półkuli południowej 🌔.
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 Księżyc jest oświetlony w 0–50% po lewej stronie na półkuli północnej 🌘 i po prawej stronie na półkuli południowej 🌒.

Typ

Oznacza typ warunków pogodowych w kontekście elementu prognozy.

Uwaga: warunki o wartościach 42–139 są obecnie zwracane tylko w przypadku lokalizacji w Japonii i Korei.

Wartości w polu enum
TYPE_UNSPECIFIED Warunki pogodowe nie są określone.
CLEAR Brak chmur.
MOSTLY_CLEAR Okresowe zachmurzenia.
PARTLY_CLOUDY Częściowe zachmurzenie (niewielkie zachmurzenie).
MOSTLY_CLOUDY Duże zachmurzenie (więcej chmur niż słońca).
CLOUDY Pochmurno (tylko chmury, bez słońca).
WINDY Silny wiatr.
WIND_AND_RAIN Silny wiatr z opadami.
LIGHT_RAIN_SHOWERS Lekkie przelotne opady deszczu.
CHANCE_OF_SHOWERS Możliwe przelotne opady deszczu.
SCATTERED_SHOWERS Przelotne opady deszczu.
RAIN_SHOWERS Ulewy to opady deszczu, które trwają krócej niż deszcz i charakteryzują się nagłym początkiem i końcem oraz szybkimi zmianami intensywności.
HEAVY_RAIN_SHOWERS Intensywne opady.
LIGHT_TO_MODERATE_RAIN Deszcz (lekki do umiarkowanego).
MODERATE_TO_HEAVY_RAIN Deszcz (umiarkowany do intensywnego).
RAIN Umiarkowane opady deszczu.
LIGHT_RAIN Niewielkie opady deszczu.
HEAVY_RAIN Ulewa.
RAIN_PERIODICALLY_HEAVY Opady deszczu, okresowo intensywne.
LIGHT_SNOW_SHOWERS Lekkie opady śniegu o zmiennej intensywności przez krótkie okresy.
CHANCE_OF_SNOW_SHOWERS Możliwe przelotne opady śniegu.
SCATTERED_SNOW_SHOWERS Opady śniegu o zmiennej intensywności przez krótkie okresy.
SNOW_SHOWERS Przelotne opady śniegu.
HEAVY_SNOW_SHOWERS Intensywne przelotne opady śniegu.
LIGHT_TO_MODERATE_SNOW Opady śniegu lekkie do umiarkowanych.
MODERATE_TO_HEAVY_SNOW Opady śniegu umiarkowane do silnych.
SNOW Umiarkowane opady śniegu.
LIGHT_SNOW Lekkie opady śniegu.
HEAVY_SNOW Intensywne opady śniegu.
SNOWSTORM Opady śniegu, możliwe burze.
SNOW_PERIODICALLY_HEAVY Opady śniegu, chwilami intensywne.
HEAVY_SNOW_STORM Intensywne opady śniegu, możliwe burze z piorunami.
BLOWING_SNOW Opady śniegu z silnym wiatrem.
RAIN_AND_SNOW Deszcz ze śniegiem.
HAIL Grad.
HAIL_SHOWERS Grad, który pada z różną intensywnością przez krótkie okresy.
THUNDERSTORM Burza z piorunami.
THUNDERSHOWER Opady deszczu, którym towarzyszą burze i wyładowania atmosferyczne.
LIGHT_THUNDERSTORM_RAIN Lekka burza z deszczem.
SCATTERED_THUNDERSTORMS Burze z piorunami i krótkotrwałymi opadami deszczu o różnej intensywności.
HEAVY_THUNDERSTORM Gwałtowna burza.
CLEAR_AFTER_FOG_IN_THE_MORNING Rano mgły, później rozpogodzenie.
CLEAR_BUT_LATER_TURNING_CLOUDY Pogodnie, ale później się zachmurzy.
CLEAR_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN Pogodnie, ale później stopniowo będą pojawiać się opady deszczu lub śniegu z przewagą deszczu.
CLEAR_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW Pogodnie, ale później stopniowo będą pojawiać się opady śniegu lub deszczu z przewagą śniegu.
CLEAR_BUT_THUNDERSTORMS_LATER Pogodnie, później burze.
CLEAR_IN_THE_MORNING_BUT_CLOUDY_IN_THE_EVENING Rano pogodnie, ale wieczór będzie pochmurny.
CLEAR_IN_THE_MORNING_WITH_BRIEF_RAIN_IN_THE_EVENING Rano pogodnie, wieczorem przelotne opady deszczu.
CLEAR_MORNING_WITH_BRIEF_RAIN Rano pogodnie z przelotnymi opadami deszczu.
CLEAR_WITH_BRIEF_RAIN Pogodnie z przelotnymi opadami deszczu.
CLEAR_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Pogodnie, możliwe przelotne opady deszczu lub śniegu z przewagą deszczu.
CLEAR_WITH_BRIEF_RAIN_LATER Pogodnie, później przelotne opady deszczu.
CLEAR_WITH_BRIEF_SNOW Pogodnie z przelotnymi opadami śniegu.
CLEAR_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Pogodnie, możliwe przelotne opady śniegu lub deszczu z przewagą śniegu.
CLEAR_WITH_BRIEF_SNOW_LATER Pogodnie, później przelotne opady śniegu.
CLEAR_WITH_PERIODIC_CLOUDS_LATER Pogodnie, później okresowe zachmurzenie.
CLEAR_WITH_PERIODIC_RAIN Pogodnie z okresowymi opadami deszczu.
CLEAR_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER Pogodnie z okresowymi opadami deszczu i towarzyszącymi im burzami.
CLEAR_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Pogodnie, możliwe okresowe opady deszczu lub śniegu z przewagą deszczu.
CLEAR_WITH_PERIODIC_RAIN_LATER Pogodnie, później okresowe opady deszczu.
CLEAR_WITH_PERIODIC_SNOW Pogodnie z okresowymi opadami śniegu.
CLEAR_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Pogodnie, możliwe okresowe opady śniegu lub deszczu z przewagą śniegu.
CLEAR_WITH_PERIODIC_SNOW_LATER Pogodnie, później okresowe opady śniegu.
CLEAR_WITH_RAIN_AFTER_MIDNIGHT Pogodnie z opadami deszczu po północy.
CLEAR_WITH_RAIN_IN_THE_NIGHT Pogodnie, w nocy opady deszczu.
CLEAR_WITH_RAIN_LATER Pogodnie, później opady deszczu.
CLEAR_WITH_SNOW_ALONG_THE_MOUNTAINS Pogodnie, w górach opady śniegu.
CLEAR_WITH_SNOW_LATER Pogodnie, później opady śniegu.
CLEAR_WITH_THUNDERSTORMS_ALONG_THE_MOUNTAINS Pogodnie, w górach burze.
CLEAR_WITH_THUNDERSTORMS_IN_THE_AFTERNOON Pogodnie, po południu burze.
CLOUDY_BUT_CLEAR_LATER Pochmurno, ale później się rozpogodzi.
CLOUDY_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN Pochmurno, ale później stopniowo będą pojawiać się opady deszczu lub śniegu z przewagą deszczu.
CLOUDY_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW Pochmurno, ale później stopniowo będą pojawiać się opady śniegu lub deszczu z przewagą śniegu.
CLOUDY_BUT_PERIODICALLY_CLEAR_LATER Pochmurno, później okresowe rozpogodzenia.
CLOUDY_BUT_THUNDERSTORMS_LATER Pochmurno, później burze.
CLOUDY_MORNING_WITH_BRIEF_RAIN Pochmurny poranek z przelotnymi opadami deszczu.
CLOUDY_PERIODICALLY_CLEAR Pochmurno, okresowe rozpogodzenia.
CLOUDY_SNOWING_IN_THE_EVENING Pochmurno, wieczorem opady śniegu.
CLOUDY_SNOWING_IN_THE_NIGHT Pochmurno, w nocy opady śniegu.
CLOUDY_WITH_BRIEF_RAIN Pochmurno z przelotnymi opadami deszczu.
CLOUDY_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Pochmurno z przelotnymi opadami deszczu lub śniegu z przewagą deszczu.
CLOUDY_WITH_BRIEF_RAIN_LATER Pochmurno, później przelotne opady deszczu.
CLOUDY_WITH_BRIEF_SNOW Pochmurno z przelotnymi opadami śniegu.
CLOUDY_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Pochmurno z przelotnymi opadami śniegu lub deszczu z przewagą śniegu.
CLOUDY_WITH_BRIEF_SNOW_LATER Pochmurno, później przelotne opady śniegu.
CLOUDY_WITH_BRIEF_THUNDERSTORM Pochmurno z przelotnymi burzami.
CLOUDY_WITH_FOG_ON_THE_OCEAN_AND_AT_THE_SEASHORE Pochmurno, nad oceanem i na wybrzeżu mgły.
CLOUDY_WITH_PERIODIC_RAIN Pochmurno z okresowymi opadami deszczu.
CLOUDY_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER Pochmurno z okresowymi opadami deszczu i towarzyszącymi im burzami.
CLOUDY_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Pochmurno z okresowymi opadami deszczu lub śniegu z przewagą deszczu.
CLOUDY_WITH_PERIODIC_RAIN_LATER Pochmurno, później okresowe opady deszczu.
CLOUDY_WITH_PERIODIC_SNOW Pochmurno z okresowymi opadami śniegu.
CLOUDY_WITH_PERIODIC_SNOW_ACCOMPANIED_BY_THUNDER Pochmurno z okresowymi opadami śniegu i towarzyszącymi im burzami.
CLOUDY_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Pochmurno z okresowymi opadami śniegu lub deszczu z przewagą śniegu.
CLOUDY_WITH_PERIODIC_SNOW_LATER Pochmurno, później okresowe opady śniegu.
CLOUDY_WITH_RAIN_AFTER_MIDNIGHT Pochmurno, po północy opady deszczu.
CLOUDY_WITH_RAIN_FROM_ABOUT_NOON Pochmurno, od południa opady deszczu.
CLOUDY_WITH_RAIN_FROM_EVENING Pochmurno, od wieczora opady deszczu.
CLOUDY_WITH_RAIN_LATER Pochmurno, później opady deszczu.
CLOUDY_WITH_SNOW_FROM_AROUND_NOON Pochmurno, od południa opady śniegu.
CLOUDY_WITH_SNOW_LATER Pochmurno, później opady śniegu.
FOG Mgła.
RAINSNOW_MIX_LATER_BECOMING_CLEAR_RAIN_AS_MAIN Opady deszczu ze śniegiem z przewagą deszczu, później stopniowo się rozpogodzi.
RAINSNOW_MIX_RAIN_AS_MAIN Opady deszczu ze śniegiem z przewagą deszczu.
RAINY_BUT_PERIODICALLY_CLEAR Deszczowo, ale z okresowymi przejaśnieniami.
RAIN_ACCOMPANIED_BY_LIGHTNING Opady deszczu, którym towarzyszą burze.
RAIN_ACCOMPANIED_BY_WINDSTORM Opady deszczu, którym towarzyszy silny wiatr.
RAIN_CLEAR_AT_NIGHT Opady deszczu, w nocy się rozpogodzi.
RAIN_CLEAR_FROM_AROUND_EVENING Opady deszczu, od wieczora się rozpogodzi.
RAIN_CLEAR_FROM_AROUND_NOON Opady deszczu, od południa się rozpogodzi.
RAIN_LATER_BECOMING_CLEAR Opady deszczu, później się rozpogodzi.
RAIN_LATER_BECOMING_CLOUDY Opady deszczu, później pochmurno.
RAIN_LATER_BECOMING_SNOW Opady deszczu przechodzące później w opady śniegu.
RAIN_LATER_WITH_PERIODIC_SNOW Opady deszczu, później okresowo opady śniegu.
RAIN_SNOW_AT_NIGHT W nocy opady deszczu lub śniegu.
RAIN_SNOW_IN_THE_EVENING Wieczorem opady deszczu lub śniegu.
RAIN_TEMPORARILY_BECOMING_SLEET Opady deszczu przechodzącego w deszcz lodowy.
RAIN_THAT_PERIODICALLY_STOPS Przelotne opady deszczu.
RAIN_WITH_BRIEF_SNOW Opady deszczu z przelotnymi opadami śniegu.
RAIN_WITH_PERIODIC_SNOW Opady deszczu z okresowymi opadami śniegu.
SNOWRAIN_MIX_LATER_BECOMING_CLEAR_SNOW_AS_MAIN Opady śniegu z deszczem z przewagą śniegu, później się rozpogodzi.
SNOWRAIN_MIX_LATER_BECOMING_CLOUDY_SNOW_AS_MAIN Opady śniegu z deszczem z przewagą śniegu, później pochmurno.
SNOWRAIN_MIX_SNOW_AS_MAIN Opady śniegu z deszczem z przewagą śniegu.
SNOW_ACCOMPANIED_BY_LIGHTNING Opady śniegu i burze.
SNOW_BECOMING_SLEET Opady śniegu przechodzące w deszcz ze śniegiem.
SNOW_LATER_CLEAR Opady śniegu, później się rozpogodzi.
SNOW_LATER_CLOUDY Opady śniegu, później pochmurno.
SNOW_LATER_RAIN Opady śniegu przechodzące później w opady deszczu.
SNOW_PERIODICALLY_CLEAR Opady śniegu z okresowymi rozpogodzeniami.
SNOW_THAT_PERIODICALLY_STOPS Opady śniegu z okresowymi przerwami.
SNOW_TURNING_TO_RAIN_AROUND_NOON Około południa opady śniegu przechodzące w deszcz.
SNOW_TURNING_TO_RAIN_IN_THE_EVENING Wieczorem opady śniegu przechodzące w deszcz.
SNOW_TURNING_TO_RAIN_IN_THE_NIGHT Opady śniegu przechodzące w nocy w opady deszczu.
SNOW_WITH_BRIEF_RAIN Opady śniegu z przelotnymi opadami deszczu.
SNOW_WITH_BRIEF_SLEET Opady śniegu z przelotnymi opadami deszczu ze śniegiem.
SNOW_WITH_PERIODIC_RAIN Opady śniegu z okresowymi opadami deszczu.
VERY_HOT Bardzo gorące.
SLEET Deszcz ze śniegiem.
HEAVY_RAIN_TO_RAINSTORM Silne opady deszczu, możliwe burze.

Typ

Reprezentuje typ opadów w danej lokalizacji.

Wartości w polu enum
TYPE_UNSPECIFIED Nieokreślony typ opadów.
NONE Brak opadów.
SNOW Opady śniegu.
RAIN Opady deszczu.
LIGHT_RAIN Lekkie opady deszczu.
HEAVY_RAIN Intensywne opady deszczu.
RAIN_AND_SNOW Opady deszczu i śniegu.
SLEET Opady deszczu ze śniegiem.
FREEZING_RAIN Opady marznącego deszczu.
PRECIPITATION_TYPE_HAIL Opady gradu.

Jednostka

Reprezentuje jednostkę używaną do pomiaru ilości skumulowanych opadów.

Wartości w polu enum
UNIT_UNSPECIFIED Nieokreślona jednostka opadów.
MILLIMETERS Ilość opadów jest mierzona w milimetrach.
INCHES Ilość opadów jest mierzona w calach.

Płaszcz kardynała

Reprezentuje kierunek świata (w tym kierunki pośrednie).

Wartości w polu enum
CARDINAL_UNSPECIFIED Kierunek świata nie jest określony.
NORTH Kierunek północny.
NORTH_NORTHEAST Kierunek północno-północno-wschodni.
NORTHEAST Kierunek pośredni północno-wschodni.
EAST_NORTHEAST Kierunek wschodni-północno-wschodni.
EAST Kierunek wschodni.
EAST_SOUTHEAST Kierunek wschodni-południowo-wschodni.
SOUTHEAST Kierunek pośredni południowo-wschodni.
SOUTH_SOUTHEAST Południowy południowy wschód.
SOUTH Kierunek południowy.
SOUTH_SOUTHWEST Południowy południowy zachód.
SOUTHWEST Kierunek pośredni południowo-zachodni.
WEST_SOUTHWEST Kierunek zachodnio-południowo-zachodni.
WEST Kierunek zachodni.
WEST_NORTHWEST Kierunek zachodnio-północno-zachodni.
NORTHWEST Kierunek pośredni północno-zachodni.
NORTH_NORTHWEST Kierunek pośredni północno-północno-zachodni.

Jednostka

Reprezentuje jednostkę używaną do pomiaru prędkości.

Wartości w polu enum
UNIT_UNSPECIFIED Jednostka prędkości nie została określona.
KILOMETERS_PER_HOUR Prędkość jest mierzona w kilometrach na godzinę.
MILES_PER_HOUR Prędkość jest mierzona w milach na godzinę.

Jednostka

Jednostki używane do pomiaru stężenia zanieczyszczeń.

Wartości w polu enum
UNIT_UNSPECIFIED Nieokreślona jednostka stężenia.
PARTS_PER_BILLION Części na miliard (ppb).
MICROGRAMS_PER_CUBIC_METER Mikrogramy na metr sześcienny (µg/m³).

Adnotacje dotyczące narzędzi

Adnotacje narzędzi są wysyłane do klientów MCP, aby opisać podstawowe ryzyko związane z danym narzędziem. Większość klientów traktuje te wskazówki jako niezaufane, ale można ich użyć do określenia, kiedy wysłać użytkownikowi prośbę o potwierdzenie.

Oprócz ciągu tytułu zdefiniowane są te wskazówki logiczne:

  • readOnlyHint: jeśli ma wartość „true”, narzędzie nie modyfikuje swojego środowiska. Wartość domyślna: false.
  • destructiveHint: jeśli ma wartość „true”, narzędzie może wykonywać działania destrukcyjne. Jeśli ma wartość false, narzędzie może wykonywać tylko działania dodawania. Wartość domyślna: true.
  • idempotentHint: jeśli ma wartość „true”, wielokrotne wywoływanie narzędzia z tymi samymi argumentami nie będzie miało dodatkowego wpływu na jego środowisko. Wartość domyślna: false.
  • openWorldHint: jeśli ma wartość true, narzędzie może wchodzić w interakcje z „otwartym światem” podmiotów zewnętrznych. Jeśli ma wartość false, narzędzie może wchodzić w interakcje tylko z elementami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie jest narzędziem typu Otwarty świat, a narzędzie do zapamiętywania – nie.

Wskazówka dotycząca niszczenia: ❌ | Wskazówka dotycząca idempotencji: ❌ | Wskazówka dotycząca tylko do odczytu: ✅ | Wskazówka dotycząca otwartego świata: ❌