Method: forecast.days.lookup

Renvoie jusqu'à 10 jours de prévisions quotidiennes pour un lieu donné, à partir du jour en cours.

Requête HTTP

GET https://weather.googleapis.com/v1/forecast/days:lookup

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
location

object (LatLng)

Obligatoire. Lieu pour lequel obtenir les prévisions quotidiennes.
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 quotidiennes à renvoyer par page (valeur comprise entre 1 et 10, inclus). La valeur par défaut est 5.
pageToken

string

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

integer

Facultatif. Limite le nombre total de jours à extraire à partir du jour actuel. Valeur comprise entre 1 et 10 (inclus). La valeur par défaut est la valeur maximale autorisée, soit 10.
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 la requête RPC days.lookup.

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

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

object (ForecastDay)

Enregistrements des prévisions quotidiennes, en fonction du nombre de jours 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

ForecastDay

Représente un enregistrement de prévision quotidienne pour un lieu donné.

Représentation JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDate": {
    object (Date)
  },
  "daytimeForecast": {
    object (ForecastDayPart)
  },
  "nighttimeForecast": {
    object (ForecastDayPart)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "feelsLikeMaxTemperature": {
    object (Temperature)
  },
  "feelsLikeMinTemperature": {
    object (Temperature)
  },
  "maxHeatIndex": {
    object (Temperature)
  },
  "sunEvents": {
    object (SunEvents)
  },
  "moonEvents": {
    object (MoonEvents)
  },
  "iceThickness": {
    object (IceThickness)
  }
}
Champs
interval

object (Interval)

Intervalle de temps UTC au cours duquel ce jour de prévision commence (inclusif) et se termine (exclusif). Remarque: Un jour commence à 7h et se termine à 7h le jour suivant, heure locale. Par exemple, si le fuseau horaire local est UTC-7, l'intervalle commence à l'heure 14:00:00.000Z et se termine à la même heure le jour suivant.
displayDate

object (Date)

Date locale dans le fuseau horaire de l'emplacement (heure civile) pour lequel ces prévisions quotidiennes sont calculées. Ce champ peut être utilisé à des fins d'affichage sur le client.
daytimeForecast

object (ForecastDayPart)

Prévisions météo pour la journée (de 7h à 19h, heure locale)
nighttimeForecast

object (ForecastDayPart)

Conditions météo prévues pour la nuit (de 19h à 7h du matin, heure locale).
maxTemperature

object (Temperature)

Température maximale (élevée) tout au long de la journée.
minTemperature

object (Temperature)

Température minimale (basse) au cours de la journée.
feelsLikeMaxTemperature

object (Temperature)

Température ressentie maximale (élevée) tout au long de la journée.
feelsLikeMinTemperature

object (Temperature)

Température ressentie minimale (basse) tout au long de la journée.
maxHeatIndex

object (Temperature)

Température maximale de l'indice de chaleur tout au long de la journée.
sunEvents

object (SunEvents)

Événements liés au soleil (lever, coucher du soleil, etc.)
moonEvents

object (MoonEvents)

Événements liés à la lune (par exemple, lever de lune, coucher de lune).
iceThickness

object (IceThickness)

Quantité de glace accumulée tout au long de la journée.

Date

Représente une date du calendrier entière ou partielle, par exemple un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. La date est donnée selon le calendrier grégorien. Il peut s'agir de l'un des éléments suivants:

  • Une date complète, avec des valeurs non nulles pour l'année, le mois et le jour.
  • un mois et un jour, avec une année nulle (par exemple, un anniversaire).
  • une année seule, avec un mois et un jour nuls ;
  • Une année et un mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).

Types associés:

Représentation JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Champs
year

integer

Année de la date. Elle doit être comprise entre 1 et 9999, ou égale à 0 si vous spécifiez une date sans année.
month

integer

Mois d'une année. Il doit être compris entre 1 et 12, ou égal à 0 pour spécifier une année sans mois ni jour.
day

integer

Jour d'un mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 pour spécifier une année seule, ou une année et un mois où le jour n'est pas significatif.

ForecastDayPart

Représente un enregistrement de prévision pour une partie de la journée.

Représentation JSON 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Champs
interval

object (Interval)

