MCP Tools Reference: mapstools.googleapis.com

Tool: lookup_weather

Ruft umfassende Wetterdaten ab, einschließlich aktueller Bedingungen, stündlicher und täglicher Vorhersagen.

Verfügbare Daten: Temperatur (aktuell, gefühlt, Höchst-/Tiefstwert, Hitzeindex), Wind (Geschwindigkeit, Böen, Richtung), Himmelsereignisse (Sonnenaufgang/-untergang, Mondphase), Niederschlag (Art, Wahrscheinlichkeit, Menge/QPF), atmosphärische Bedingungen (UV-Index, Luftfeuchtigkeit, Bewölkung, Gewitterwahrscheinlichkeit) und geocodierte Standortadresse.

Standort und standortbezogene Regeln (WICHTIG):

Der Ort, für den Wetterdaten angefordert werden, wird im Feld location angegeben. Dieses Feld ist eine „oneof“-Struktur. Das bedeutet, dass Sie NUR für EINES der drei Standortunterfelder unten einen Wert angeben MÜSSEN, damit die Wetterdaten korrekt abgerufen werden können.

  1. Geografische Koordinaten (lat_lng)

    • Verwenden Sie ihn, wenn Sie genaue Breiten- und Längengradkoordinaten haben.
    • Beispiel: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles
  2. Orts-ID (place_id)

    • Eine eindeutige String-ID (Google Maps-Orts-ID).
    • Die „place_id“ kann über das Tool „search_places“ abgerufen werden.
    • Beispiel: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Eiffelturm
  3. Adressstring (address)

    • Ein frei definierbarer String, der für die Geocodierung spezifisch sein muss.
    • Ort und Region: Geben Sie immer die Region/das Land an (z.B. „London, Vereinigtes Königreich“, nicht „London“).
    • Adresse: Geben Sie die vollständige Adresse an (z.B. „1600 Pennsylvania Ave NW, Washington, DC“).
    • Postleitzahlen: MÜSSEN zusammen mit einem Ländernamen angegeben werden (z.B. „90210, USA“, NICHT „90210“).
    • Beispiel: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

Nutzungsmodi:

  • Aktuelles Wetter: Gib nur location an. Geben Sie date und hour nicht an.

  • Stündliche Vorhersage: Geben Sie location, date und hour (0–23) an. Verwenden Sie diese Option für bestimmte Uhrzeiten (z.B. „um 17:00 Uhr“) oder Begriffe wie „in den nächsten Stunden“ oder „später am Tag“. Wenn der Nutzer die Minute angibt, wird auf die nächste Stunde abgerundet. Stündliche Vorhersagen für mehr als 120 Stunden im Voraus werden nicht unterstützt. Historische stündliche Wetterdaten werden bis zu 24 Stunden in der Vergangenheit unterstützt.

  • Tagesprognose: Geben Sie location und date an. Geben Sie hour nicht an. Verwenden Sie diese Option für allgemeine Tagesanfragen (z. B. „Wetter für morgen“, „Wetter am Freitag“, „Wetter am 25. Dezember“). Wenn das heutige Datum nicht im Kontext enthalten ist, sollten Sie es mit dem Nutzer klären. Tagesprognosen für mehr als 10 Tage, einschließlich heute, werden nicht unterstützt. Historische Wetterdaten werden nicht unterstützt.

Parametereinschränkungen:

  • Zeitzonen: Alle date- und hour-Eingaben müssen sich auf die lokale Zeitzone des Standorts beziehen, nicht auf die Zeitzone des Nutzers.
  • Datumsformat: Die Eingaben müssen in {year, month, day} Ganzzahlen aufgeteilt werden.
  • Einheiten: Der Standardwert ist METRIC. Setze units_system auf IMPERIAL für Fahrenheit/Meilen, wenn der Nutzer US-Standards impliziert oder explizit danach fragt.
  • Die fundierte Ausgabe muss der Quelle zugeordnet werden. Verwenden Sie dazu die Informationen aus dem Feld attribution, sofern verfügbar.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool lookup_weather aufrufen.

Curl-Anfrage
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
}'

