MCP Tools Reference: mapstools.googleapis.com

Outil : lookup_weather

Récupère des informations environnementales complètes pour un lieu, y compris la météo, la qualité de l'air (IQA et polluants) et le pollen (niveaux d'allergènes des arbres, des graminées, des mauvaises herbes et des espèces végétales) : conditions actuelles, prévisions/historique horaires et prévisions quotidiennes pour la météo et la qualité de l'air. Le pollen n'est disponible que pour les prévisions quotidiennes (aujourd'hui à +4 jours, pas de données horaires ni passées). Domaines et fonctionnalités d'environnement disponibles (capabilities : WEATHER, AIR_QUALITY, POLLEN – CRITIQUE) : * Sélection explicite obligatoire : vous DEVEZ inclure au moins l'un des éléments WEATHER, AIR_QUALITY ou POLLEN dans capabilities pour chaque appel. L'omission de capabilities n'est PAS autorisée. * Requêtes générales/ambiguës sur l'extérieur (suite complète d'informations sur l'environnement extérieur) : si l'utilisateur pose une question générale sur l'extérieur, les voyages ou la situation sans se limiter à un domaine spécifique (par exemple, "Quelles sont les conditions extérieures actuelles pour courir ?"), incluez explicitement les trois fonctionnalités (capabilities: ["WEATHER", "AIR_QUALITY", "POLLEN"]) pour renvoyer la suite complète d'informations sur l'environnement extérieur (météo + qualité de l'air + pollen). Pour une date passée (date/hour), omettez POLLEN, qui n'a pas d'historique. * Sélection de domaines ciblés (requêtes spécifiques) : si l'utilisateur demande spécifiquement un ou deux domaines (par exemple, "Quel est l'IQA à Seattle en ce moment ?"), n'incluez que les fonctionnalités demandées (WEATHER, AIR_QUALITY et/ou POLLEN). Seuls les domaines demandés seront exécutés et renvoyés. Données spécifiques disponibles par domaine : * Météo (weather) : température (actuelle, ressentie, max/min, 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) et conditions atmosphériques (indice UV, humidité, couverture nuageuse, probabilité d'orage, pression atmosphérique). * Qualité de l'air (air_quality) : indices de la qualité de l'air (IQA) universels et locaux (valeur, catégorie et polluant dominant de l'IQA), recommandations de santé pour sept groupes de sensibilité et concentrations de polluants (include_pollutant_concentration: true). Chaque indice a son propre polluant dominant. Indiquez-le par indice (par exemple, ne donnez pas le polluant de l'IQA universel pour l'IQA américain). * Pollen (pollen) : indice UPI (Universal Pollen Index, 0-5) quotidien par catégorie (arbres, graminées et herbes) et par espèce végétale (index.value avec son index.category, par exemple 1 = "Très faible"), statut de saison, réactions croisées et recommandations de santé. * Champs de pollen manquants : un in_season manquant signifie que ce n'est pas la saison. Ignorez les espèces de plantes renvoyées sans index, sauf si l'utilisateur pose une question sur cette plante. Dans ce cas, indiquez qu'aucune donnée sur le pollen n'est disponible pour elle aujourd'hui (ne déduisez pas de niveau). Règles de localisation (CRITIQUE) : la zone géographique ciblée DOIT être spécifiée dans location à l'aide d'UN SEUL des sous-champs oneof suivants : 1. Coordonnées géographiques (lat_lng) : à utiliser lorsque les coordonnées exactes de latitude/longitude sont connues. * Exemple : {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} 2. ID de lieu (place_id) : * ID de lieu Google Maps non ambigu (par exemple, obtenu à partir de search_places ou resolve_names). * Exemple : {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} 3. Chaîne d'adresse (address) : * Ville/région, quartier, point de repère ou d'intérêt, adresse postale ou code postal, idéalement avec la ville/le pays. * Exemple : {"location": {"address": "Paris, France"}} Modes d'heure et d'utilisation (date et hour – CRITIQUE) : * Référence de fuseau horaire local : toutes les entrées date ({year, month, day}) et hour (0-23) DOIVENT être exprimées dans le fuseau horaire civil local de la location demandée (par exemple, une requête pour "Paris tomorrow at 13:00" utilise la date et l'heure locales de Europe/Paris 13), jamais l'heure UTC ni le fuseau horaire de l'appelant. * 1. Conditions actuelles (date omis ET hour omis) : * Indiquez location et la cible capabilities (WEATHER, AIR_QUALITY, POLLEN). Ne spécifiez PAS date ni hour. * Renvoie les conditions actuelles en temps réel (CC) pour les domaines demandés (météo actuelle, qualité de l'air pour l'heure actuelle et/ou prévisions de pollen pour aujourd'hui). * Pour la qualité de l'air, les conditions actuelles correspondent à une heure unique : ne les utilisez PAS seules pour répondre à des questions sur la qualité de l'air ou sur les conditions extérieures générales pour aujourd'hui (utilisez les requêtes quotidiennes ci-dessous). * 2. Prévisions/Historique par heure (date spécifié ET hour spécifié 0-23) : * Indiquez location, date ({year, month, day}), hour (0-23) et la cible capabilities. Si des minutes sont mentionnées, arrondissez à l'heure inférieure la plus proche. * CONTRAINTE CRITIQUE (date est REQUIS lorsque hour est défini) : fournir hour sans date (date omis, hour défini) n'est PAS autorisé et échouera avec une erreur. Même lorsque l'utilisateur demande une heure spécifique aujourd'hui (par exemple, "at 13:00 today"), vous DEVEZ renseigner à la fois date (la date du jour à location) et hour. * Exécute une recherche horaire pour les données météo et/ou de qualité de l'air demandées à YYYY-MM-DD-HH et une recherche quotidienne pour les données sur le pollen demandées à YYYY-MM-DD. * Questions sur la météo commençant par "quand" : pour les questions sur la météo demandant quand/à quelle heure/le meilleur moment (par exemple, "what time will it stop raining?"), utilisez les appels WEATHER horaires (date + hour) pour les heures concernées. Les prévisions météo quotidiennes ne comportent pas de valeurs horaires. Pour les questions générales sur l'extérieur "quand/meilleur moment" (par exemple, "when is the best time to go walking today?"), effectuez ces appels WEATHER toutes les heures en plus de l'appel sur une journée complète pour la qualité de l'air (et le pollen) décrit dans "Requêtes quotidiennes". * 3. Requêtes quotidiennes (date spécifié ET hour omis) : * Indiquez location, date ({year, month, day} dans l'heure civile locale de l'location demandé) sans hour, et l'capabilities cible pour les requêtes sur une journée complète (par exemple, "weather and pollen in London tomorrow"). * Questions sur la qualité de l'air et questions générales sur l'extérieur pour aujourd'hui : pour les questions sur la qualité de l'air et les questions générales sur l'extérieur (qui incluent la qualité de l'air) pour aujourd'hui (par exemple, "how will the air quality change today", "is today a good day for a picnic?"), définissez date sur la date d'aujourd'hui à location (heure omise) pour obtenir la série horaire de la qualité de l'air pour la journée. Un appel "Current Conditions" (Conditions actuelles) seul ne renvoie que l'heure actuelle de la qualité de l'air et ne suffit pas. Vous pouvez en ajouter un si l'utilisateur demande également des informations sur "maintenant". * Périodes de qualité de l'air : pour une question sur la qualité de l'air concernant une période d'une journée (par exemple, "air quality between noon and 6 PM"), privilégiez un appel quotidien pour cette date et lisez les heures de la période à partir de la série sur la qualité de l'air, plutôt que d'échantillonner des heures individuelles. Si vous utilisez des appels horaires, couvrez chaque heure de la période. * Renvoie les prévisions quotidiennes pour les données météo et/ou sur le pollen demandées, ainsi que les séries horaires de qualité de l'air pour la journée complète (de 00h00 à 23h00, heure locale) : 24 heures d'historique pour une date passée, 24 heures de prévisions pour une date future, et pour aujourd'hui, les heures précédentes (historique), l'heure actuelle et les heures restantes (prévisions). Horizons temporels acceptés par domaine : * Météo : toutes les heures, de 24 heures auparavant à 240 heures (10 jours) à l'avance (les heures passées nécessitent à la fois date et hour) ; tous les jours jusqu'à 10 jours, y compris aujourd'hui (aujourd'hui à +9 jours) ; pas d'historique quotidien. * Qualité de l'air : toutes les heures, de 720 heures (30 jours) dans le passé à 96 heures (4 jours) dans le futur. Un appel d'une journée complète doit s'inscrire dans cette période (en pratique, de -29 jours à +3 jours). * Pollen : quotidien uniquement, d'aujourd'hui à +4 jours (5 jours, aujourd'hui compris) ; aucune date passée, et hour est ignoré. * (Remarque : Si plusieurs fonctionnalités sont demandées et que date/hour se trouve en dehors de l'une de leurs plages, l'appel aboutit quand même et ne renvoie que les fonctionnalités compatibles.) * Requêtes hors plage : si une date ou une heure demandée peut se situer en dehors de la plage acceptée d'un domaine ci-dessus (par exemple, le pollen pour une date passée), appelez quand même lookup_weather pour la date/heure demandée. L'erreur indique la plage acceptée. Ne remplacez pas la date, l'heure ou le domaine par d'autres valeurs. Options de domaine et attribution : * Langue (language_code) : code de langue BCP-47 facultatif (par exemple, "fr"). La valeur par défaut est "en". * Unités météo (weather_options.units_system ou units_system) : par défaut, METRIC. Définissez cette option sur IMPERIAL (Fahrenheit/mph) si l'utilisateur implique les normes américaines ou demande explicitement des unités impériales. Compatible avec weather_options.units_system (recommandé) et units_system de premier niveau. Si les deux sont spécifiés, ils ne doivent pas être en conflit. * Options de qualité de l'air (air_quality_options) : définissez include_pollutant_concentration: true lorsque des concentrations de polluants spécifiques (PM2, 5, PM10, O3, NO2, SO2, CO) sont nécessaires. Vous pouvez également définir index_region_code (code pays ISO à deux lettres, par exemple "US") pour demander une échelle d'IQA régionale spécifique. Par défaut, la réponse inclut l'IQA universel et l'IQA régional de l'emplacement. * Attribution : la sortie ancrée DOIT être attribuée à la source à l'aide du champ attribution dans chaque conteneur de domaine renvoyé (weather.attribution, air_quality.attribution, pollen.attribution). * Heures renvoyées : les valeurs date_time de la qualité de l'air sont déjà exprimées dans l'heure locale du lieu (utc_offset inclus). Présentez-les telles quelles. Les valeurs date_time de la météo (actuelle et horaire) et les heures de lever/coucher du soleil sont exprimées en UTC. Convertissez-les dans l'heure locale du lieu à l'aide de time_zone. Indiquez que toutes les heures sont locales.

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)
  },
  "capabilities": [
    enum (Capability)
  ],

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

  // Union field _language_code can be only one of the following:
  "languageCode": string
  // End of list of possible types for union field _language_code.

  // Union field _weather_options can be only one of the following:
  "weatherOptions": {
    object (WeatherOptions)
  }
  // End of list of possible types for union field _weather_options.

  // Union field _air_quality_options can be only one of the following:
  "airQualityOptions": {
    object (AirQualityOptions)
  }
  // End of list of possible types for union field _air_quality_options.
}
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.
capabilities[]

