MCP Tools Reference: mapstools.googleapis.com

Outil : lookup_weather

Récupère des données météorologiques complètes, y compris les conditions actuelles, les prévisions horaires et quotidiennes.

Données spécifiques disponibles : température (actuelle, ressentie, maximale/minimale, indice de chaleur), vent (vitesse, rafales, direction), événements célestes (lever/coucher du soleil, phase de la lune), précipitations (type, probabilité, quantité/QPF), conditions atmosphériques (indice UV, humidité, nébulosité, probabilité d'orage) et adresse de localisation géocodée.

Emplacement et règles d'emplacement (CRITIQUE) :

L'emplacement pour lequel les données météorologiques sont demandées est spécifié à l'aide du champ location. Ce champ est une structure "oneof", ce qui signifie que vous DEVEZ fournir une valeur pour UN SEUL des trois sous-champs de localisation ci-dessous afin de garantir une recherche précise des données météorologiques.

  1. Coordonnées géographiques (lat_lng)

    • Utilisez-le lorsque vous disposez de coordonnées exactes de latitude et de longitude.
    • Exemple : {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles

  2. ID de lieu (place_id)

    • Identifiant de chaîne non ambigu (ID de lieu Google Maps).
    • L'identifiant de lieu peut être récupéré à partir de l'outil search_places.
    • Exemple : {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Tour Eiffel

  3. Chaîne d'adresse (adresse)

    • Chaîne au format libre qui nécessite d'être spécifique pour le géocodage.
    • Ville et région : incluez toujours la région/le pays (par exemple, "Londres, Royaume-Uni", et non "Londres").
    • Adresse postale : indiquez l'adresse complète (par exemple, "1600 Pennsylvania Ave NW, Washington, DC").
    • Codes postaux : ils DOIVENT être accompagnés du nom du pays (par exemple, "90210, États-Unis", et non "90210").
    • Exemple : {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

Modes d'utilisation :

  • Météo actuelle : fournissez uniquement location. Ne spécifiez pas date ni hour.

  • Prévisions horaires : indiquez location, date et hour (0 à 23). Utilisez-le pour des heures spécifiques (par exemple, "à 17h") ou des expressions comme "dans les prochaines heures" ou "plus tard dans la journée". Si l'utilisateur spécifie une minute, arrondissez à l'heure inférieure. Les prévisions horaires au-delà de 120 heures ne sont pas disponibles. Les données météorologiques horaires historiques sont disponibles jusqu'à 24 heures en arrière.

  • Prévisions quotidiennes : indique location et date. Ne spécifiez pas hour. Utilisez-le pour les demandes générales concernant un jour (par exemple, "météo pour demain", "météo pour vendredi", "météo pour le 25/12"). Si la date du jour ne figure pas dans le contexte, vous devez la demander à l'utilisateur. Les prévisions quotidiennes au-delà de 10 jours, y compris aujourd'hui, ne sont pas disponibles. Les données météo historiques ne sont pas disponibles.

Contraintes des paramètres :

  • Fuseaux horaires : toutes les entrées date et hour doivent être relatives au fuseau horaire local de l'établissement, et non à celui de l'utilisateur.
  • Format de la date : les entrées doivent être séparées en {year, month, day} nombres entiers.
  • Unités : la valeur par défaut est METRIC. Définissez units_system sur IMPERIAL pour les unités Fahrenheit/Miles si l'utilisateur sous-entend les normes américaines ou les demande explicitement.

  • La sortie ancrée doit être attribuée à la source à l'aide des informations du champ attribution, le cas échéant.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP lookup_weather.

Requête 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
}'

Schéma d'entrée

Demande pour la méthode LookupWeather : représente les conditions météorologiques à l'emplacement demandé.

LookupWeatherRequest

Représentation 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.
}
Champs
unitsSystem

enum (UnitsSystem)

Facultatif. Système d'unités à utiliser pour les conditions météorologiques renvoyées. Si aucune valeur n'est indiquée, les conditions météorologiques renvoyées seront exprimées dans le système métrique (par défaut, METRIC).
location

object (Location)

Obligatoire. Lieu pour lequel obtenir les conditions météorologiques.

Champ d'union _date.

_date ne peut être qu'un des éléments suivants :
date

object (Date)

Facultatif. Date des informations météo requises. Remarque : Cette date est relative au fuseau horaire local de l'établissement spécifié dans le champ "Établissement". La date doit se situer entre 24 heures dans le passé et les 10 jours à venir.

Champ d'union _hour.

_hour ne peut être qu'un des éléments suivants :
hour

integer

Facultatif. Heure des informations météo demandées, au format 24 heures (0 à 23). Cette valeur est relative au fuseau horaire local de l'établissement spécifié dans le champ "Emplacement". Les prévisions horaires au-delà de 120 heures ne sont pas disponibles. Les données météorologiques horaires historiques sont disponibles jusqu'à 24 heures en arrière.

Date

Représentation JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Champs
year

integer

Année de la date. Elle doit être comprise entre 1 et 9 999, ou égale à 0 si vous spécifiez une date sans année.
month

integer

Mois d'une année. Il doit être compris entre 1 et 12, ou égal à 0 si vous spécifiez une année sans mois ni jour.
day

integer

Jour du mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 si vous spécifiez une année seule, ou une année et un mois où le jour n'est pas significatif.

Emplacement

Représentation 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.
}
Champs
Champ d'union location_type. Différentes façons de représenter un lieu. location_type ne peut être qu'un des éléments suivants :
latLng

object (LatLng)

Point spécifié à l'aide de coordonnées géographiques.
placeId

string

ID de lieu associé à l'établissement .
address

string

Adresse lisible ou Plus Code. Pour en savoir plus, consultez https://plus.codes.

LatLng

Représentation JSON 
{
  "latitude": number,
  "longitude": number
}
Champs
latitude

number

Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0].
longitude