Eingabeschema

Anfrage für die LookupWeather-Methode – stellt die Wetterbedingungen am angeforderten Standort dar.

LookupWeatherRequest

JSON-Darstellung
{
  "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.
}
Felder
unitsSystem

enum (UnitsSystem)

Optional. Das Einheitensystem, das für die zurückgegebenen Wetterbedingungen verwendet werden soll. Wenn nicht angegeben, werden die zurückgegebenen Wetterbedingungen im metrischen System angegeben (Standard = METRIC).

location

object (Location)

Erforderlich. Der Ort, für den die Wetterbedingungen abgerufen werden sollen.

Union-Feld _date.

Für _date ist nur einer der folgenden Werte zulässig:

date

object (Date)

Optional. Das Datum der erforderlichen Wetterinformationen. Hinweis: Dieses Datum bezieht sich auf die lokale Zeitzone des im Feld „Standort“ angegebenen Standorts. Das Datum muss zwischen 24 Stunden in der Vergangenheit und den nächsten 10 Tagen liegen.

Union-Feld _hour.

Für _hour ist nur einer der folgenden Werte zulässig:

hour

integer

Optional. Die Stunde der angeforderten Wetterinformationen im 24-Stunden-Format (0–23). Dieser Wert bezieht sich auf die lokale Zeitzone des im Feld „Standort“ angegebenen Standorts. Stündliche Vorhersagen für mehr als 120 Stunden im Voraus werden nicht unterstützt. Historische stündliche Wetterdaten werden bis zu 24 Stunden in der Vergangenheit unterstützt.

Datum

JSON-Darstellung
{
  "year": integer,
  "month": integer,
  "day": integer
}
Felder
year

integer

Jahr des Datums. Der Wert muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahreszahl angegeben wird.

month

integer

Monat eines Jahres. Der Wert muss zwischen 1 und 12 liegen. Er kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird.

day

integer

Tag eines Monats. Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Er kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht relevant ist.

Standort

JSON-Darstellung
{

  // 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.
}
Felder
Union-Feld location_type. Verschiedene Möglichkeiten, einen Ort darzustellen. Für location_type ist nur einer der folgenden Werte zulässig:
latLng

object (LatLng)

Ein Punkt, der mit geografischen Koordinaten angegeben wird.

placeId

string

Die Orts-ID, die dem Standort zugeordnet ist .

address

string

Menschenlesbare Adresse oder Plus Code. Weitere Informationen finden Sie unter https://plus.codes.

LatLng

JSON-Darstellung
{
  "latitude": number,
  "longitude": number
}
Felder
latitude

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.

longitude

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

UnitsSystem

Stellt das Einheitensystem dar, das zum Messen von Werten verwendet wird.

Enums
UNITS_SYSTEM_UNSPECIFIED Das Einheitensystem ist nicht angegeben.
IMPERIAL Das angloamerikanische Maßsystem (z.B. Fahrenheit, Meilen usw.)
METRIC Das metrische Einheitensystem (z.B. Celsius, Kilometer usw.)

Ausgabeschema

Antwort für den LookupWeather-RPC – stellt die Wetterbedingungen am angeforderten Standort dar.

Diese Antwort enthält sowohl stündliche als auch tägliche Informationen. Daher ist die Antwort in drei Abschnitte unterteilt: „Hourly“, „Daily“ und „Shared“. Felder, die nur stündlich oder nur täglich aktualisiert werden, sind als optional gekennzeichnet. Einige Felder, die sowohl für stündliche als auch für tägliche Informationen verwendet werden, sind immer vorhanden und daher nicht als optional gekennzeichnet. Die restlichen Felder sind als optional gekennzeichnet, da sie nicht immer verfügbar sind.

LookupWeatherResponse

JSON-Darstellung
{
  "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.
}
Felder
weatherCondition

object (WeatherCondition)

Die Wetterbedingungen

precipitation

object (Precipitation)

Niederschlagswahrscheinlichkeit und Niederschlagsmenge

wind

object (Wind)

Windbedingungen

returnedLocation

object (Location)

