Présentation de l'API Weather

L'API Weather vous permet de demander des données météo hyperlocalisées en temps réel pour des lieux du monde entier afin d'alimenter des tableaux de bord météo en direct, des applications de mise à jour météo, des superpositions météo sur les itinéraires et des moniteurs d'activité physique ou de santé basés sur la météo. Les informations météorologiques incluent la température actuelle, les précipitations, l'humidité relative, la vitesse du vent, l'indice UV, etc.

Pour un emplacement à une latitude et une longitude données, l'API fournit des points de terminaison (https://weather.googleapis.com/v1/...) pour les données du tableau suivant.

Points de terminaison REST en un coup d'œil

Point de terminaison de l'API URL Description Paramètres documentés
Conditions actuelles https://weather.googleapis.com/v1/currentConditions:lookup Conditions météo en direct location.latitude, location.longitude
Prévisions horaires https://weather.googleapis.com/v1/forecast/hours:lookup Jusqu'à 240 heures de prévisions météo location.latitude, location.longitude
Prévisions quotidiennes https://weather.googleapis.com/v1/forecast/days:lookup Prévisions jusqu'à 10 jours location.latitude, location.longitude
Historique horaire https://weather.googleapis.com/v1/history/hours:lookup Jusqu'à 24 heures de conditions passées mises en cache location.latitude, location.longitude
Alertes météo importantes https://weather.googleapis.com/v1/publicAlerts:lookup Alertes météo importantes key, location.latitude et location.longitude

Cas d'utilisation courants

Fonctionnalités de l'API Weather

Les données de l'API Weather incluent les éléments suivants :

  • Conditions météo et icônes : description et icône correspondante indiquant les conditions météo actuelles (par exemple, "Nuageux" ou "Averses de neige éparses") dans weatherCondition.
  • Température : température actuelle (temperature), températures minimale et maximale (minTemperature et maxTemperature sur les prévisions quotidiennes, ou dans currentConditionsHistory) et température apparente ("ressentie") (feelsLikeTemperature).
  • Précipitations : précipitations totales et type de précipitations (neige, pluie, glace, mélange).
  • Vent : refroidissement éolien (windChill), direction du vent (wind.direction), vitesse du vent (wind.speed) et rafales (wind.gust).
  • Épaisseur de la glace : épaisseur de la glace.
  • Humidité : point de rosée (dewPoint), indice de chaleur (heatIndex), température humide (wetBulbTemperature) et humidité relative (relativeHumidity).
  • Indice UV : indice ultraviolet (UV) (uvIndex).
  • Probabilité d'orage : probabilité qu'un orage se produise, exprimée en pourcentage.
  • Visibilité : distance à laquelle un objet est clairement visible.
  • Pression atmosphérique : pression atmosphérique moyenne au niveau de la mer.
  • Événements liés au soleil et à la lune : lever et coucher du soleil, lever et coucher de la lune.
  • Couverture nuageuse : pourcentage du ciel couvert par des nuages.

Utiliser l'API Weather

1 Configurer Commencez par Configurer votre projet Google Cloud, puis suivez les instructions.
2 Obtenir les conditions actuelles Consultez Obtenir les conditions actuelles.
3 Obtenir les prévisions heure par heure Consultez Obtenir les prévisions par heure.
4 Obtenir les prévisions quotidiennes Consultez Obtenir des prévisions quotidiennes.
5 Obtenir l'historique horaire Consultez Obtenir l'historique horaire.
6 Recevoir des alertes météo Consultez Recevoir des alertes météo.

Pour l'indice de la qualité de l'air (IQA) et les particules polluantes (PM2,5, PM10), utilisez l'API Air Quality (https://airquality.googleapis.com/v1/currentConditions:lookup). L'API Weather ne renvoie pas ces valeurs.

Voici d'autres API environnementales associées :

  • Taux de pollen : API Pollen (https://pollen.googleapis.com/v1/forecast:lookup)
  • Rayonnement solaire et potentiel des toitures : API Solar (https://solar.googleapis.com/v1/buildingInsights:findClosest)

Étape suivante