number

Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0].

UnitsSystem

Représente le système d'unités utilisé pour mesurer les valeurs.

Enums
UNITS_SYSTEM_UNSPECIFIED Le système d'unités n'est pas spécifié.
IMPERIAL Le système d'unités impériales (par exemple, Fahrenheit, miles, etc.).
METRIC Système d'unités métriques (par exemple, Celsius, kilomètres, etc.).

Schéma de sortie

Réponse au RPC LookupWeather. Elle représente les conditions météorologiques à l'emplacement demandé.

Cette réponse représente à la fois des informations horaires et quotidiennes. Elle est donc divisée en trois sections : "Heures", "Jours" et "Partagé". Les champs "Uniquement par heure" et "Uniquement par jour" sont marqués comme facultatifs. Pour les champs partagés entre les informations horaires et quotidiennes, certains sont toujours présents et ne sont donc pas marqués comme facultatifs, tandis que les autres sont marqués comme facultatifs, car ils ne sont pas toujours disponibles.

LookupWeatherResponse

Représentation 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.
}
Champs
weatherCondition

object (WeatherCondition)

Conditions météo
precipitation

object (Precipitation)

la probabilité de précipitations et la quantité de précipitations accumulées ;
wind

object (Wind)

Conditions de vent
returnedLocation

object (Location)

Obligatoire. Lieu pour lequel les informations météo sont renvoyées. Cet emplacement est identique à celui de la requête, mais peut être différent si l'emplacement demandé est une adresse en texte libre qui correspond à une position approximative (par exemple, "Mountain View, CA").
attribution

object (Attribution)

Attribution requise à afficher avec la météo.

Champ d'union _temperature.

_temperature ne peut être qu'un des éléments suivants :
temperature

object (Temperature)

Température horaire

Champ d'union _feels_like_temperature.

_feels_like_temperature ne peut être qu'un des éléments suivants :
feelsLikeTemperature

object (Temperature)

Mesure horaire de la température ressentie.

Champ d'union _heat_index.

_heat_index ne peut être qu'un des éléments suivants :
heatIndex

object (Temperature)

Température de l'indice de chaleur par heure.

Champ d'union _air_pressure.

_air_pressure ne peut être qu'un des éléments suivants :
airPressure

object (AirPressure)

Conditions de pression atmosphérique par heure.

Champ d'union _max_temperature.

_max_temperature ne peut être qu'un des éléments suivants :
maxTemperature

object (Temperature)

Température maximale (élevée) de la journée.

Champ d'union _min_temperature.

_min_temperature ne peut être qu'un des éléments suivants :
minTemperature

object (Temperature)

