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 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 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, à 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 l'heure actuelle. La valeur doit être comprise entre 1 et 240 (inclus). La valeur par défaut est la valeur maximale autorisée, à savoir 240.
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 
{
  "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.

Niveaux d'accès 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) pour 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 la zone (heure civile) pour laquelle cette prévision horaire est calculée. 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 prévues.
temperature

object (Temperature)

Température prévue.
feelsLikeTemperature

object (Temperature)

Mesure de la 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)

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

object (Temperature)

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

object (Precipitation)

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

integer

Indice ultraviolet (UV) prévu.
thunderstormProbability

integer

Probabilité d'orage prévue (valeurs comprises entre 0 et 100).
cloudCover

integer

Pourcentage prévu du ciel couvert par les nuages (valeurs de 0 à 100).