MCP Tools Reference: mapstools.googleapis.com

Narzędzie: lookup_weather

Pobiera kompleksowe dane pogodowe, w tym bieżące warunki, prognozy godzinowe i dzienne.

Dostępne dane: temperatura (aktualna, odczuwalna, maksymalna/minimalna, indeks ciepła), wiatr (prędkość, porywy, kierunek), zjawiska astronomiczne (wschód/zachód słońca, faza księżyca), opady (rodzaj, prawdopodobieństwo, ilość/QPF), warunki atmosferyczne (indeks UV, wilgotność, zachmurzenie, prawdopodobieństwo burzy) i adres lokalizacji z geokodowaniem.

Lokalizacja i zasady dotyczące lokalizacji (KRYTYCZNE):

Lokalizacja, dla której są wysyłane dane o pogodzie, jest określana za pomocą pola location. To pole jest strukturą „oneof”, co oznacza, że aby zapewnić dokładne wyszukiwanie danych pogodowych, MUSISZ podać wartość TYLKO w jednym z 3 pól podrzędnych lokalizacji poniżej.

  1. Współrzędne geograficzne (lat_lng)

    • Używaj tej opcji, gdy masz dokładne współrzędne geograficzne.
    • Przykład: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles

  2. Identyfikator miejsca (place_id)

    • jednoznaczny identyfikator w postaci ciągu znaków (identyfikator miejsca w Mapach Google);
    • Identyfikator place_id można pobrać z narzędzia search_places.
    • Przykład: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Wieża Eiffla

  3. Ciąg adresu (address)

    • Ciąg znaków w dowolnym formacie, który wymaga określenia szczegółów na potrzeby geokodowania.
    • Miasto i region: zawsze podawaj region lub kraj (np. „Londyn, Wielka Brytania”, a nie „Londyn”).
    • Adres: podaj pełny adres (np. „1600 Pennsylvania Ave NW, Waszyngton, Dystrykt Kolumbii”).
    • Kody pocztowe: MUSZĄ być podane z nazwą kraju (np. „90210, USA”, a NIE „90210”).
    • Przykład: {"location": {"address": "1600 Pennsylvania Ave NW, Waszyngton, Dystrykt Kolumbii"}}

Tryby użytkowania:

  • Current Weather (Aktualna pogoda): podaj tylko location. Nie podawaj parametrów date i hour.

  • Prognoza godzinowa: podaj location, date i hour (0–23). Używaj ich w przypadku konkretnych godzin (np. „o 17:00”) lub określeń takich jak „w ciągu najbliższych kilku godzin” czy „później”. Jeśli użytkownik poda minuty, zaokrąglij w dół do najbliższej godziny. Prognoza godzinowa na okres dłuższy niż 120 godzin od teraz nie jest obsługiwana. Dane historyczne dotyczące pogody w poszczególnych godzinach są dostępne do 24 godzin wstecz.

  • Prognoza dzienna: podaj location i date. Nie podawaj parametru hour. Używaj w przypadku ogólnych zapytań o dzień (np. „pogoda na jutro”, „pogoda w piątek”, „pogoda 25 grudnia”). Jeśli w kontekście nie ma dzisiejszej daty, wyjaśnij to użytkownikowi. Codzienne prognozy na okres dłuższy niż 10 dni (wliczając dzień bieżący) nie są obsługiwane. Dane historyczne o pogodzie nie są obsługiwane.

Ograniczenia parametru:

  • Strefy czasowe: wszystkie dane wejściowe date i hour muszą być podawane w lokalnej strefie czasowej lokalizacji, a nie w strefie czasowej użytkownika.
  • Format daty: dane wejściowe muszą być rozdzielone na {year, month, day} liczby całkowite.
  • Jednostki: domyślnie METRIC. Ustaw wartość units_system na IMPERIAL w przypadku skali Fahrenheita i mil, jeśli użytkownik sugeruje standardy amerykańskie lub wyraźnie o to prosi.

  • Uzasadniona odpowiedź musi być przypisana do źródła na podstawie informacji z pola attribution, jeśli są one dostępne.