Température minimale (basse) de la journée.

Champ d'union _feels_like_max_temperature.

_feels_like_max_temperature ne peut être qu'un des éléments suivants :
feelsLikeMaxTemperature

object (Temperature)

Température ressentie maximale (élevée) de la journée.

Champ d'union _feels_like_min_temperature.

_feels_like_min_temperature ne peut être qu'un des éléments suivants :
feelsLikeMinTemperature

object (Temperature)

Température ressentie minimale (basse) de la journée.

Champ d'union _max_heat_index.

_max_heat_index ne peut être qu'un des éléments suivants :
maxHeatIndex

object (Temperature)

Température maximale de l'indice de chaleur au cours de la journée.

Champ d'union _sun_events.

_sun_events ne peut être qu'un des éléments suivants :
sunEvents

object (SunEvents)

Événements liés au soleil (par exemple, lever et coucher du soleil).

Champ d'union _moon_events.

_moon_events ne peut être qu'un des éléments suivants :
moonEvents

object (MoonEvents)

Événements liés à la Lune (par exemple, lever et coucher de Lune).

Champ d'union _relative_humidity.

_relative_humidity ne peut être qu'un des éléments suivants :
relativeHumidity

integer

Pourcentage d'humidité relative (valeurs de 0 à 100). Définissez cette valeur comme facultative, car elle n'est pas toujours disponible.

Champ d'union _uv_index.

_uv_index ne peut être qu'un des éléments suivants :
uvIndex

integer

Indice ultraviolet (UV) maximal. Définir comme facultatif, car il n'est pas toujours disponible

Champ d'union _thunderstorm_probability.

_thunderstorm_probability ne peut être qu'un des éléments suivants :
thunderstormProbability

integer

Probabilité d'orage (valeurs de 0 à 100). Définir comme facultatif, car elle n'est pas toujours disponible.

Champ d'union _cloud_cover.

_cloud_cover ne peut être qu'un des éléments suivants :
cloudCover

integer

Pourcentage du ciel couvert par les nuages (valeurs de 0 à 100). Définissez cette valeur comme facultative, car elle n'est pas toujours disponible.

Température

Représentation 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.
}
Champs
unit

enum (TemperatureUnit)

Code de l'unité utilisée pour mesurer la valeur de température.

Champ d'union _degrees.

_degrees ne peut être qu'un des éléments suivants :
degrees

number

Valeur de la température (en degrés) dans l'unité spécifiée.

AirPressure

Représentation 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.
}
Champs

Champ d'union _mean_sea_level_millibars.

_mean_sea_level_millibars ne peut être qu'un des éléments suivants :
meanSeaLevelMillibars

number

Pression atmosphérique moyenne au niveau de la mer, en millibars.

SunEvents

Représentation JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Champs
sunriseTime

string (Timestamp format)

Heure à laquelle le soleil se lève.

REMARQUE : Dans certains cas exceptionnels (par exemple, au nord du cercle arctique), il peut arriver qu'il n'y ait pas d'heure de lever du soleil pour une journée donnée. Dans ce cas, ce champ ne sera pas défini.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
sunsetTime

string (Timestamp format)

Heure à laquelle le soleil se couche.

REMARQUE : Dans certains cas particuliers (par exemple, au nord du cercle arctique), il peut arriver qu'il n'y ait pas d'heure de coucher du soleil pour une journée donnée. Dans ce cas, ce champ ne sera pas défini.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

Code temporel

Représentation JSON 
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. Doit être compris entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z et 9999-12-31T23:59:59Z).
nanos

integer

Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. Doit être compris entre 0 et 999 999 999 (inclus).

MoonEvents

Représentation JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Champs
moonriseTimes[]

string (Timestamp format)

Heure à laquelle le limbe supérieur de la Lune apparaît au-dessus de l'horizon (voir https://en.wikipedia.org/wiki/Moonrise_and_moonset).

REMARQUE : Dans la plupart des cas, il n'y a qu'une seule heure de lever de lune par jour. Dans d'autres cas, la liste peut être vide (par exemple, lorsque la lune se lève après minuit le lendemain). Toutefois, dans certains cas (par exemple, dans les régions polaires), la liste peut contenir plusieurs valeurs. Dans ce cas, les valeurs sont triées par ordre croissant.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
moonsetTimes[]