Erforderlich. Der Ort, für den die Wetterinformationen zurückgegeben werden. Dieser Ort ist mit dem Ort in der Anfrage identisch, kann sich aber von ihm unterscheiden, wenn der angefragte Ort eine Freitextadresse ist, die auf einen ungefähren Standort verweist (z.B. „Mountain View, CA“).

attribution

object (Attribution)

Erforderliche Quellenangabe, die mit dem Wetter angezeigt werden soll.

Union-Feld _temperature.

Für _temperature ist nur einer der folgenden Werte zulässig:

temperature

object (Temperature)

Die stündliche Temperatur

Union-Feld _feels_like_temperature.

Für _feels_like_temperature ist nur einer der folgenden Werte zulässig:

feelsLikeTemperature

object (Temperature)

Die stündliche Messung der gefühlten Temperatur.

Union-Feld _heat_index.

Für _heat_index ist nur einer der folgenden Werte zulässig:

heatIndex

object (Temperature)

Die stündliche Hitzeindex-Temperatur.

Union-Feld _air_pressure.

Für _air_pressure ist nur einer der folgenden Werte zulässig:

airPressure

object (AirPressure)

Der Luftdruck pro Stunde.

Union-Feld _max_temperature.

Für _max_temperature ist nur einer der folgenden Werte zulässig:

maxTemperature

object (Temperature)

Die Höchsttemperatur im Tagesverlauf.

Union-Feld _min_temperature.

Für _min_temperature ist nur einer der folgenden Werte zulässig:

minTemperature

object (Temperature)

Die Mindesttemperatur (niedrigste Temperatur) im Laufe des Tages.

Union-Feld _feels_like_max_temperature.

Für _feels_like_max_temperature ist nur einer der folgenden Werte zulässig:

feelsLikeMaxTemperature

object (Temperature)

Die maximale (höchste) gefühlte Temperatur im Tagesverlauf.

Union-Feld _feels_like_min_temperature.

Für _feels_like_min_temperature ist nur einer der folgenden Werte zulässig:

feelsLikeMinTemperature

object (Temperature)

Die minimale (niedrige) gefühlte Temperatur im Laufe des Tages.

Union-Feld _max_heat_index.

Für _max_heat_index ist nur einer der folgenden Werte zulässig:

maxHeatIndex

object (Temperature)

Die maximale Hitzeindex-Temperatur im Laufe des Tages.

Union-Feld _sun_events.

Für _sun_events ist nur einer der folgenden Werte zulässig:

sunEvents

object (SunEvents)

Ereignisse im Zusammenhang mit der Sonne (z.B. Sonnenaufgang, Sonnenuntergang).

Union-Feld _moon_events.

Für _moon_events ist nur einer der folgenden Werte zulässig:

moonEvents

object (MoonEvents)

Ereignisse im Zusammenhang mit dem Mond (z.B. Mondaufgang, Monduntergang).

Union-Feld _relative_humidity.

Für _relative_humidity ist nur einer der folgenden Werte zulässig:

relativeHumidity

integer

Die relative Luftfeuchtigkeit in Prozent (Werte von 0 bis 100). Optional, da nicht immer verfügbar.

Union-Feld _uv_index.

Für _uv_index ist nur einer der folgenden Werte zulässig:

uvIndex

integer

Der maximale UV-Index. Optional, da nicht immer verfügbar.

Union-Feld _thunderstorm_probability.

Für _thunderstorm_probability ist nur einer der folgenden Werte zulässig:

thunderstormProbability

integer

Die Gewitterwahrscheinlichkeit (Werte von 0 bis 100). Optional, da nicht immer verfügbar.

Union-Feld _cloud_cover.

Für _cloud_cover ist nur einer der folgenden Werte zulässig:

cloudCover

integer

Der Prozentsatz des Himmels, der von Wolken bedeckt ist (Werte von 0 bis 100). Optional, da nicht immer verfügbar.

Temperatur

JSON-Darstellung
{
  "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.
}
Felder
unit

enum (TemperatureUnit)

Der Code für die Einheit, die zur Messung des Temperaturwerts verwendet wird.

