- Requête HTTP
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Niveaux d'accès des autorisations
- CurrentConditionsHistory
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 |
Obligatoire. Emplacement pour lequel obtenir les conditions météo actuelles. |
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 |
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 ( |
| Champs | |
|---|---|
currentTime |
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 : |
timeZone |
Fuseau horaire de l'emplacement demandé. |
weatherCondition |
Conditions météo actuelles. |
temperature |
La température actuelle |
feelsLikeTemperature |
Mesure de la température ressentie actuellement à l'emplacement demandé. |
dewPoint |
Température actuelle du point de rosée. |
heatIndex |
La température actuelle de l'indice de chaleur. |
windChill |
Le refroidissement éolien actuel, soit la température de l'air à laquelle la peau est exposée. |
precipitation |
Probabilité de précipitations actuelle et quantité de précipitations accumulées au cours de la dernière heure. |
airPressure |
Conditions de pression atmosphérique actuelles. |
wind |
Conditions de vent actuelles. |
visibility |
Visibilité actuelle. |
currentConditionsHistory |
Évolution des conditions actuelles au cours des dernières 24 heures. |
isDaytime |
"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 |
Pourcentage actuel d'humidité relative (valeurs comprises entre 0 et 100). |
uvIndex |
Indice ultraviolet (UV) actuel. |
thunderstormProbability |
Probabilité actuelle d'orage (valeurs comprises entre 0 et 100). |
cloudCover |
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 ( |
| Champs | |
|---|---|
temperatureChange |
La température actuelle moins la température d'il y a 24 heures. |
maxTemperature |
Température maximale au cours des dernières 24 heures. |
minTemperature |
Température minimale (basse) au cours des dernières 24 heures. |
snowQpf |
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 |
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". |