MCP Tools Reference: mapstools.googleapis.com

Outil : lookup_weather

Récupère des données météo complètes, y compris les conditions actuelles, ainsi que 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é, couverture nuageuse, probabilité d'orage) et adresse géocodée.

Location & Location Rules (CRITICAL):

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 de latitude/longitude exactes.
    • 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).
    • Le place_id peut être récupéré à l'aide de l'outil search_places.
    • Exemple : {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Tour Eiffel
  3. Chaîne d'adresse (address)

    • Chaîne au format libre qui nécessite une spécificité 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 d'un nom de 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 : indiquez 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 termes tels que "dans les prochaines heures" ou "plus tard aujourd'hui". Si l'utilisateur spécifie une minute, arrondissez à l'heure la plus proche. Les prévisions horaires au-delà de 120 heures à partir de maintenant ne sont pas prises en charge. Les données météorologiques horaires passées sont disponibles jusqu'à 24 heures en arrière.

  • Prévisions quotidiennes : fournissez location et date. Ne spécifiez pas hour. Utilisez-le pour les requêtes générales sur un jour (par exemple, "météo de demain", "météo de vendredi", "météo du 25/12"). Si la date du jour n'est pas dans le contexte, vous devez la clarifier avec l'utilisateur. Les prévisions quotidiennes au-delà de 10 jours, y compris aujourd'hui, ne sont pas prises en charge. Les données météorologiques historiques ne sont pas disponibles.

Contraintes de paramètre :

  • Fuseaux horaires : toutes les entrées date et hour doivent être exprimées dans le fuseau horaire local de l'établissement, et non dans celui de l'utilisateur.
  • Format de date : les entrées doivent être séparées en {year, month, day} entiers.
  • Unités : la valeur par défaut est METRIC. Définissez units_system sur IMPERIAL pour les degrés Fahrenheit/miles si l'utilisateur implique 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, lorsqu'elles sont disponibles.

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

Requête pour la méthode LookupWeather, qui 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 (valeur 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éorologiques requises. Remarque : Cette date est relative au fuseau horaire local de l'emplacement spécifié dans le champ "location". La date doit être comprise entre les dernières 24 heures et les 10 prochains jours.

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 du lieu spécifié dans le champ "location". Les prévisions horaires au-delà de 120 heures à partir de maintenant ne sont pas prises en charge. Les données météorologiques horaires passées 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 Le système d'unités métriques (par exemple, Celsius, kilomètres, etc.).

Schéma de sortie

Réponse pour le RPC LookupWeather : 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 : Hourly, Daily et Shared. Les champs "Only-Hourly" et "Only-Daily" sont marqués comme facultatifs. Certains champs partagés entre les informations horaires et quotidiennes sont toujours présents. Ils 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)

La condition météo

precipitation

object (Precipitation)

La probabilité de précipitations et la quantité de précipitations accumulées

wind

object (Wind)

Les conditions de vent

returnedLocation

object (Location)

Obligatoire. Lieu pour lequel les informations météorologiques 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)

La température heure par heure

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

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) tout au long 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) tout au long 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) tout au long 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 tout au long 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 la 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éfini comme facultatif, car il 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éfinissez-le 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

La probabilité d'orage (valeurs de 0 à 100). Définissez-la comme facultative, 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 des nuages (valeurs de 0 à 100). Définissez-le comme facultatif, car il 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 particuliers (par exemple, au nord du cercle polaire), il se peut qu'il n'y ait pas d'heure de lever du soleil pour un jour donné. 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 exceptionnels (par exemple, au nord du cercle polaire), il peut ne pas y avoir d'heure de coucher du soleil pour un jour donné. 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 à la période allant du 01/01/0001 à 00:00:00 UTC au 31/12/9999 à 23:59:59 UTC).

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. La valeur doit être comprise 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 aura qu'une seule heure de lever de la 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 aura qu'une seule heure de coucher de la 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 et l'extension du type de fichier (.png ou .svg) à cet URI. Par défaut, l'icône est en 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, tel que "en-US" ou "sr-Latn".

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, mesurée en équivalent en eau liquide, qui s'est accumulée sur une période donnée. Remarque : "QPF" est l'abréviation de "Quantitative Precipitation Forecast" (prévision quantitative des précipitations). Pour en savoir plus, consultez la définition de QuantitativePrecipitationForecast.

