Method: forecast.hours.lookup

Renvoie jusqu'à 240 heures de prévisions horaires pour un lieu donné, à partir de l'heure actuelle.

Requête HTTP

GET https://weather.googleapis.com/v1/forecast/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 prévisions par heure.
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 de prévisions 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 l'heure actuelle. Valeur comprise entre 1 et 240 (inclus). La valeur par défaut est la valeur maximale autorisée, soit 240.
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 
{
  "forecastHours": [
    {
      object (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Champs
forecastHours[]

object (ForecastHour)

Enregistrements des prévisions horaires, 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

ForecastHour

Représente un enregistrement de prévisions horaires pour un lieu 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) pendant lequel ces données de prévision 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 ces prévisions horaires sont calculées. 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 prévues.
temperature

object (Temperature)

Température prévue
feelsLikeTemperature

object (Temperature)

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

object (Temperature)

Température du point de rosée prévue.
heatIndex

object (Temperature)

Température de l'indice de chaleur prévue.
windChill

object (Temperature)

Température ressentie, c'est-à-dire température de l'air en contact avec la peau.
wetBulbTemperature

object (Temperature)

Température humide prévue, température la plus basse que l'on peut atteindre en évaporant de l'eau.
precipitation

object (Precipitation)

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

object (AirPressure)

Conditions de pression atmosphérique prévues.
wind

object (Wind)

Conditions de vent prévues.
visibility

object (Visibility)

Visibilité prévue.
iceThickness

object (IceThickness)

Épaisseur de glace prévue.
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 d'humidité relative prévu (valeurs comprises entre 0 et 100).
uvIndex

integer

Indice UV prévu
thunderstormProbability

integer

Probabilité de prévision d'orage (valeurs comprises entre 0 et 100)
cloudCover

integer

Pourcentage prévu de couverture nuageuse du ciel (valeurs comprises entre 0 et 100).