Poniższy przykład pokazuje, jak za pomocą znaku curl wywołać narzędzie lookup_weather MCP.

Żą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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat danych wejściowych

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

LookupWeatherRequest

Zapis JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },

  // 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.
}
Pola
unitsSystem

enum (UnitsSystem)

Opcjonalnie. System jednostek, który ma być używany 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).
location

object (Location)

Wymagane. Lokalizacja, dla której chcesz uzyskać informacje o warunkach pogodowych.

Pole zbiorcze _date.

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

object (Date)

Opcjonalnie. Data wymaganych informacji o pogodzie. Uwaga: data jest określana zgodnie ze strefą czasową lokalizacji podanej w polu lokalizacji. Data musi przypadać w okresie od 24 godzin wstecz do 10 dni w przyszłości.

Pole zbiorcze _hour.

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

integer

Opcjonalnie. Godzina, dla której chcesz uzyskać informacje o pogodzie, w formacie 24-godzinnym (0–23). Ta wartość jest podawana w odniesieniu do lokalnej strefy czasowej lokalizacji określonej w polu lokalizacji. Prognoza godzinowa na okres dłuższy niż 120 godzin od teraz nie jest obsługiwana. Dane historyczne dotyczące pogody w poszczególnych godzinach są dostępne do 24 godzin wstecz.

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 albo rok i miesiąc, w których 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 w formie czytelnej dla człowieka lub kod Plus Code. Więcej informacji znajdziesz na stronie https://plus.codes.

LatLng

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

number

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie od –90,0 do +90,0.
longitude

number

Długość geograficzna w stopniach. Musi mieścić się w zakresie od –180,0 do +180,0.

UnitsSystem

Reprezentuje system 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 itp.).
METRIC System jednostek metrycznych (np.stopnie Celsjusza, kilometry itp.).

Schemat wyjściowy

Odpowiedź na wywołanie procedury RPC LookupWeather – zawiera informacje o warunkach pogodowych w żądanej lokalizacji.

Odpowiedź zawiera informacje zarówno godzinowe, jak i dzienne, dlatego jest podzielona na 3 sekcje: Godzinowe, Dzienne i Udostępnione. Pola Only-Hourly i Only-Daily są oznaczone jako opcjonalne. W przypadku pól, które są wspólne dla informacji godzinowych i dziennych, niektóre są zawsze obecne, więc nie są oznaczone jako opcjonalne, a 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.
}
Pola
weatherCondition

object (WeatherCondition)

warunki pogodowe,
precipitation

object (Precipitation)

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

object (Wind)

warunki wiatrowe,
returnedLocation

object (Location)

Wymagane. Lokalizacja, dla której zwracane są 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 odnosi się do przybliżonej lokalizacji (np. „Mountain View, CA”).
attribution

object (Attribution)

Wymagane atrybucje, które mają być wyświetlane wraz z informacjami o pogodzie.

Pole zbiorcze _temperature.

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

object (Temperature)

Temperatura godzinowa

Pole zbiorcze _feels_like_temperature.

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

object (Temperature)

Godzinowy pomiar temperatury odczuwalnej.

Pole zbiorcze _heat_index.

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

object (Temperature)

Godzinowa temperatura wskaźnika ciepła.

Pole zbiorcze _air_pressure.

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

object (AirPressure)

godzinowe warunki ciśnienia powietrza;

Pole zbiorcze _max_temperature.

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

object (Temperature)

Maksymalna 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 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 (najniższa) 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 i zachód słońca).

Pole zbiorcze _moon_events.

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

object (MoonEvents)

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

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). Zdefiniuj jako opcjonalny, ponieważ nie zawsze jest dostępny.

Pole zbiorcze _uv_index.

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

integer

Maksymalny indeks promieniowania ultrafioletowego (UV). Zdefiniuj opcjonalnie, ponieważ nie zawsze jest dostępny.

Pole zbiorcze _thunderstorm_probability.

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

integer

Prawdopodobieństwo wystąpienia burzy (wartości od 0 do 100). Opcjonalne, ponieważ nie zawsze jest dostępne.

Pole zbiorcze _cloud_cover.

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

