Method: currentConditions.lookup

Affiche les conditions météo actuelles à un emplacement donné.

Requête HTTP

GET https://weather.googleapis.com/v1/currentConditions: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 conditions météo actuelles.

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).

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 de l'appel RPC currentConditions.lookup : représente les conditions météorologiques actuelles à l'emplacement demandé.

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

Représentation JSON
{
  "currentTime": string,
  "timeZone": {
    object (TimeZone)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "currentConditionsHistory": {
    object (CurrentConditionsHistory)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Champs
currentTime

string (Timestamp format)

Heure actuelle (UTC) associée aux données renvoyées.

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".

timeZone

object (TimeZone)

Fuseau horaire de l'emplacement demandé.

weatherCondition

object (WeatherCondition)

Conditions météo actuelles.

temperature

object (Temperature)

La température actuelle

feelsLikeTemperature

object (Temperature)

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

dewPoint

object (Temperature)

Température du point de rosée actuelle.

heatIndex

object (Temperature)

Température de l'indice de chaleur actuel.

windChill

object (Temperature)

Température ressentie actuelle, température de l'air en contact avec la peau.

precipitation

object (Precipitation)

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

airPressure

object (AirPressure)

Conditions de pression atmosphérique actuelles.

wind

object (Wind)

Conditions de vent actuelles.

visibility

object (Visibility)

Visibilité actuelle.

currentConditionsHistory

object (CurrentConditionsHistory)

Évolution des conditions actuelles au cours des dernières 24 heures.

isDaytime

boolean

"True" si l'heure actuelle à l'emplacement demandé est comprise entre l'heure du lever du soleil local (inclus) et celle du coucher du soleil (exclu). Sinon, il fait nuit (entre le coucher du soleil et le lever du soleil suivant).

relativeHumidity

integer

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

uvIndex

integer

Indice ultraviolet (UV) actuel.

thunderstormProbability

integer

Probabilité actuelle d'orage (valeurs comprises entre 0 et 100).

cloudCover

integer

Pourcentage actuel du ciel couvert par des nuages (valeurs comprises entre 0 et 100).

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

CurrentConditionsHistory

Représente un ensemble de modifications des conditions actuelles au cours des dernières 24 heures.

Représentation JSON
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Champs
temperatureChange

object (Temperature)

Température actuelle moins la température d'il y a 24 heures.

maxTemperature

object (Temperature)

Température maximale (élevée) au cours des dernières 24 heures.

minTemperature

object (Temperature)

Température minimale (basse) au cours des dernières 24 heures.

qpf

object (QuantitativePrecipitationForecast)

Quantité de précipitations (pluie ou neige), mesurée en équivalent eau liquide, accumulée au cours des dernières 24 heures. Remarque: QPF est l'abréviation de "Prévision quantitative de précipitations" (pour en savoir plus, consultez la définition de QuantitativePrecipitationForecast).