enum (Capability)

Facultatif. Fonctionnalités environnementales à inclure dans la réponse.

Champ d'union _date.

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

object (Date)

Facultatif. Spécifie la date des informations environnementales demandées, par rapport au fuseau horaire local de l'emplacement spécifié dans le champ location. Les plages de dates acceptées dépendent des fonctionnalités demandées : - WEATHER : jusqu'à 24 heures dans le passé (lorsque hour est également défini) et jusqu'à 10 jours (240 heures) dans le futur (aujourd'hui à +9 jours pour les prévisions quotidiennes). - AIR_QUALITY : jusqu'à 30 jours (720 heures) dans le passé et jusqu'à 4 jours (96 heures) dans le futur. - POLLEN : d'aujourd'hui à +4 jours (jusqu'à 5 jours, y compris aujourd'hui ; les dates historiques ne sont pas acceptées).

Champ d'union _hour.

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

integer

Facultatif. Spécifie l'heure des informations environnementales demandées, au format 24 heures (0-23), par rapport au fuseau horaire local du lieu spécifié dans le champ location. Nécessite la spécification de date. Les plages horaires acceptées dépendent des fonctionnalités demandées : - WEATHER : jusqu'à 24 heures dans le passé et jusqu'à 240 heures (10 jours) dans le futur. - AIR_QUALITY : jusqu'à 30 jours (720 heures) dans le passé et jusqu'à 4 jours (96 heures) dans le futur. - POLLEN : renvoie uniquement les prévisions quotidiennes. hour est ignoré pour le pollen.