string (Timestamp format)

Heure à laquelle le limbe supérieur de la Lune disparaît sous l'horizon (voir https://en.wikipedia.org/wiki/Moonrise_and_moonset).

REMARQUE : Dans la plupart des cas, il n'y a qu'une seule heure de coucher de lune par jour. Dans d'autres cas, la liste peut être vide (par exemple, lorsque la lune se couche après minuit le lendemain). Toutefois, dans certains cas (par exemple, dans les régions polaires), la liste peut contenir plusieurs valeurs. Dans ce cas, les valeurs sont triées par ordre croissant.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

La phase lunaire

WeatherCondition

Représentation JSON 
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
Champs
iconBaseUri

string

URI de base de l'icône, sans l'extension du type de fichier. Pour afficher l'icône, ajoutez un thème si vous le souhaitez, ainsi que l'extension du type de fichier (.png ou .svg) à cet URI. Par défaut, l'icône est associée au thème clair, mais vous pouvez ajouter _dark pour le mode sombre. Par exemple, "https://maps.gstatic.com/weather/v1/dust.svg" ou "https://maps.gstatic.com/weather/v1/dust_dark.svg", où icon_base_uri est "https://maps.gstatic.com/weather/v1/dust".
description

object (LocalizedText)

Description textuelle de cette condition météorologique (localisée).
type

enum (Type)

Type de condition météorologique.

LocalizedText

Représentation JSON 
{
  "text": string,
  "languageCode": string
}
Champs
text

string

Chaîne localisée dans la langue correspondant à google.type.LocalizedText.language_code ci-dessous.
languageCode

string

Code de langue BCP-47 du texte ("en-US" ou "sr-Latn", par exemple).

Pour en savoir plus, consultez la page http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

Précipitations

Représentation JSON 
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Champs
probability

object (PrecipitationProbability)

Probabilité de précipitations (valeurs de 0 à 100).
snowQpf

object (QuantitativePrecipitationForecast)

Quantité de neige accumulée sur une période donnée, mesurée en équivalent eau liquide. Remarque : QPF est l'abréviation de "Quantitative Precipitation Forecast" (prévisions quantitatives des précipitations). Pour en savoir plus, veuillez consulter la définition de QuantitativePrecipitationForecast.
qpf

object (QuantitativePrecipitationForecast)

Quantité de précipitations (pluie) accumulée sur une période donnée, mesurée en équivalent eau liquide. Remarque : QPF est l'abréviation de "Quantitative Precipitation Forecast" (prévisions quantitatives des précipitations). Pour en savoir plus, veuillez consulter la définition de QuantitativePrecipitationForecast.

PrecipitationProbability

Représentation 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.
}
Champs
type

enum (PrecipitationType)

Code indiquant le type de précipitations.

Champ d'union _percent.

_percent ne peut être qu'un des éléments suivants :
percent

integer

Pourcentage compris entre 0 et 100 indiquant le risque de précipitations.

QuantitativePrecipitationForecast

Représentation 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.
}
Champs
unit

enum (Unit)

Code de l'unité utilisée pour mesurer la quantité de précipitations accumulées.

Champ d'union _quantity.

_quantity ne peut être qu'un des éléments suivants :
quantity

number

Quantité de précipitations, mesurée en équivalent eau liquide, qui s'est accumulée au cours d'une période donnée.

Vent

Représentation JSON 
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
Champs
direction

object (WindDirection)

Direction du vent, angle d'où il provient.
speed

object (WindSpeed)

Vitesse du vent.
gust

object (WindSpeed)

Rafale de vent (augmentation soudaine de la vitesse du vent)

WindDirection

Représentation 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.
}
Champs
cardinal

enum (CardinalDirection)

Code représentant la direction cardinale d'où souffle le vent.

Champ d'union _degrees.

_degrees ne peut être qu'un des éléments suivants :
degrees

integer

Direction du vent en degrés (valeurs comprises entre 0 et 360).

WindSpeed

Représentation 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.
}
Champs
unit

enum (SpeedUnit)

Code représentant l'unité utilisée pour mesurer la vitesse du vent.

Champ d'union _value.

_value ne peut être qu'un des éléments suivants :
value

number

Valeur de la vitesse du vent.

Emplacement