Union-Feld _degrees.

Für _degrees ist nur einer der folgenden Werte zulässig:

degrees

number

Der Temperaturwert (in Grad) in der angegebenen Einheit.

AirPressure

JSON-Darstellung
{

  // 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.
}
Felder

Union-Feld _mean_sea_level_millibars.

Für _mean_sea_level_millibars ist nur einer der folgenden Werte zulässig:

meanSeaLevelMillibars

number

Der mittlere Luftdruck auf Meereshöhe in Millibar.

SunEvents

JSON-Darstellung
{
  "sunriseTime": string,
  "sunsetTime": string
}
Felder
sunriseTime

string (Timestamp format)

Die Zeit, zu der die Sonne aufgeht.

HINWEIS: In einigen seltenen Fällen (z.B. nördlich des Polarkreises) gibt es an manchen Tagen keine Sonnenaufgangszeit. In diesen Fällen wird dieses Feld nicht festgelegt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

sunsetTime

string (Timestamp format)

Die Uhrzeit, zu der die Sonne untergeht.

HINWEIS: In einigen seltenen Fällen (z.B. nördlich des Polarkreises) gibt es an einem Tag möglicherweise keine Sonnenuntergangszeit. In diesen Fällen wird dieses Feld nicht festgelegt.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Zeitstempel

JSON-Darstellung
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss zwischen -62135596800 und 253402300799 (einschließlich) liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).

nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld ist der Nanosekunden-Teil der Dauer, keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 (einschließlich) liegen.

MoonEvents

JSON-Darstellung
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Felder
moonriseTimes[]

string (Timestamp format)