qpf

object (QuantitativePrecipitationForecast)

Quantité de précipitations (pluie), mesurée en équivalent d'eau liquide, qui s'est accumulée sur une période donnée. Remarque : "QPF" est l'abréviation de "Quantitative Precipitation Forecast" (prévision quantitative des précipitations). Pour en savoir plus, consultez 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 de 0 à 100 indiquant les risques 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 cumulé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 d'eau liquide, qui s'est accumulée sur une période donnée.

Vent

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

object (WindDirection)

La direction du vent, l'angle d'où il vient.

speed

object (WindSpeed)

La vitesse du vent.

gust

object (WindSpeed)

La 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 le point cardinal 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 vers laquelle rediriger 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 Fahrenheit.

MoonPhase

Marque 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 de 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 son côté gauche dans l'hémisphère nord 🌗 et sur son côté droit dans l'hémisphère sud 🌓.
WANING_CRESCENT La Lune est éclairée de 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 condition météorologique dans le contexte d'un élément de prévision.

Enums
TYPE_UNSPECIFIED Les conditions météorologiques ne sont pas spécifiées.
CLEAR Aucun cloud.
MOSTLY_CLEAR Nuages passagers.
PARTLY_CLOUDY Partiellement nuageux (quelques nuages).
MOSTLY_CLOUDY Nuageux dans l'ensemble (plus de nuages que de soleil).
CLOUDY Nuageux (que des 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, et se caractérisent par leur soudaineté en termes d'heures de début et de fin, et par des changements rapides d'intensité.
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 Fortes pluies.
RAIN_PERIODICALLY_HEAVY Pluie, parfois forte.
LIGHT_SNOW_SHOWERS Neige légère tombant à des intensités variables pendant de courtes périodes.
CHANCE_OF_SNOW_SHOWERS Risque d'averses de neige.
SCATTERED_SNOW_SHOWERS Neige tombant à 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 Chutes de neige modérées à fortes.
SNOW Neige modérée.
LIGHT_SNOW Faibles chutes de neige.
HEAVY_SNOW Fortes chutes de neige.
SNOWSTORM Neige avec risque de tonnerre et d'éclairs.
SNOW_PERIODICALLY_HEAVY Neige, parfois forte.
HEAVY_SNOW_STORM Fortes chutes de neige avec risque de tonnerre et d'éclairs.
BLOWING_SNOW Neige avec vent violent.
RAIN_AND_SNOW Pluie et neige mêlées.
HAIL Grêle.
HAIL_SHOWERS Grêle tombant à des intensités variables pendant de courtes périodes.
THUNDERSTORM Orage.
THUNDERSHOWER Averse de pluie accompagnée de tonnerre et d'éclairs.
LIGHT_THUNDERSTORM_RAIN Légère pluie orageuse.
SCATTERED_THUNDERSTORMS Orages accompagnés de pluie d'intensité variable pendant de courtes périodes.
HEAVY_THUNDERSTORM Orage violent.

PrecipitationType

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

Enums
PRECIPITATION_TYPE_UNSPECIFIED Type de précipitations non spécifié.
NONE Pas de précipitations.
SNOW Précipitations neigeuses.
RAIN Précipitations de pluie.
LIGHT_RAIN Faibles précipitations de pluie.
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 mesure des 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 pouces.

CardinalDirection

Représente un point cardinal (y compris les points ordinaux).

Enums
CARDINAL_DIRECTION_UNSPECIFIED La direction cardinale n'est pas spécifiée.
NORTH La direction cardinale nord.
NORTH_NORTHEAST Direction intercardinale secondaire 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 intercardinale secondaire sud-sud-est.
SOUTH La direction cardinale sud.
SOUTH_SOUTHWEST Direction intercardinale secondaire sud-sud-ouest.
SOUTHWEST Direction intercardinale sud-ouest.
WEST_SOUTHWEST Direction intercardinale secondaire ouest-sud-ouest.
WEST Point cardinal ouest.
WEST_NORTHWEST Direction intercardinale secondaire 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 mesuré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 considèrent ces indications comme non fiables, mais elles peuvent être utilisées pour décider quand envoyer une invite de confirmation à un utilisateur.

En plus de la chaîne de titre, les indices booléens suivants sont définis 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", l'appel répété de l'outil 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 sur le Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

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