integer

Procent pokrycia nieba przez chmury (wartości od 0 do 100). To pole jest opcjonalne, ponieważ nie zawsze jest dostępne.

Temperatura

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

  // 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 (TemperatureUnit)

Kod jednostki używanej do pomiaru wartości 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)

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

Godzina zachodu słońca.

UWAGA: w niektórych wyjątkowych przypadkach (np. na północ od koła podbiegunowego) może nie być czasu zachodu słońca w danym dniu. 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 przedziale 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 część czasu trwania w nanosekundach, a nie alternatywę dla sekund. Ujemne wartości sekund z ułamkami muszą mieć nieujemne wartości nanosekund, które liczą czas do przodu. Musi mieścić się w zakresie od 0 do 999 999 999 włącznie.

MoonEvents

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

string (Timestamp format)

Czas, w którym 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 w ciągu dnia występuje tylko 1 wschód Księżyca. W innych przypadkach lista może być pusta (np. gdy księżyc wschodzi po północy następnego dnia). 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)

Moment, 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 każdego dnia jest tylko 1 godzina zachodu Księżyca. W innych przypadkach lista może być pusta (np. gdy księżyc zachodzi po północy następnego dnia). 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".
moonPhase

enum (MoonPhase)

Faza księżyca.

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 ma jasny motyw, ale w przypadku trybu ciemnego można dodać parametr _dark. 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)

Tekstowy opis warunków pogodowych (w odpowiednim języku).
type

enum (Type)

Rodzaj warunków pogodowych.

LocalizedText

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

string

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

string

Kod języka tekstu w formacie 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 ekwiwalent wody w stanie ciekłym, która zgromadził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 ekwiwalent wody w stanie ciekłym, która zgromadził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 (PrecipitationType),

  // 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 (PrecipitationType)

Kod wskazujący rodzaj opadów.

Pole zbiorcze _percent.

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

integer

Procent od 0 do 100, który 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 ekwiwalent wody w stanie ciekłym, która zgromadziła się w określonym czasie.

Wiatr

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

object (WindDirection)

Kierunek wiatru, czyli kąt, pod jakim wieje wiatr.
speed

object (WindSpeed)

Prędkość wiatru.
gust

object (WindSpeed)

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

WindDirection

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

  // 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 (CardinalDirection)

Kod reprezentujący kierunek główny, 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 (SpeedUnit),

  // 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 (SpeedUnit)

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 w formie czytelnej dla człowieka lub kod Plus Code. Więcej informacji znajdziesz na stronie https://plus.codes.

LatLng

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

number

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie od –90,0 do +90,0.
longitude

number

Długość geograficzna w stopniach. Musi mieścić się w zakresie od –180,0 do +180,0.

Atrybucja

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

string

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

string

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

TemperatureUnit

Reprezentuje jednostkę używaną do pomiaru temperatury.

Wartości w polu enum
TEMPERATURE_UNIT_UNSPECIFIED Jednostka temperatury jest nieokreślona.
CELSIUS Temperatura jest mierzona w stopniach Celsjusza.
FAHRENHEIT Temperatura jest mierzona w stopniach Fahrenheita.

MoonPhase

Oznacza fazę księżyca.

Wartości w polu enum
MOON_PHASE_UNSPECIFIED Nieokreślona faza księżyca.
NEW_MOON Księżyc nie jest oświetlony 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 W przypadku półkuli północnej 🌔 oświetlona jest prawa strona Księżyca (50–100%), a w przypadku półkuli południowej – lewa strona 🌖.
FULL_MOON Księżyc jest w pełni oświetlony.
WANING_GIBBOUS W przypadku półkuli północnej lewa strona Księżyca jest oświetlona w 50–100% 🌖, a w przypadku półkuli południowej – prawa strona 🌔.
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 W przypadku półkuli północnej Księżyc jest oświetlony w 0–50% po lewej stronie 🌘, a w przypadku półkuli południowej – po prawej stronie 🌒.

Typ

Określa typ warunków pogodowych w kontekście elementu prognozy.

