Method: currentConditions.lookup

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

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 au RPC currentConditions.lookup. Elle 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 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".

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 actuelle du point de rosée.

heatIndex

object (Temperature)

La température actuelle de l'indice de chaleur.

windChill

object (Temperature)

Le refroidissement éolien actuel, soit la température de l'air à laquelle la peau est exposée.

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 locale du lever du soleil (inclus) et celle du coucher du soleil (exclus). Sinon, il s'agit de la 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 les nuages (valeurs de 0 à 100).

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

CurrentConditionsHistory

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

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

object (Temperature)

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

maxTemperature

object (Temperature)

Température maximale au cours des dernières 24 heures.

minTemperature

object (Temperature)

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

snowQpf

object (QuantitativePrecipitationForecast)

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

qpf

object (QuantitativePrecipitationForecast)

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