Die Zeit, zu der der obere Rand des Mondes über dem Horizont erscheint (siehe https://en.wikipedia.org/wiki/Moonrise_and_moonset)).

HINWEIS: In den meisten Fällen gibt es pro Tag nur eine Mondaufgangszeit. In anderen Fällen ist die Liste möglicherweise leer (z.B. wenn der Mond nach Mitternacht des nächsten Tages aufgeht). In seltenen Fällen (z.B. in Polargebieten) kann die Liste jedoch mehr als einen Wert enthalten. In diesen Fällen werden die Werte in aufsteigender Reihenfolge sortiert.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

moonsetTimes[]

string (Timestamp format)

Die Zeit, zu der der obere Rand des Mondes am Horizont untergeht (siehe https://en.wikipedia.org/wiki/Moonrise_and_moonset)).

HINWEIS: In den meisten Fällen gibt es pro Tag nur eine Monduntergangszeit. In anderen Fällen ist die Liste möglicherweise leer (z.B. wenn der Mond nach Mitternacht des nächsten Tages untergeht). In seltenen Fällen (z.B. in Polargebieten) kann die Liste jedoch mehr als einen Wert enthalten. In diesen Fällen werden die Werte in aufsteigender Reihenfolge sortiert.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

moonPhase

enum (MoonPhase)

Die Mondphase.

WeatherCondition

JSON-Darstellung
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
Felder
iconBaseUri

string

Der Basis-URI für das Symbol ohne die Dateityperweiterung. Wenn Sie das Symbol anzeigen möchten, hängen Sie bei Bedarf ein Design und die Dateityperweiterung (.png oder .svg) an diesen URI an. Standardmäßig wird das Symbol im hellen Design angezeigt. Für den dunklen Modus kann jedoch _dark angehängt werden. Beispiel: „https://maps.gstatic.com/weather/v1/dust.svg“ oder „https://maps.gstatic.com/weather/v1/dust_dark.svg“, wobei icon_base_uri „https://maps.gstatic.com/weather/v1/dust“ ist.

description

object (LocalizedText)

Die Textbeschreibung für diese Wetterbedingung (lokalisiert).

type

enum (Type)

Die Art der Wetterbedingung.

LocalizedText

JSON-Darstellung
{
  "text": string,
  "languageCode": string
}
Felder
text

string

Lokalisierter String in der Sprache, die unten google.type.LocalizedText.language_code entspricht.

languageCode

string

Der BCP-47-Sprachcode des Texts, z. B. „en-US“ oder „sr-Latn“.

Weitere Informationen finden Sie unter http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

Niederschlag

JSON-Darstellung
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Felder
probability

object (PrecipitationProbability)

Die Niederschlagswahrscheinlichkeit (Werte von 0 bis 100).

snowQpf

object (QuantitativePrecipitationForecast)

Die Schneemenge, gemessen als Flüssigwasseräquivalent, die sich über einen bestimmten Zeitraum angesammelt hat. Hinweis: QPF ist die Abkürzung für Quantitative Precipitation Forecast (Quantitative Niederschlagsvorhersage). Weitere Informationen finden Sie in der Definition von QuantitativePrecipitationForecast.

qpf

object (QuantitativePrecipitationForecast)

Die Niederschlagsmenge, gemessen als Flüssigwasseräquivalent, die sich über einen bestimmten Zeitraum angesammelt hat. Hinweis: QPF ist die Abkürzung für Quantitative Precipitation Forecast (Quantitative Niederschlagsvorhersage). Weitere Informationen finden Sie in der Definition von QuantitativePrecipitationForecast.

PrecipitationProbability

JSON-Darstellung
{
  "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.
}
Felder
type

enum (PrecipitationType)

Ein Code, der die Art des Niederschlags angibt.

Union-Feld _percent.

Für _percent ist nur einer der folgenden Werte zulässig:

percent

integer

Ein Prozentsatz von 0 bis 100, der die Niederschlagswahrscheinlichkeit angibt.

QuantitativePrecipitationForecast

JSON-Darstellung
{
  "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.
}
Felder
unit

enum (Unit)

Der Code der Einheit, die zur Messung der akkumulierten Niederschlagsmenge verwendet wird.

Union-Feld _quantity.

Für _quantity ist nur einer der folgenden Werte zulässig:

quantity

number

Die Niederschlagsmenge, gemessen als Flüssigwasseräquivalent, die sich über einen bestimmten Zeitraum angesammelt hat.

Wind

JSON-Darstellung
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
Felder
direction

object (WindDirection)

Die Richtung des Windes, der Winkel, aus dem er kommt.

speed

object (WindSpeed)

Die Windgeschwindigkeit.

gust

object (WindSpeed)

Windböen (plötzlicher Anstieg der Windgeschwindigkeit)

WindDirection

JSON-Darstellung
{
  "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.
}
Felder
cardinal

enum (CardinalDirection)

Der Code, der die Himmelsrichtung angibt, aus der der Wind weht.

Union-Feld _degrees.

Für _degrees ist nur einer der folgenden Werte zulässig:

degrees

integer

Die Windrichtung in Grad (Werte von 0 bis 360).

WindSpeed

JSON-Darstellung
{
  "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.
}
Felder
unit

enum (SpeedUnit)

Der Code, der die Einheit darstellt, die zur Messung der Windgeschwindigkeit verwendet wird.

Union-Feld _value.

Für _value ist nur einer der folgenden Werte zulässig:

value

number

Der Wert der Windgeschwindigkeit.

Standort

JSON-Darstellung
{

  // 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.
}
Felder
Union-Feld location_type. Verschiedene Möglichkeiten, einen Ort darzustellen. Für location_type ist nur einer der folgenden Werte zulässig:
latLng

object (LatLng)

Ein Punkt, der mit geografischen Koordinaten angegeben wird.

placeId

string

Die Orts-ID, die dem Standort zugeordnet ist .

address

string

Menschenlesbare Adresse oder Plus Code. Weitere Informationen finden Sie unter https://plus.codes.

LatLng

JSON-Darstellung
{
  "latitude": number,
  "longitude": number
}
Felder
latitude

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.

longitude

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

Attribution

JSON-Darstellung
{
  "title": string,
  "url": string
}
Felder
title

string

Der Titel, der für die Attribution angezeigt werden soll.

url

string

Die URL, auf die für die Attribution verlinkt werden soll.

TemperatureUnit

Stellt eine Einheit dar, die zum Messen von Temperaturen verwendet wird.

Enums
TEMPERATURE_UNIT_UNSPECIFIED Die Temperatureinheit ist nicht angegeben.
CELSIUS Die Temperatur wird in Celsius gemessen.
FAHRENHEIT Die Temperatur wird in Fahrenheit gemessen.

MoonPhase

Zeigt die Mondphase an.

Enums
MOON_PHASE_UNSPECIFIED Nicht angegebene Mondphase.
NEW_MOON Der Mond wird nicht von der Sonne beleuchtet.
WAXING_CRESCENT Der Mond wird auf der Nordhalbkugel auf der rechten Seite zu 0–50 % beleuchtet 🌒 und auf der Südhalbkugel auf der linken Seite 🌘.
FIRST_QUARTER Der Mond wird auf der Nordhalbkugel auf der rechten Seite zu 50,1 % beleuchtet 🌓 und auf der Südhalbkugel auf der linken Seite 🌗.
WAXING_GIBBOUS Der Mond ist auf der Nordhalbkugel auf der rechten Seite zu 50–100 % beleuchtet 🌔 und auf der Südhalbkugel auf der linken Seite 🌖.
FULL_MOON Der Mond ist vollständig beleuchtet.
WANING_GIBBOUS Der Mond wird auf der Nordhalbkugel zu 50–100 % auf der linken Seite 🌖 und auf der Südhalbkugel auf der rechten Seite 🌔 beleuchtet.
LAST_QUARTER Der Mond wird auf der Nordhalbkugel auf der linken Seite zu 50,1 % beleuchtet 🌗 und auf der Südhalbkugel auf der rechten Seite 🌓.
WANING_CRESCENT Der Mond wird auf der Nordhalbkugel auf der linken Seite 🌘 und auf der Südhalbkugel auf der rechten Seite 🌒 zu 0–50 % beleuchtet.

Typ

Kennzeichnet den Typ der Wetterbedingung im Kontext eines Vorhersageelements.

Enums
TYPE_UNSPECIFIED Die Wetterbedingung ist nicht angegeben.
CLEAR Keine Wolken.
MOSTLY_CLEAR Vereinzelt Wolken.
PARTLY_CLOUDY Teils bewölkt (einige Wolken).
MOSTLY_CLOUDY Überwiegend bewölkt (mehr Wolken als Sonne).
CLOUDY Wolkig (nur Wolken, keine Sonne).
WINDY Starker Wind.
WIND_AND_RAIN Starker Wind mit Niederschlag.
LIGHT_RAIN_SHOWERS Zeitweise leichter Regen.
CHANCE_OF_SHOWERS Zeitweise Regen möglich.
SCATTERED_SHOWERS Zeitweise Regen.
RAIN_SHOWERS Schauer sind Regenfälle, die kürzer als Regen sind und sich durch plötzliches Einsetzen und Aufhören sowie schnelle Änderungen der Intensität auszeichnen.
HEAVY_RAIN_SHOWERS Starke Schauer.
LIGHT_TO_MODERATE_RAIN Regen (leicht bis mäßig).
MODERATE_TO_HEAVY_RAIN Regen (mäßig bis stark).
RAIN Mäßiger Regen.
LIGHT_RAIN Leichter Regen.
HEAVY_RAIN Starker Regen.
RAIN_PERIODICALLY_HEAVY Zeitweise starker Regen.
LIGHT_SNOW_SHOWERS Leichter Schneefall, der für kurze Zeit mit unterschiedlicher Intensität fällt.
CHANCE_OF_SNOW_SHOWERS Schneeschauer möglich.
SCATTERED_SNOW_SHOWERS Schnee, der für kurze Zeit mit unterschiedlicher Intensität fällt.
SNOW_SHOWERS Schneeschauer.
HEAVY_SNOW_SHOWERS Starke Schneeschauer.
LIGHT_TO_MODERATE_SNOW Leichter bis mäßiger Schneefall.
MODERATE_TO_HEAVY_SNOW Mäßiger bis starker Schneefall.
SNOW Mäßiger Schneefall.
LIGHT_SNOW Leichter Schneefall.
HEAVY_SNOW Starker Schneefall.
SNOWSTORM Schnee mit möglichem Gewitter.
SNOW_PERIODICALLY_HEAVY Schnee, zeitweise stark.
HEAVY_SNOW_STORM Starker Schneefall mit möglichem Gewitter.
BLOWING_SNOW Schnee mit starkem Wind.
RAIN_AND_SNOW Schneeregen.
HAIL Hagel.
HAIL_SHOWERS Hagel, der für kurze Zeit mit unterschiedlicher Intensität fällt.
THUNDERSTORM Gewitter.
THUNDERSHOWER Ein Regenschauer, begleitet von Donner und Blitz.
LIGHT_THUNDERSTORM_RAIN Leichte Gewitter mit Regen.
SCATTERED_THUNDERSTORMS Gewitter mit Regen unterschiedlicher Intensität für kurze Zeit.
HEAVY_THUNDERSTORM Starkes Gewitter.

PrecipitationType

Stellt die Art des Niederschlags an einem bestimmten Ort dar.

Enums
PRECIPITATION_TYPE_UNSPECIFIED Nicht angegebener Niederschlagstyp.
NONE Kein Niederschlag.
SNOW Schneefall.
RAIN Regen.
LIGHT_RAIN Leichter Regen.
HEAVY_RAIN Starker Regen.
RAIN_AND_SNOW Sowohl Regen als auch Schnee.
SLEET Schneeregen.
FREEZING_RAIN Gefrierender Regen.

Einheit

Die Einheit, in der die Menge des akkumulierten Niederschlags gemessen wird.

Enums
UNIT_UNSPECIFIED Nicht angegebene Niederschlagseinheit.
MILLIMETERS Die Niederschlagsmenge wird in Millimetern gemessen.
INCHES Die Niederschlagsmenge wird in Zoll gemessen.

CardinalDirection

Stellt eine Himmelsrichtung dar (einschließlich Zwischenrichtungen).

Enums
CARDINAL_DIRECTION_UNSPECIFIED Die Himmelsrichtung ist nicht angegeben.
NORTH Die Himmelsrichtung Norden.
NORTH_NORTHEAST Die sekundäre Zwischenrichtung Nord-Nordost.
NORTHEAST Die nordöstliche Zwischenrichtung.
EAST_NORTHEAST Die sekundäre interkardinale Richtung Ost-Nordost.
EAST Die Himmelsrichtung Osten.
EAST_SOUTHEAST Die sekundäre Zwischenrichtung Ost-Südost.
SOUTHEAST Die südöstliche Zwischenrichtung.
SOUTH_SOUTHEAST Die sekundäre Zwischenrichtung Süd-Südost.
SOUTH Die Himmelsrichtung Süden.
SOUTH_SOUTHWEST Die sekundäre interkardinale Richtung Süd-Südwest.
SOUTHWEST Die südwestliche Zwischenhimmelsrichtung.
WEST_SOUTHWEST Die sekundäre interkardinale Richtung West-Südwest.
WEST Die Himmelsrichtung Westen.
WEST_NORTHWEST Die sekundäre Interkardinalrichtung Westnordwest.
NORTHWEST Die interkardinale Richtung Nordwesten.
NORTH_NORTHWEST Die sekundäre Zwischenrichtung Nord-Nordwest.

SpeedUnit

Die Einheit, in der die Geschwindigkeit gemessen wird.

Enums
SPEED_UNIT_UNSPECIFIED Die Geschwindigkeitseinheit ist nicht angegeben.
KILOMETERS_PER_HOUR Die Geschwindigkeit wird in Kilometern pro Stunde gemessen.
MILES_PER_HOUR Die Geschwindigkeit wird in Meilen pro Stunde gemessen.

Tool-Annotationen

Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.

Zusätzlich zum Titelstring werden die folgenden booleschen Hinweise definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“, kann das Tool nur mit internen Entitäten interagieren. Ein Tool für die Websuche wäre beispielsweise ein Open-World-Tool, ein Tool für gemerkte Informationen dagegen nicht.

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Lesezugriff-Hinweis: ✅ | Hinweis „Open World“: ❌