Wartości w polu enum
TYPE_UNSPECIFIED Warunki pogodowe są nieokreślone.
CLEAR Brak chmur.
MOSTLY_CLEAR Okresowe zachmurzenia.
PARTLY_CLOUDY Częściowe zachmurzenie (niektóre chmury).
MOSTLY_CLOUDY Przewaga chmur (więcej chmur niż słońca).
CLOUDY Pochmurno (wszystkie chmury, bez słońca).
WINDY Silny wiatr.
WIND_AND_RAIN Silny wiatr z opadami.
LIGHT_RAIN_SHOWERS Przelotne, niewielkie opady deszczu.
CHANCE_OF_SHOWERS Możliwe przelotne opady deszczu.
SCATTERED_SHOWERS Przelotne opady deszczu.
RAIN_SHOWERS Przelotne opady deszczu trwają krócej niż deszcz i charakteryzują się nagłym początkiem i końcem oraz szybką zmianą intensywności.
HEAVY_RAIN_SHOWERS Intensywne opady.
LIGHT_TO_MODERATE_RAIN Opady deszczu (lekkie do umiarkowanych).
MODERATE_TO_HEAVY_RAIN Opady deszczu (umiarkowane do silnych).
RAIN Umiarkowane opady deszczu.
LIGHT_RAIN Niewielkie opady deszczu.
HEAVY_RAIN Intensywne opady deszczu.
RAIN_PERIODICALLY_HEAVY Opady deszczu, okresowo intensywne.
LIGHT_SNOW_SHOWERS Lekki śnieg, który pada z różną intensywnością przez krótkie okresy.
CHANCE_OF_SNOW_SHOWERS Możliwe przelotne opady śniegu.
SCATTERED_SNOW_SHOWERS Opady śniegu o różnym natężeniu, które trwają przez krótki czas.
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 z możliwymi burzami z piorunami.
SNOW_PERIODICALLY_HEAVY Opady śniegu, okresowo intensywne.
HEAVY_SNOW_STORM Intensywne opady śniegu z możliwymi grzmotami i błyskawicami.
BLOWING_SNOW Opady śniegu z silnym wiatrem.
RAIN_AND_SNOW Deszcz ze śniegiem.
HAIL Hail.
HAIL_SHOWERS Grad, który spada z różną intensywnością przez krótki czas.
THUNDERSTORM Burza.
THUNDERSHOWER Ulewa z grzmotami i błyskawicami.
LIGHT_THUNDERSTORM_RAIN Lekka burza z deszczem.
SCATTERED_THUNDERSTORMS Burze z opadami deszczu o różnym natężeniu, które trwają przez krótki czas.
HEAVY_THUNDERSTORM Gwałtowna burza z piorunami.

PrecipitationType

Określa rodzaj opadów w danej lokalizacji.

Wartości w polu enum
PRECIPITATION_TYPE_UNSPECIFIED Nieokreślony typ opadów.
NONE Brak opadów.
SNOW Opady śniegu.
RAIN Opady deszczu.
LIGHT_RAIN Niewielkie 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.

Jednostka

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

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

CardinalDirection

Reprezentuje kierunek główny (w tym kierunki pośrednie).

Wartości w polu enum
CARDINAL_DIRECTION_UNSPECIFIED Kierunek kardynalny 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 Wschód-północny wschód.
EAST Kierunek wschodni.
EAST_SOUTHEAST Wschód-południowy wschód (ESE).
SOUTHEAST Kierunek pośredni południowo-wschodni.
SOUTH_SOUTHEAST Południowo-południowo-wschodni kierunek pośredni.
SOUTH Kierunek południowy.
SOUTH_SOUTHWEST Południowo-południowo-zachodni kierunek pośredni.
SOUTHWEST Kierunek pośredni południowo-zachodni.
WEST_SOUTHWEST Kierunek pośredni zachód-południowy zachód.
WEST Kierunek zachodni.
WEST_NORTHWEST Kierunek pośredni zachód-północny zachód.
NORTHWEST Kierunek pośredni północno-zachodni.
NORTH_NORTHWEST Północno-północno-zachodni kierunek pośredni.

SpeedUnit

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

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

Adnotacje narzędzi

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