Method: lookupWeather

Recherchez les conditions météo d'un lieu.

Requête HTTP

POST https://mapstools.googleapis.com/v1alpha:lookupWeather

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
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éo.
capabilities[]

enum (Capability)

Facultatif. Capacités environnementales à inclure dans la réponse.
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 jusqu'à +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).
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.
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.
weatherOptions

object (WeatherOptions)

Facultatif. Options spécifiques aux requêtes météo. weatherOptions.units_system est compatible avec unitsSystem 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.
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.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de LookupWeatherResponse.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

  • https://www.googleapis.com/auth/maps-platform.mapstools