Représentation 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.
}
Champs
Champ d'union location_type. Différentes façons de représenter un lieu. location_type ne peut être qu'un des éléments suivants :
latLng

object (LatLng)

Point spécifié à l'aide de coordonnées géographiques.
placeId

string

ID de lieu associé à l'établissement .
address

string

Adresse lisible ou Plus Code. Pour en savoir plus, consultez https://plus.codes.

LatLng

Représentation JSON 
{
  "latitude": number,
  "longitude": number
}
Champs
latitude

number

Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0].
longitude

number

Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0].

Attribution

Représentation JSON 
{
  "title": string,
  "url": string
}
Champs
title

string

Titre à afficher pour l'attribution.
url

string

URL à associer pour l'attribution.

TemperatureUnit

Représente une unité utilisée pour mesurer les températures.

Enums
TEMPERATURE_UNIT_UNSPECIFIED L'unité de température n'est pas spécifiée.
CELSIUS La température est mesurée en degrés Celsius.
FAHRENHEIT La température est mesurée en degrés Fahrenheit.

MoonPhase

Indique la phase lunaire.

Enums
MOON_PHASE_UNSPECIFIED Phase lunaire non spécifiée.
NEW_MOON La lune n'est pas éclairée par le soleil.
WAXING_CRESCENT La lune est éclairée à 0 % à 50% sur son côté droit dans l'hémisphère nord 🌒 et sur son côté gauche dans l'hémisphère sud 🌘.
FIRST_QUARTER La lune est éclairée à 50,1% sur son côté droit dans l'hémisphère nord 🌓 et sur son côté gauche dans l'hémisphère sud 🌗.
WAXING_GIBBOUS La lune est éclairée à 50 % à 100% sur son côté droit dans l'hémisphère nord 🌔 et sur son côté gauche dans l'hémisphère sud 🌖.
FULL_MOON La lune est entièrement éclairée.
WANING_GIBBOUS La lune est éclairée à 50 % à 100% sur son côté gauche dans l'hémisphère nord 🌖 et sur son côté droit dans l'hémisphère sud 🌔.
LAST_QUARTER La lune est éclairée à 50,1% sur sa gauche dans l'hémisphère nord 🌗 et sur sa droite dans l'hémisphère sud 🌓.
WANING_CRESCENT La lune est éclairée à 0 % à 50% sur son côté gauche dans l'hémisphère nord 🌘 et sur son côté droit dans l'hémisphère sud 🌒.

Type

Marque le type de conditions météorologiques dans le contexte d'un élément de prévision.

Enums
TYPE_UNSPECIFIED Les conditions météo ne sont pas spécifiées.
CLEAR Pas de nuages.
MOSTLY_CLEAR Nuages passagers.
PARTLY_CLOUDY Partiellement nuageux (quelques nuages).
MOSTLY_CLOUDY Nuageux dans l'ensemble (plus de nuages que de soleil).
CLOUDY Nuageux (tous les nuages, pas de soleil).
WINDY Vent fort.
WIND_AND_RAIN Vent fort avec précipitations.
LIGHT_RAIN_SHOWERS Faibles chutes de pluie intermittentes.
CHANCE_OF_SHOWERS Risque de pluie intermittente.
SCATTERED_SHOWERS Chutes de pluie intermittentes.
RAIN_SHOWERS Les averses sont considérées comme des précipitations de plus courte durée que la pluie. Elles se caractérisent par des heures de début et de fin soudaines, et par des changements d'intensité rapides.
HEAVY_RAIN_SHOWERS Averses intenses.
LIGHT_TO_MODERATE_RAIN Pluie (faible à modérée)
MODERATE_TO_HEAVY_RAIN Pluie (modérée à forte)
RAIN Pluie modérée.
LIGHT_RAIN Faible pluie.
HEAVY_RAIN Pluie forte.
RAIN_PERIODICALLY_HEAVY Pluie, parfois forte.
LIGHT_SNOW_SHOWERS Faibles chutes de neige intermittentes
CHANCE_OF_SNOW_SHOWERS Risque d'averses de neige.
SCATTERED_SNOW_SHOWERS Neige qui tombe à des intensités variables pendant de courtes périodes.
SNOW_SHOWERS Averses de neige.
HEAVY_SNOW_SHOWERS Fortes averses de neige.
LIGHT_TO_MODERATE_SNOW Chutes de neige faibles à modérées.
MODERATE_TO_HEAVY_SNOW Neige modérée à forte.
SNOW Neige modérée.
LIGHT_SNOW Faibles chutes de neige.
HEAVY_SNOW Neige abondante.
SNOWSTORM Neige avec risque de tonnerre et d'éclairs
SNOW_PERIODICALLY_HEAVY Neige, parfois forte.
HEAVY_SNOW_STORM Neige abondante avec risque d'orages et d'éclairs.
BLOWING_SNOW Neige avec vent violent.
RAIN_AND_SNOW Mélange de pluie et de neige.
HAIL Commander.
HAIL_SHOWERS Grêle qui tombe à des intensités variables pendant de brèves périodes.
THUNDERSTORM Orage.
THUNDERSHOWER Une averse accompagnée de tonnerre et d'éclairs.
LIGHT_THUNDERSTORM_RAIN Légère pluie orageuse.
SCATTERED_THUNDERSTORMS Orages avec pluie d'intensité variable pendant de courtes périodes.
HEAVY_THUNDERSTORM Orage violent.