Champ d'union _language_code.

_language_code ne peut être qu'un des éléments suivants :
languageCode

string

Facultatif. Code de langue BCP-47 pour le texte localisé dans la réponse (par exemple, "en", "ja", "fr-CA"). La valeur par défaut est "en" si aucune valeur n'est spécifiée.

Champ d'union _weather_options.

_weather_options ne peut être qu'un des éléments suivants :
weatherOptions

object (WeatherOptions)

Facultatif. Options spécifiques aux requêtes météo. weather_options.units_system est compatible avec units_system de premier niveau (balise 4) pour préserver la rétrocompatibilité avec les appelants existants. Renvoie INVALID_ARGUMENT si les deux spécifient des systèmes d'unités en conflit. Ignoré si WEATHER n'est pas demandé dans capabilities.

Champ d'union _air_quality_options.

_air_quality_options ne peut être qu'un des éléments suivants :
airQualityOptions

object (AirQualityOptions)

Facultatif. Options spécifiques aux requêtes sur la qualité de l'air. Ignoré si AIR_QUALITY n'est pas demandé dans capabilities.

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 manières 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 par l'humain (par exemple, adresse postale, ville ou code postal).

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

WeatherOptions

Représentation JSON 
{
  "unitsSystem": enum (UnitsSystem)
}
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).

AirQualityOptions

Représentation JSON 
{

  // Union field _include_pollutant_concentration can be only one of the
  // following:
  "includePollutantConcentration": boolean
  // End of list of possible types for union field
  // _include_pollutant_concentration.

  // Union field _index_region_code can be only one of the following:
  "indexRegionCode": string
  // End of list of possible types for union field _index_region_code.
}
Champs

Champ d'union _include_pollutant_concentration.

_include_pollutant_concentration ne peut être qu'un des éléments suivants :
includePollutantConcentration

boolean

