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 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 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 à récupérer à partir du jour actuel (valeur comprise entre 1 et 10, inclus). La valeur par défaut est la valeur maximale autorisée, à savoir 10.
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 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, selon le nombre de jours 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

ForecastDay

Représente un enregistrement de prévisions quotidiennes 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)
  }
}
Champs
interval

object (Interval)

Intervalle de temps UTC au début (inclus) et à la fin (exclus) de ce jour prévu. Remarque : Une journée commence à 7h et se termine à 7h le lendemain, heure locale. Par exemple, si le fuseau horaire local est UTC-7, l'intervalle commencera à l'heure 14:00:00.000Z et se terminera à la même heure le lendemain.
displayDate

object (Date)

Date locale dans le fuseau horaire du lieu (heure civile) pour lequel cette prévision quotidienne est calculée. Ce champ peut être utilisé à des fins d'affichage sur le client.
daytimeForecast

object (ForecastDayPart)

Conditions météorologiques prévues pour la journée (de 7h à 19h, heure locale).
nighttimeForecast

object (ForecastDayPart)

Conditions météorologiques prévues pour la nuit (de 19h à 7h le lendemain, heure locale).
maxTemperature

object (Temperature)

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

object (Temperature)

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

object (Temperature)

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

object (Temperature)

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

object (Temperature)

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

object (SunEvents)

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

object (MoonEvents)

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

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 si vous spécifiez une année sans mois ni jour.
day

integer

Jour du mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 si vous spécifiez 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)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Champs
interval

object (Interval)

Date et heure UTC de début (inclus) et de fin (exclus) de cette période de la journée. Remarque : Une partie de la 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 commencera à l'heure 14:00:00.000Z et se terminera à 02:00:00.000Z le lendemain. L'intervalle de nuit commencera à 02:00:00.000Z le lendemain et se terminera à 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 maximale et rafales.
iceThickness

object (IceThickness)

Quantité de glace accumulée pour la partie de la journée.
relativeHumidity

integer

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

integer

Index ultraviolet (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 (par exemple, le lever et le coucher du soleil).

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

string (Timestamp format)

Heure à laquelle le soleil se lève.

REMARQUE : Dans certains cas exceptionnels (par exemple, au nord du cercle polaire arctique), il peut arriver 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 utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) 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 exceptionnels (par exemple, au nord du cercle polaire arctique), il peut arriver 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 utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) 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, le lever et le coucher de lune).

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

string (Timestamp format)

Heure à laquelle 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 lune par jour. Dans d'autres cas, la liste peut être vide (par exemple, lorsque la lune se lève après minuit le lendemain). Toutefois, dans des cas uniques (par exemple, dans les régions polaires), la liste peut contenir plusieurs valeurs. Dans ce cas, les valeurs sont triées par ordre croissant.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) 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)

Heure à laquelle 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 lune par jour. Dans d'autres cas, la liste peut être vide (par exemple, lorsque la lune se couche après minuit le lendemain). Toutefois, dans des cas uniques (par exemple, dans les régions polaires), la liste peut contenir plusieurs valeurs. Dans ce cas, les valeurs sont triées par ordre croissant.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) 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 lunaire

MoonPhase

Indique la 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 sa partie droite dans l'hémisphère Nord 🌓 et sur sa partie 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 🌒.