PrecipitationType

Représente le type de précipitations à un endroit donné.

Enums
PRECIPITATION_TYPE_UNSPECIFIED Type de précipitation non spécifié.
NONE Pas de précipitations.
SNOW Précipitations de neige.
RAIN Précipitations de pluie.
LIGHT_RAIN Précipitations de pluie légère.
HEAVY_RAIN Fortes précipitations
RAIN_AND_SNOW Précipitations de pluie et de neige.
SLEET Précipitations de grésil.
FREEZING_RAIN Précipitations de pluie verglaçante.

Unité

Représente l'unité utilisée pour mesurer la quantité de précipitations accumulées.

Enums
UNIT_UNSPECIFIED Unité de précipitations non spécifiée.
MILLIMETERS La quantité de précipitations est mesurée en millimètres.
INCHES La quantité de précipitations est mesurée en millimètres.

CardinalDirection

Représente une direction cardinale (y compris les directions ordinales).

Enums
CARDINAL_DIRECTION_UNSPECIFIED La direction cardinale n'est pas spécifiée.
NORTH Point cardinal nord.
NORTH_NORTHEAST Direction secondaire intercardinale nord-nord-est.
NORTHEAST Direction intercardinale nord-est.
EAST_NORTHEAST Direction intercardinale secondaire est-nord-est.
EAST Point cardinal est.
EAST_SOUTHEAST Direction intercardinale secondaire est-sud-est.
SOUTHEAST Direction intercardinale sud-est.
SOUTH_SOUTHEAST Direction secondaire intercardinale sud-sud-est.
SOUTH Direction cardinale sud.
SOUTH_SOUTHWEST Direction secondaire sud-sud-ouest.
SOUTHWEST Direction intercardinale sud-ouest.
WEST_SOUTHWEST Direction intercardinale secondaire ouest-sud-ouest.
WEST Point cardinal ouest.
WEST_NORTHWEST Direction secondaire intercardinale ouest-nord-ouest.
NORTHWEST Direction intercardinale nord-ouest.
NORTH_NORTHWEST Direction intercardinale secondaire nord-nord-ouest.

SpeedUnit

Représente l'unité utilisée pour mesurer la vitesse.

Enums
SPEED_UNIT_UNSPECIFIED L'unité de vitesse n'est pas spécifiée.
KILOMETERS_PER_HOUR La vitesse est exprimée en kilomètres par heure.
MILES_PER_HOUR La vitesse est mesurée en miles par heure.

Annotations d'outils

Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients traitent ces indices comme non fiables, mais ils peuvent être utilisés pour déterminer quand un message de confirmation peut être envoyé à un utilisateur.

En plus de la chaîne de titre, les indications booléennes suivantes sont définies comme suit :

  • readOnlyHint : si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".
  • destructiveHint : si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions d'ajout. Valeur par défaut : "true".
  • idempotentHint : si la valeur est "true", appeler l'outil à plusieurs reprises avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".
  • openWorldHint : si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

Indication destructive : ❌ | Indication idempotente : ❌ | Indication en lecture seule : ✅ | Indication Open World : ❌