MCP Tools Reference: mapstools.googleapis.com

Narzędzie: lookup_weather

Pobiera kompleksowe dane pogodowe, w tym aktualne warunki oraz prognozy godzinowe i dzienne.

Dostępne dane: temperatura (bieżąca, odczuwalna, maksymalna/minimalna, 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), warunki atmosferyczne (indeks UV, wilgotność, zachmurzenie, prawdopodobieństwo burzy) i adres lokalizacji z kodem geograficznym.

Lokalizacja i reguły dotyczące lokalizacji (KRYTYCZNE):

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

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

    • Używaj go, gdy masz dokładne współrzędne szerokości i długości geograficznej.
    • 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 znaków adresu (address)

    • Ciąg znaków w formacie swobodnym, który wymaga podania szczegółowych informacji 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, Washington, DC”).
    • Kody pocztowe: MUSZĄ zawierać nazwę kraju (np. „90210, USA”, a nie „90210”).
    • Przykład: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

Tryby użytkowania:

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

  • Prognoza godzinowa: podaj location, date i hour (0–23). Używaj konkretnych godzin (np. „o 17:00”) lub określeń takich jak „w ciągu najbliższych kilku godzin” lub „później dzisiaj”. Jeśli użytkownik określi minuty, zaokrąglij w dół do najbliższej godziny. Prognoza godzinowa na okres dłuższy niż 120 godzin nie jest obsługiwana. Historyczne dane o pogodzie 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, poproś użytkownika o jej podanie. Prognoza dzienna obejmująca więcej niż 10 dni (wliczając dzisiejszy) nie jest obsługiwana. Dane historyczne dotyczące pogody nie są obsługiwane.

Ograniczenia parametrów:

  • Strefy czasowe: wszystkie dane wejściowe date i hour muszą być powiązane z lokalną strefą czasową lokalizacji, a nie ze strefą czasową użytkownika.
  • Format daty: dane wejściowe muszą być rozdzielone na {year, month, day} liczb całkowitych.
  • Jednostki: domyślna wartość to METRIC. Ustaw units_system na IMPERIAL dla stopni Fahrenheita i mil, jeśli użytkownik sugeruje standardy amerykańskie lub wyraźnie o nie prosi.

  • Wygenerowane odpowiedzi muszą być przypisane do źródła za pomocą informacji z pola attribution, jeśli są dostępne.

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)
  },

  // 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 zwracanych warunkach pogodowych. Jeśli nie podasz tego parametru, zwrócone warunki pogodowe będą podane w systemie metrycznym (wartość domyślna = METRIC).
location

object (Location)

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

Pole zbiorcze _date.

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

object (Date)

Opcjonalnie: Data, której dotyczą wymagane informacje o pogodzie. Uwaga: ta data jest określana zgodnie z lokalną strefą czasową lokalizacji podanej w polu lokalizacji. Data musi przypadać w ciągu ostatnich 24 godzin lub następnych 10 dni.

Pole zbiorcze _hour.

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

integer

Opcjonalnie: Godzina, dla której mają zostać wyświetlone informacje o pogodzie, w formacie 24-godzinnym (0–23). Ta wartość jest względna i odnosi się do lokalnej strefy czasowej lokalizacji określonej w polu lokalizacji. Prognoza godzinowa na okres dłuższy niż 120 godzin nie jest obsługiwana. Historyczne dane o pogodzie 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 lub rok i miesiąc, gdy dzień nie jest istotny.

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 lub 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 [-90,0, +90,0].
longitude

number

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

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

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.
}
Pola
weatherCondition

object (WeatherCondition)

warunki pogodowe,
precipitation

object (Precipitation)

prawdopodobieństwo opadów i ich ilość,
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, 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 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 odczuwalna.

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 (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 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, 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). 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 jako opcjonalny, 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 burzy (wartości od 0 do 100). Zdefiniuj jako 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 nieba pokrytego chmurami (wartości od 0 do 100). Zdefiniuj jako 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)

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ć godziny 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 nanosekundy, a nie sekundy. 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 
{
  "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 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".
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 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 (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 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, która nagromadziła się w określonym czasie.

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 (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, 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 zrozumiały dla człowieka lub 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 [-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.

TemperatureUnit

Reprezentuje jednostkę używaną do pomiaru temperatury.

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

MoonPhase

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

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 (same chmury, brak 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 intensywnych.
SNOW Umiarkowane opady śniegu.
LIGHT_SNOW Niewielkie 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 Ulewa z towarzyszącymi jej burzami i wyładowaniami.
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.

PrecipitationType

Reprezentuje typ 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 Lekkie opady deszczu.
HEAVY_RAIN Intensywne opady deszczu.
RAIN_AND_SNOW Opady deszczu i śniegu.
SLEET Deszcz ze śniegiem.
FREEZING_RAIN Opady marznącego deszczu.

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

CardinalDirection

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

Wartości w polu enum
CARDINAL_DIRECTION_UNSPECIFIED Kierunek świata nie jest określony.
NORTH Kierunek północny.
NORTH_NORTHEAST Kierunek pośredni 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łudniowy wschód.
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 pośredni zachód-północny zachód.
NORTHWEST Kierunek pośredni północno-zachodni.
NORTH_NORTHWEST Kierunek północno-północno-zachodni.

SpeedUnit

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

Wartości w polu enum
SPEED_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ę.

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” elementó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, ale narzędzie do zapamiętywania już nie.

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