Facultatif. Si la valeur est "true", inclut les concentrations détaillées de polluants et des informations supplémentaires (sources et effets) dans la réponse sur la qualité de l'air.

Champ d'union _index_region_code.

_index_region_code ne peut être qu'un des éléments suivants :
indexRegionCode

string

Facultatif. Code pays/région ISO 3166-1 alpha-2 à deux lettres (par exemple, "US", "FR", "CN") utilisé pour sélectionner l'échelle de l'indice de la qualité de l'air (IQA) local préféré, en plus de l'IQA universel (IQAU). Si ce champ n'est pas spécifié, la valeur par défaut est définie sur la région de l'emplacement demandé.

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

Capacité

Fonctionnalités environnementales pouvant être demandées dans LookupWeatherRequest.

Enums
CAPABILITY_UNSPECIFIED Capacité non spécifiée.
WEATHER Conditions météorologiques (température, précipitations, vent, UV, etc.)
AIR_QUALITY Informations sur la qualité de l'air (IQA, polluants et recommandations de santé)
POLLEN Informations sur les pollens (niveaux d'allergènes des pollens d'arbres, de graminées, d'herbacées et d'espèces végétales).

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.

  // Union field _weather can be only one of the following:
  "weather": {
    object (WeatherResultData)
  }
  // End of list of possible types for union field _weather.

  // Union field _air_quality can be only one of the following:
  "airQuality": {
    object (AirQualityResultData)
  }
  // End of list of possible types for union field _air_quality.

  // Union field _pollen can be only one of the following:
  "pollen": {
    object (PollenResultData)
  }
  // End of list of possible types for union field _pollen.

  // Union field _time_zone can be only one of the following:
  "timeZone": string
  // End of list of possible types for union field _time_zone.
}
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 à un emplacement approximatif (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 lune).

Champ d'union _relative_humidity.

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

integer

Pourcentage d'humidité relative (valeurs comprises entre 0 et 100).

Champ d'union _uv_index.

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

integer

Indice ultraviolet (UV) maximal.

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

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

Champ d'union _weather.

_weather ne peut être qu'un des éléments suivants :
weather

object (WeatherResultData)

Conditions météorologiques à l'emplacement demandé.

Champ d'union _air_quality.

_air_quality ne peut être qu'un des éléments suivants :
airQuality

object (AirQualityResultData)

Informations sur la qualité de l'air à l'emplacement demandé.

Champ d'union _pollen.

_pollen ne peut être qu'un des éléments suivants :
pollen

object (PollenResultData)

Informations sur le pollen à l'emplacement demandé.

Champ d'union _time_zone.

_time_zone ne peut être qu'un des éléments suivants :
timeZone

string

Chaîne de fuseau horaire IANA résolue pour l'emplacement (par exemple, "America/New_York", "Asia/Tokyo").

Température

