Method: history.hours.lookup

Renvoie jusqu'à 24 heures d'historique météorologique par heure pour un emplacement donné, à partir de la dernière heure.

Requête HTTP

GET https://weather.googleapis.com/v1/history/hours:lookup

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
location

object (LatLng)

Obligatoire. Emplacement pour lequel obtenir les données historiques horaires.
unitsSystem

enum (UnitsSystem)

Facultatif. Système d'unités à utiliser pour les conditions météorologiques renvoyées. Si ce paramètre n'est pas fourni, les conditions météorologiques renvoyées seront exprimées dans le système métrique (valeur par défaut : METRIC).
pageSize

integer

Facultatif. Nombre maximal d'enregistrements historiques horaires à renvoyer par page (valeur comprise entre 1 et 24 inclus). La valeur par défaut est la valeur maximale autorisée, soit 24.
pageToken

string

Facultatif. Jeton de page reçu d'une requête précédente. Il permet de récupérer la page suivante.
hours

integer

Facultatif. Limite le nombre total d'heures à extraire à partir de la dernière heure (de 1 à 24 heures inclus). La valeur par défaut est la valeur maximale autorisée, soit 24.
languageCode

string

Facultatif. Permet au client de choisir la langue de la réponse. Si aucune donnée ne peut être fournie pour cette langue, l'API utilise la correspondance la plus proche. Les valeurs autorisées reposent sur la norme IETF BCP-47. La valeur par défaut est "en".

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse pour le RPC hours.lookup.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "historyHours": [
    {
      object (HistoryHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Champs
historyHours[]

object (HistoryHour)

Les enregistrements historiques par heure, en fonction du nombre d'heures et de la taille de page spécifiés dans la requête.
timeZone

object (TimeZone)

Fuseau horaire de l'emplacement demandé.
nextPageToken

string

Jeton permettant de récupérer la page suivante.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform

HistoryHour

Représente un enregistrement d'historique horaire à un emplacement donné.

Représentation JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDateTime": {
    object (DateTime)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "wetBulbTemperature": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Champs
interval

object (Interval)

Intervalle d'une heure (en temps UTC) pendant lequel ces données historiques sont valides (les codes temporels sont arrondis à l'heure la plus proche).
displayDateTime

object (DateTime)

Date et heure locales dans le fuseau horaire de l'emplacement (heure civile) pour lequel cet enregistrement horaire est calculé. Ce champ peut être utilisé à des fins d'affichage sur le client. Remarque: Cette date comprend l'année, le mois, le jour, l'heure et le décalage par rapport au fuseau UTC.
weatherCondition

object (WeatherCondition)

Conditions météorologiques historiques.
temperature

object (Temperature)

Historique de la température.
feelsLikeTemperature

object (Temperature)

Mesure de la température ressentie à l'emplacement demandé.
dewPoint

object (Temperature)

Historique de la température du point de rosée.
heatIndex

object (Temperature)

Température de l'indice de chaleur historique.
windChill

object (Temperature)

Indice de refroidissement éolien historique, température de l'air en contact avec la peau.
wetBulbTemperature

object (Temperature)

Température humide historique, température la plus basse pouvant être atteinte par évaporation de l'eau.
precipitation

object (Precipitation)

Historique de la probabilité de précipitations et de la quantité de précipitations accumulées au cours de la dernière heure.
airPressure

object (AirPressure)

Historique des conditions de pression atmosphérique
wind

object (Wind)

Les conditions historiques du vent
visibility

object (Visibility)

Visibilité historique.
iceThickness

object (IceThickness)

Épaisseur de glace historique.
isDaytime

boolean

"True" si cette heure est comprise entre l'heure locale du lever du soleil (inclus) et du coucher du soleil (exclu). Sinon, il fait nuit (entre le coucher du soleil et le lever du soleil suivant). Remarque : cette heure sera considérée comme une heure de jour ou de nuit si l'intervalle intersecte respectivement les heures de lever et de coucher du soleil locales (par exemple, si l'intervalle est compris entre 5h et 6h et que le lever du soleil a lieu à 5h59, la valeur "isDaytime" sera "true").
relativeHumidity

integer

Pourcentage historique de l'humidité relative (valeurs comprises entre 0 et 100).
uvIndex

integer

Indice UV historique
thunderstormProbability

integer

Probabilité historique d'orage (valeurs comprises entre 0 et 100)
cloudCover

integer

Pourcentage historique du ciel couvert de nuages (valeurs comprises entre 0 et 100).