- Requête HTTP
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- CurrentConditionsHistory
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 |
Obligatoire. Emplacement pour lequel obtenir les conditions météo actuelles. |
units |
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). |
language |
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 ( |
Champs | |
---|---|
current |
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: |
time |
Fuseau horaire de l'emplacement demandé. |
weather |
Conditions météo actuelles. |
temperature |
La température actuelle |
feels |
Mesure de la température ressentie actuellement à l'emplacement demandé. |
dew |
Température du point de rosée actuelle. |
heat |
Température de l'indice de chaleur actuel. |
wind |
Température ressentie actuelle, température de l'air en contact avec la peau. |
precipitation |
Probabilité de précipitations actuelle et quantité de précipitations accumulées au cours de la dernière heure. |
air |
Conditions de pression atmosphérique actuelles. |
wind |
Conditions de vent actuelles. |
visibility |
Visibilité actuelle. |
current |
Évolution des conditions actuelles au cours des dernières 24 heures. |
is |
"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). |
relative |
Pourcentage actuel d'humidité relative (valeurs comprises entre 0 et 100). |
uv |
Indice ultraviolet (UV) actuel. |
thunderstorm |
Probabilité actuelle d'orage (valeurs comprises entre 0 et 100). |
cloud |
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 ( |
Champs | |
---|---|
temperature |
Température actuelle moins la température d'il y a 24 heures. |
max |
Température maximale (élevée) au cours des dernières 24 heures. |
min |
Température minimale (basse) au cours des dernières 24 heures. |
qpf |
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). |