Method: history.hours.lookup

Renvoie jusqu'à 24 heures de données météo historiques horaires à un endroit donné, en commençant par 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 aucune valeur n'est indiquée, les conditions météorologiques renvoyées seront exprimées en unités métriques (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, à savoir 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 à récupérer à partir de la dernière heure (de 1 à 24, inclus). La valeur par défaut est la valeur maximale autorisée, à savoir 24.
languageCode

string

Facultatif. Permet au client de choisir la langue de la réponse. Si aucune donnée n'est disponible pour cette langue, l'API utilise la langue la plus proche. Les valeurs autorisées sont basées 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)

Enregistrements historiques horaires, selon le nombre d'heures et 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.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

HistoryHour

Représente un enregistrement de l'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 heure UTC) pour 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 du lieu (heure civile) pour lesquelles cet enregistrement horaire est calculé. Ce champ peut être utilisé à des fins d'affichage sur le client. Remarque : Cette date comprendra l'année, le mois, le jour, l'heure et le décalage par rapport à UTC.
weatherCondition

object (WeatherCondition)

Conditions météorologiques passées.
temperature

object (Temperature)

La température historique.
feelsLikeTemperature

object (Temperature)

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

object (Temperature)

Température du point de rosée historique.
heatIndex

object (Temperature)

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

object (Temperature)

Le refroidissement éolien historique, la température de l'air exposé sur la peau.
wetBulbTemperature

object (Temperature)

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

object (Precipitation)

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

object (AirPressure)

Conditions de pression atmosphérique historiques.
wind

object (Wind)

Conditions de vent historiques.
visibility

object (Visibility)

Visibilité historique.
iceThickness

object (IceThickness)

Épaisseur historique de la glace.
isDaytime

boolean

"True" si cette heure est comprise entre les heures locales du lever (inclus) et du coucher (exclus) du soleil. Sinon, il s'agit de la nuit (entre le coucher du soleil et le lever du soleil suivant). Remarque : Cette heure sera considérée comme diurne ou nocturne si l'intervalle croise respectivement les heures locales de lever et de coucher du soleil (par exemple, si l'intervalle est de 5h à 6h et que le lever du soleil est à 5h59, isDaytime sera défini sur "true").
relativeHumidity

integer

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

integer

Indice ultraviolet (UV) historique.
thunderstormProbability

integer

Probabilité historique d'orage (valeurs de 0 à 100).
cloudCover

integer

Pourcentage historique du ciel couvert par les nuages (valeurs de 0 à 100).