Représentation JSON 
{
  "unit": enum (Unit),

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

Facultatif. 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 uniques (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 uniques (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 à 0001-01-01T00:00:00Z à 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. La valeur doit être comprise entre 0 et 999 999 999 (inclus).

MoonEvents

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

enum (Phase)

Facultatif. La phase lunaire.
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 jour suivant). 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 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".

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 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 (Type),

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

Facultatif. 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 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 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 (Cardinal),

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

Facultatif. 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 de 0 à 360).

WindSpeed

Représentation JSON 
{
  "unit": enum (Unit),

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

Facultatif. 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 manières 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 par l'humain (par exemple, adresse postale, ville ou code postal).

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 l'utilisateur pour l'attribution.

WeatherResultData

Représentation JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _date_time can be only one of the following:
  "dateTime": string
  // End of list of possible types for union field _date_time.

  // 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 _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // 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éorologiques.
precipitation

object (Precipitation)

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

object (Wind)

Les conditions de vent.
attribution

object (Attribution)

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

Champ d'union _date_time.

_date_time ne peut être qu'un des éléments suivants :
dateTime

string (Timestamp format)

Code temporel de cette entrée météo horaire ou actuelle.

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

Champ d'union _temperature.

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

object (Temperature)

La 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 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 _date.

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

object (Date)

Date du calendrier civil des prévisions météo quotidiennes.

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

Champ d'union _relative_humidity.

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

integer

Pourcentage d'humidité relative (valeurs comprises entre 0 et 100).

Champ d'union _uv_index.

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

integer

Indice ultraviolet (UV) maximal.

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

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

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.

AirQualityResultData

Représentation JSON 
{
  "hourlyResults": [
    {
      object (AirQualityHourlyResult)
    }
  ],
  "attribution": {
    object (Attribution)
  }
}
Champs
hourlyResults[]

object (AirQualityHourlyResult)

Données horaires sur la qualité de l'air pour l'heure demandée (contient une entrée pour les conditions actuelles ou les requêtes d'une heure, jusqu'à 24 entrées pour une requête portant uniquement sur une date passée ou future, ou les heures actuelles et restantes lorsque la date est aujourd'hui).
attribution

object (Attribution)

Attribution requise à afficher avec les données sur la qualité de l'air.

AirQualityHourlyResult

Représentation JSON 
{
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  },
  "dateTime": {
    object (DateTime)
  }
}
Champs
indexes[]

object (AirQualityIndex)

Indices de la qualité de l'air (par exemple, IQA universel et IQA local)
pollutants[]

object (Pollutant)

Informations détaillées sur les polluants, renseignées lorsque air_quality_options.include_pollutant_concentration est défini sur "true".
healthRecommendations

object (HealthRecommendations)

Recommandations sanitaires pour différents groupes de population.
dateTime

object (DateTime)

Date et heure locales dans le fuseau horaire du lieu pour cette entrée horaire de qualité de l'air (composée de year, month, day, hours, minutes, seconds et utc_offset).

AirQualityIndex

Représentation JSON 
{
  "displayName": string,
  "valueDisplay": string,
  "category": string,
  "dominantPollutant": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
Champs
displayName

string

Nom à afficher de l'indice (par exemple, "IQA universel", "IQA de l'EPA des États-Unis").
valueDisplay

string

Représentation sous forme de chaîne formatée de la valeur de l'IQA.
category

string

Catégorie de qualité de l'air textuelle (par exemple, "Bonne qualité de l'air", "Qualité de l'air modérée").
dominantPollutant

string

Code du polluant dominant (par exemple, "pm25", "o3").

Champ d'union _value.

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

integer

Valeur numérique de l'IQA.

Polluant

Représentation JSON 
{
  "displayName": string,
  "fullName": string,
  "concentration": {
    object (Concentration)
  },
  "additionalInfo": {
    object (AdditionalInfo)
  }
}
Champs
displayName

string

Nom à afficher court du polluant (par exemple, "PM2.5", "O3").
fullName

string

Nom chimique complet ou nom commun du polluant (par exemple, "Particules fines (<2,5 μm)", "Ozone").
concentration

object (Concentration)

Concentration mesurée du polluant.
additionalInfo

object (AdditionalInfo)

Informations supplémentaires sur les sources du polluant et ses effets sur la santé.

Concentration

Représentation JSON 
{
  "unit": enum (Unit),

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

Unité de mesure de la concentration.

Champ d'union _value.

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

number

Valeur numérique de la concentration.

AdditionalInfo

Représentation JSON 
{
  "sources": string,
  "effects": string
}
Champs
sources

string

Principales sources d'émission du polluant.
effects

string

Effets potentiels sur la santé de l'exposition au polluant.

HealthRecommendations

Représentation JSON 
{
  "generalPopulation": string,
  "elderly": string,
  "lungDiseasePopulation": string,
  "heartDiseasePopulation": string,
  "athletes": string,
  "pregnantWomen": string,
  "children": string
}
Champs
generalPopulation

string

Conseils pour la population globale.
elderly

string

Conseils pour les personnes âgées.
lungDiseasePopulation

string

Conseils pour les personnes souffrant d'une maladie pulmonaire ou de troubles respiratoires.
heartDiseasePopulation

string

Conseils pour les personnes souffrant de maladies cardiovasculaires ou cardiaques.
athletes

string

Conseils pour les athlètes et les personnes actives en extérieur.
pregnantWomen

string

Conseils pour les femmes enceintes.
children

string

Conseils pour les enfants.

DateTime

Représentation JSON 
{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}
Champs
year

integer

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

integer

Facultatif. Mois de l'année. Il doit être compris entre 1 et 12, ou égal à 0 si vous spécifiez une date et une heure sans mois.
day

integer

Facultatif. 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 date et une heure sans jour.
hours

integer

Facultatif. Heure de la journée au format 24 heures. Doit être compris entre 0 et 23. La valeur par défaut est 0 (minuit). Une API peut choisir d'autoriser la valeur "24:00:00" pour des cas tels que l'heure de fermeture des bureaux.
minutes

integer

Facultatif. Minutes de l'heure de la journée. Doit être compris entre 0 et 59. La valeur par défaut est 0.
seconds

integer

Facultatif. Secondes de l'heure de la journée. Doit normalement être compris entre 0 et 59. La valeur par défaut est 0. Une API peut autoriser la valeur 60 si elle autorise les secondes intercalaires.
nanos

integer

Facultatif. Fractions de secondes en nanosecondes. La valeur doit être comprise entre 0 et 999 999 999. La valeur par défaut est 0.
Champ d'union time_offset. Facultatif. Spécifie le décalage UTC ou le fuseau horaire de DateTime. Choisissez-les avec soin, en tenant compte du fait que les données de fuseau horaire peuvent changer à l'avenir (par exemple, un pays modifie ses dates de début/fin de l'heure d'été, et les futurs DateTimes de la plage concernée ont déjà été stockés). En cas d'omission, la valeur DateTime est considérée comme étant exprimée en heure locale. time_offset ne peut être qu'un des éléments suivants :
utcOffset

string (Duration format)

Décalage par rapport à l'UTC. Doit être exprimé en secondes entières, entre -18 heures et +18 heures. Par exemple, un décalage UTC de -4:00 serait représenté par { seconds: -14400 }.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"
timeZone

object (TimeZone)

Fuseau horaire.

Durée

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

string (int64 format)

Secondes signées de l'intervalle de temps. Doit être compris entre -315 576 000 000 et +315 576 000 000 (inclus). Remarque : Ces limites sont calculées à partir de : 60 s/min * 60 min/h * 24 h/jour * 365,25 jours/an * 10 000 ans.
nanos

integer

Fractions de seconde signées à une résolution de l'ordre de la nanoseconde de l'intervalle de temps. Les durées inférieures à une seconde sont représentées par un champ seconds de valeur 0 et un champ nanos positif ou négatif. Pour les durées d'une seconde ou plus, une valeur non nulle pour le champ nanos doit avoir le même signe que le champ seconds. La valeur doit être comprise entre -999 999 999 et +999 999 999 inclus.

TimeZone

Représentation JSON 
{
  "id": string,
  "version": string
}
Champs
id

string

Fuseau horaire de la base de données de fuseaux horaires IANA. Par exemple, "America/New_York".
version

string

Facultatif. Numéro de version de la base de données de fuseaux horaires IANA. Par exemple, "2019a".

PollenResultData

Représentation JSON 
{
  "dailyForecast": {
    object (DailyPollenForecast)
  },
  "attribution": {
    object (Attribution)
  }
}
Champs
dailyForecast

object (DailyPollenForecast)

Prévisions polliniques quotidiennes pour la date demandée.
attribution

object (Attribution)

Attribution requise à afficher avec les données sur le pollen.

DailyPollenForecast

Représentation JSON 
{
  "date": {
    object (Date)
  },
  "categories": [
    {
      object (PollenCategoryInfo)
    }
  ],
  "plantSpecies": [
    {
      object (PlantSpeciesInfo)
    }
  ]
}
Champs
date

object (Date)

Date du calendrier civil de la prévision.
categories[]

object (PollenCategoryInfo)

Répartition par grandes catégories de pollen (arbres, graminées, herbacées).
plantSpecies[]

object (PlantSpeciesInfo)

Répartition précise des espèces végétales.

PollenCategoryInfo

Représentation JSON 
{
  "displayName": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "healthRecommendations": [
    string
  ]
}
Champs
displayName

string

Nom à afficher de la catégorie (par exemple, "Arbre", "Herbe", "Mauvaise herbe").
inSeason

boolean

Indique si cette catégorie de pollen est en pleine floraison dans la région.
index

object (PollenIndex)

Mesure de l'indice universel du pollen (UPI, Universal Pollen Index) pour cette catégorie.
healthRecommendations[]

string

Conseils de santé pratiques pour les groupes sensibles au pollen.

PollenIndex

Représentation JSON 
{
  "category": string,
  "description": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
Champs
category

string

Classification localisée des catégories (par exemple, "Aucun", "Très faible", "Faible", "Modéré", "Élevé", "Très élevé").
description

string

Description du niveau de risque lié au pollen.

Champ d'union _value.

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

integer

Valeur numérique de l'UPI (échelle de 0 à 5).

PlantSpeciesInfo

Représentation JSON 
{
  "code": string,
  "displayName": string,
  "family": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "season": string,
  "crossReactions": string
}
Champs
code

string

Code d'espèce lisible par machine (par exemple, "BIRCH", "JAPANESE_CEDAR", "RAGWEED").
displayName

string

Nom à afficher localisé de l'espèce végétale (par exemple, "Bouleau").
family

string

Nom de la famille botanique (par exemple, "Bétulacées (famille des bouleaux)").
inSeason

boolean

Indique si cette espèce de plante est actuellement de saison.
index

object (PollenIndex)

Mesure de l'indice universel du pollen (UPI, Universal Pollen Index) pour cette espèce.
season

string

Description de la saison de floraison typique (par exemple, "Fin de l'hiver, printemps").
crossReactions

string

Allergènes à réaction croisée connus (par exemple, "Pollen d'aulne, de noisetier, de hêtre et de chêne").

Unité

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

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

Phase

Marque la phase lunaire.

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

Remarque : Les conditions avec les valeurs 42 à 139 ne sont actuellement renvoyées que pour les établissements situés au Japon et en Corée.

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 (uniquement 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 des précipitations de plus courte durée que la pluie, caractérisées par un début et une fin soudains, et 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 d'orage.
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.
CLEAR_AFTER_FOG_IN_THE_MORNING Temps clair après du brouillard dans la matinée.
CLEAR_BUT_LATER_TURNING_CLOUDY Temps clair, puis nuageux.
CLEAR_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN Temps clair suivi de pluie et de neige (pluie dominante).
CLEAR_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW Temps clair suivi de neige et de pluie (neige dominante).
CLEAR_BUT_THUNDERSTORMS_LATER Temps clair suivi d'orages.
CLEAR_IN_THE_MORNING_BUT_CLOUDY_IN_THE_EVENING Temps clair dans la matinée, mais nuageux en soirée.
CLEAR_IN_THE_MORNING_WITH_BRIEF_RAIN_IN_THE_EVENING Temps clair dans la matinée suivi d'un peu de pluie en soirée.
CLEAR_MORNING_WITH_BRIEF_RAIN Temps clair et un peu de pluie dans la matinée.
CLEAR_WITH_BRIEF_RAIN Temps clair avec un peu de pluie.
CLEAR_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Temps clair avec un peu de pluie et de neige (pluie dominante).
CLEAR_WITH_BRIEF_RAIN_LATER Temps clair suivi d'un peu de pluie.
CLEAR_WITH_BRIEF_SNOW Temps clair avec un peu de neige.
CLEAR_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Temps clair avec un peu de neige et de pluie (neige dominante).
CLEAR_WITH_BRIEF_SNOW_LATER Temps clair suivi d'un peu de neige.
CLEAR_WITH_PERIODIC_CLOUDS_LATER Temps clair suivi de quelques nuages passagers.
CLEAR_WITH_PERIODIC_RAIN Temps clair avec pluie passagère.
CLEAR_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER Temps clair avec pluie passagère accompagnée de tonnerre.
CLEAR_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Temps clair avec pluie et neige passagères (pluie dominante).
CLEAR_WITH_PERIODIC_RAIN_LATER Temps clair suivi de pluie passagère.
CLEAR_WITH_PERIODIC_SNOW Temps clair avec neige passagère.
CLEAR_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Temps clair avec neige et pluie passagères (neige dominante).
CLEAR_WITH_PERIODIC_SNOW_LATER Temps clair suivi de neige passagère.
CLEAR_WITH_RAIN_AFTER_MIDNIGHT Temps clair et pluie après minuit.
CLEAR_WITH_RAIN_IN_THE_NIGHT Temps clair et pluie dans la nuit.
CLEAR_WITH_RAIN_LATER Temps clair suivi de pluie.
CLEAR_WITH_SNOW_ALONG_THE_MOUNTAINS Temps clair et neige dans les zones montagneuses.
CLEAR_WITH_SNOW_LATER Temps clair suivi de neige.
CLEAR_WITH_THUNDERSTORMS_ALONG_THE_MOUNTAINS Temps clair et orages dans les zones montagneuses.
CLEAR_WITH_THUNDERSTORMS_IN_THE_AFTERNOON Temps clair et orages dans l'après-midi.
CLOUDY_BUT_CLEAR_LATER Nuageux, puis temps clair.
CLOUDY_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN Nuageux suivi de pluie et de neige (pluie dominante).
CLOUDY_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW Nuageux suivi de neige et de pluie (neige dominante).
CLOUDY_BUT_PERIODICALLY_CLEAR_LATER Nuageux, puis quelques éclaircies.
CLOUDY_BUT_THUNDERSTORMS_LATER Nuageux, puis orages.
CLOUDY_MORNING_WITH_BRIEF_RAIN Matinée nuageuse avec un peu de pluie.
CLOUDY_PERIODICALLY_CLEAR Nuageux avec quelques éclaircies.
CLOUDY_SNOWING_IN_THE_EVENING Nuageux avec de la neige en soirée.
CLOUDY_SNOWING_IN_THE_NIGHT Nuageux avec de la neige dans la nuit.
CLOUDY_WITH_BRIEF_RAIN Nuageux avec un peu de pluie.
CLOUDY_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Nuageux avec un peu de pluie et de neige (pluie dominante).
CLOUDY_WITH_BRIEF_RAIN_LATER Nuageux, puis un peu de pluie.
CLOUDY_WITH_BRIEF_SNOW Nuageux avec un peu de neige.
CLOUDY_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Nuageux avec un peu de neige et de pluie (neige dominante).
CLOUDY_WITH_BRIEF_SNOW_LATER Nuageux, puis un peu de neige.
CLOUDY_WITH_BRIEF_THUNDERSTORM Nuageux avec quelques orages.
CLOUDY_WITH_FOG_ON_THE_OCEAN_AND_AT_THE_SEASHORE Nuageux avec du brouillard sur le littoral.
CLOUDY_WITH_PERIODIC_RAIN Nuageux avec pluie passagère.
CLOUDY_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER Nuageux avec parfois de la pluie accompagnée de tonnerre.
CLOUDY_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Nuageux avec pluie et neige passagères (pluie dominante).
CLOUDY_WITH_PERIODIC_RAIN_LATER Temps nuageux suivi de pluie passagère.
CLOUDY_WITH_PERIODIC_SNOW Nuageux avec parfois de la neige.
CLOUDY_WITH_PERIODIC_SNOW_ACCOMPANIED_BY_THUNDER Nuageux avec parfois de la neige accompagnée de tonnerre.
CLOUDY_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Nuageux avec neige et pluie passagères (neige dominante).
CLOUDY_WITH_PERIODIC_SNOW_LATER Nuageux suivi de neige passagère.
CLOUDY_WITH_RAIN_AFTER_MIDNIGHT Nuageux avec de la pluie après minuit.
CLOUDY_WITH_RAIN_FROM_ABOUT_NOON Nuageux avec de la pluie à partir de midi.
CLOUDY_WITH_RAIN_FROM_EVENING Nuageux avec de la pluie à partir du soir.
CLOUDY_WITH_RAIN_LATER Temps nuageux suivi de pluie.
CLOUDY_WITH_SNOW_FROM_AROUND_NOON Nuageux avec de la neige à partir de midi.
CLOUDY_WITH_SNOW_LATER Temps nuageux suivi de neige.
FOG Brouillard.
RAINSNOW_MIX_LATER_BECOMING_CLEAR_RAIN_AS_MAIN Mélange de pluie et de neige (pluie dominante), puis temps clair.
RAINSNOW_MIX_RAIN_AS_MAIN Mélange de pluie et de neige (pluie dominante).
RAINY_BUT_PERIODICALLY_CLEAR Pluvieux avec quelques éclaircies.
RAIN_ACCOMPANIED_BY_LIGHTNING Pluie accompagnée de foudre.
RAIN_ACCOMPANIED_BY_WINDSTORM Pluie accompagnée de rafales de vent.
RAIN_CLEAR_AT_NIGHT Pluie, puis éclaircies dans la nuit.
RAIN_CLEAR_FROM_AROUND_EVENING Pluie suivie d'éclaircies en soirée.
RAIN_CLEAR_FROM_AROUND_NOON Pluie suivie d'éclaircies vers midi.
RAIN_LATER_BECOMING_CLEAR Pluie, puis temps clair.
RAIN_LATER_BECOMING_CLOUDY Pluie, puis nuages.
RAIN_LATER_BECOMING_SNOW Pluie, puis neige.
RAIN_LATER_WITH_PERIODIC_SNOW Pluie, puis neige passagère.
RAIN_SNOW_AT_NIGHT Pluie et neige dans la nuit.
RAIN_SNOW_IN_THE_EVENING Pluie et neige en soirée.
RAIN_TEMPORARILY_BECOMING_SLEET Pluie parfois accompagnée de grésil.
RAIN_THAT_PERIODICALLY_STOPS Pluie avec accalmies passagères.
RAIN_WITH_BRIEF_SNOW Pluie avec un peu de neige.
RAIN_WITH_PERIODIC_SNOW Pluie parfois accompagnée de neige.
SNOWRAIN_MIX_LATER_BECOMING_CLEAR_SNOW_AS_MAIN Mélange de neige et de pluie (neige dominante), puis temps clair.
SNOWRAIN_MIX_LATER_BECOMING_CLOUDY_SNOW_AS_MAIN Mélange de neige et de pluie (neige dominante), puis nuageux.
SNOWRAIN_MIX_SNOW_AS_MAIN Mélange de neige et de pluie (neige dominante).
SNOW_ACCOMPANIED_BY_LIGHTNING Neige accompagnée de foudre.
SNOW_BECOMING_SLEET Neige, puis grésil.
SNOW_LATER_CLEAR Neige, puis temps clair.
SNOW_LATER_CLOUDY Neige, puis nuages.
SNOW_LATER_RAIN Neige, puis pluie.
SNOW_PERIODICALLY_CLEAR Neige avec quelques éclaircies.
SNOW_THAT_PERIODICALLY_STOPS Neige avec accalmies passagères.
SNOW_TURNING_TO_RAIN_AROUND_NOON Neige suivie de pluie vers midi.
SNOW_TURNING_TO_RAIN_IN_THE_EVENING Neige suivie de pluie en soirée.
SNOW_TURNING_TO_RAIN_IN_THE_NIGHT Neige suivie de pluie dans la nuit.
SNOW_WITH_BRIEF_RAIN Neige avec un peu de pluie.
SNOW_WITH_BRIEF_SLEET Neige accompagnée d'un peu de grésil.
SNOW_WITH_PERIODIC_RAIN Neige avec pluie passagère.
VERY_HOT Brûlant.
SLEET Grésil.
HEAVY_RAIN_TO_RAINSTORM Pluie forte à torrentielle.

Type

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

Enums
TYPE_UNSPECIFIED Type de précipitations non spécifié.
NONE Pas de précipitations.
SNOW Précipitations de neige.
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.
PRECIPITATION_TYPE_HAIL Précipitations de grêle.

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.

Rouge carmin

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

Enums
CARDINAL_UNSPECIFIED La direction cardinale n'est pas spécifiée.
NORTH Le point cardinal 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.

Unité

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

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

Unité

Unités utilisées pour mesurer la concentration de polluants.

Enums
UNIT_UNSPECIFIED Unité de concentration non spécifiée.
PARTS_PER_BILLION Parties par milliard (ppb).
MICROGRAMS_PER_CUBIC_METER Microgrammes par mètre cube (µg/m³).

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 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", 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: ❌