Date et heure UTC de début (inclusive) et de fin (exclusive) de cette partie de la journée. Remarque: Une partie d'une journée commence à 7h et se termine à 19h le même jour, heure locale. Par exemple, si le fuseau horaire local est UTC-7, l'intervalle de jour commence à l'heure 14:00:00.000Z et se termine à 02:00:00.000Z le jour suivant, et l'intervalle de nuit commence à 02:00:00.000Z le jour suivant et se termine à 14:00:00.000Z le même jour.
weatherCondition

object (WeatherCondition)

Conditions météorologiques prévues.
precipitation

object (Precipitation)

Précipitations prévues.
wind

object (Wind)

Direction moyenne du vent, vitesse et rafales maximales
relativeHumidity

integer

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

integer

Indice UV maximal prévu.
thunderstormProbability

integer

Probabilité moyenne d'orage.
cloudCover

integer

Pourcentage moyen de couverture nuageuse.

SunEvents

Représente les événements liés au soleil (lever, coucher du soleil, etc.).

Représentation JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Champs
sunriseTime

string (Timestamp format)

Heure à laquelle le soleil se lève.

REMARQUE: Dans certains cas particuliers (par exemple, au nord du cercle polaire arctique), il est possible qu'il n'y ait pas d'heure de lever du soleil pour une journée donnée. Dans ce cas, ce champ ne sera pas défini.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
sunsetTime

string (Timestamp format)

Heure à laquelle le soleil se couche.

REMARQUE: Dans certains cas particuliers (par exemple, au nord du cercle polaire arctique), il est possible qu'il n'y ait pas d'heure de coucher du soleil pour une journée donnée. Dans ce cas, ce champ ne sera pas défini.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

MoonEvents

Représente les événements liés à la lune (par exemple, lever de lune, coucher de lune).

Représentation JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Champs
moonriseTimes[]

string (Timestamp format)

Moment où le limbe supérieur de la Lune apparaît au-dessus de l'horizon (voir https://en.wikipedia.org/wiki/Moonrise_and_moonset).

REMARQUE: Dans la plupart des cas, il n'y a qu'une seule heure de lever de la lune par jour. Dans d'autres cas, la liste peut être vide (par exemple, lorsque la lune se lève après minuit du jour suivant). Toutefois, dans des cas particuliers (par exemple, dans les régions polaires), la liste peut contenir plusieurs valeurs. Dans ce cas, les valeurs sont triées dans l'ordre croissant.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
moonsetTimes[]

string (Timestamp format)

Moment où le limbe supérieur de la Lune disparaît sous l'horizon (voir https://en.wikipedia.org/wiki/Moonrise_and_moonset).

REMARQUE: Dans la plupart des cas, il n'y a qu'une seule heure de coucher de la lune par jour. Dans d'autres cas, la liste peut être vide (par exemple, lorsque la lune se couche après minuit du jour suivant). Toutefois, dans des cas particuliers (par exemple, dans les régions polaires), la liste peut contenir plusieurs valeurs. Dans ce cas, les valeurs sont triées dans l'ordre croissant.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

Phase de la Lune (également appelée phase lunaire)

MoonPhase

Indique la phase de la Lune (phase lunaire).

Enums
MOON_PHASE_UNSPECIFIED Phase lunaire non spécifiée.
NEW_MOON La Lune n'est pas éclairée par le soleil.
WAXING_CRESCENT La Lune est éclairée à 0 % à 50% sur son côté droit dans l'hémisphère nord 🌒 et sur son côté gauche dans l'hémisphère sud 🌘.
FIRST_QUARTER La Lune est éclairée à 50,1% sur son côté droit dans l'hémisphère nord 🌓 et sur son côté gauche dans l'hémisphère sud 🌗.
WAXING_GIBBOUS La Lune est éclairée à 50 % à 100% sur son côté droit dans l'hémisphère nord 🌔 et sur son côté gauche dans l'hémisphère sud 🌖.
FULL_MOON La Lune est entièrement éclairée.
WANING_GIBBOUS La Lune est éclairée à 50 % à 100% sur son côté gauche dans l'hémisphère nord 🌖 et sur son côté droit dans l'hémisphère sud 🌔.
LAST_QUARTER La Lune est éclairée à 50,1% sur son côté gauche dans l'hémisphère nord 🌗 et sur son côté droit dans l'hémisphère sud 🌓.
WANING_CRESCENT La Lune est éclairée à 0 % à 50% sur son côté gauche dans l'hémisphère nord 🌘 et sur son côté droit dans l'hémisphère sud 🌒.