Comment utiliser l’API REST météorologique Frogcast ?
null
Technologie
25/04/2024
par
Théo Masson
10 min
null
null
Comme mentionné dans nos précédents articles, il devient primordial pour de nombreuses entreprises d’accéder à des données météorologiques fiables et précises pour faciliter leur gestion au quotidien. Heureusement, nos dernières évolutions technologiques permettent aux développeurs d’intégrer simplement et rapidement ces données météo dans leurs applications avec la technologie d’API REST.
Théo, notre CTO, explique dans cet article le fonctionnement des API REST et comment prendre en main l’API Frogcast.
null
Qu’est-ce qu’une API REST météo ?
null
Une API météo REST est une API suivant la sémantique REST permettant aux applications de demander des données météorologiques via HTTP de manière efficace et standardisée au travers d’une simple adresse URL comportant un certain nombre de paramètres.
Globalement, l’API météo REST est un intermédiaire qui va récupérer les données météo d’un serveur, puis les transmettre de manière transparente dans une application finale.
null
Pourquoi utiliser une API météo REST ?
null
Les conditions météorologiques impactent de nombreux secteurs d’activité, agriculture, transport, BTP, etc. Ainsi, avoir accès à des données météorologiques précises permet de prendre des décisions opérationnelles éclairées. C’est là toute l’utilité d’une API météo REST.
Elle permet aux développeurs d’application, d’outils d’aide à la décision d'intégrer de manière transparente les données météorologiques dans celles-ci.
L’API météo REST permet aux développeurs de soumettre uniquement des requêtes API afin de recevoir les prévisions météo sur le point qui les intéresse, sans interface graphique. Ils n’ont plus besoin de collecter et de traiter les données eux-mêmes provenant des différents organismes météorologiques au travers de formats non unifiés et pas toujours en open-source. Cela représente un gain de temps important et assure surtout l’accès à des données précises et actualisées.
Utiliser cette API présente de nombreux avantages :
➡️ Intégrer des données météorologiques précises et actualisées.
➡️ Augmenter les fonctionnalités de votre application ou outil d’aide à la décision.
➡️ Améliorer l'expérience utilisateur en lui fournissant toutes les données nécessaires à la gestion de ses opérations.
Une API RESTful présente une grande flexibilité. Le serveur distant ne communique avec votre serveur qu’en cas de demande (requête) et vous n’obtenez que les données dont vous avez besoin. Il n’est plus nécessaire de stocker des données intermédiaires ni de garantir l’approvisionnement à partir des différentes sources météorologiques existantes. Seul l’accès à cette API est à maintenir, ce qui simplifie énormément la tâche pour l’équipe de développement. Cette dernière peut alors se concentrer sur l’utilisation de ces données météo pour leurs propres applications métier.
null
Commencer avec une API météo REST
null
Au premier abord, l’utilisation d’une API météo REST peut sembler compliquée. Mais en réalité, celle-ci est relativement simple. Nous allons voir comment commencer avec l’API Frogcast.
null
null
Utilisation de la clé API Frogcast
Afin d’accéder aux données météorologiques de Frogcast, vous aurez besoin d'une clé API. Cette clé est un identifiant unique qui authentifie l'utilisateur ou l'application effectuant une requête. Lorsque vous envoyez une demande à l'API météo, la clé est utilisée pour vérifier vos privilèges d'accès et suivre l'utilisation du service.
null
null
Accéder à votre clé API
Pour obtenir votre clé API météo Frogcast, créez un compte sur Frogcast.
Une fois l’inscription effectuée, vous pourrez accéder à votre clé API dans votre espace personnel.
Veuillez garder cette clé confidentielle. Maintenant que vous avez votre clé, vous pouvez commencer à requêter l'API Frogcast, et ainsi intégrer les données météorologiques dont vous avez besoin dans vos applications et outils d’aide à la décision.
null
Comment utiliser une API météo REST ?
null
Maintenant que vous disposez de votre clé API, il est temps de commencer à utiliser l’API.
Les API REST offrent une grande polyvalence, vous permettant de demander des données météorologiques.
null
null
Accéder aux prévisions météorologiques
L’API Frogcast vous permet d’obtenir des prévisions météorologiques pour les 15 prochains jours. Ces données sont essentielles pour de nombreux secteurs d’activité.
null
Faire des requêtes API pour obtenir vos données
null
Envoyer une requête à l'API météo de Frogcast est très simple.
Si vous êtes déjà connecté à votre compte, vous pouvez simplement ouvrir un nouvel onglet et entrer une URL avec la structure suivante :
Exemple : https://api.frogcast.com/api/v1/forecast/?latitude=45.05&longitude=5.32&fields=tcc,t2m_p80&horizon=14400&time_step=30&format=json
null
null
Vous obtiendrez ici les données de couverture nuageuse totale (tcc) et le quantile p80 de la température (t2m) pour la localisation souhaitée sur les 10 prochains jours avec un pas de temps 30 minutes.
Comme vous pouvez le voir, la requête utilise une adresse simple (https://api.frogcast.com/api/v1/forecast/) à laquelle on peut associer un certain nombre de paramètres (dont certains sont facultatifs) :
➡️ latitude/longitude (obligatoires)
➡️ fields (obligatoire) : la liste des variables météo que vous souhaitez (ou utilisez une requête GET, pour accéder à la liste des variables météorologiques disponibles : https://api.frogcast.com/api/v1/allfields/
➡️ horizon (facultatif, default = 21600) : horizon de prévision en minutes,
➡️ time_step (facultatif, default=60) : time step des données en minutes, disponible : 1,5,10,15,30,60. Une interpolation est effectuée pour descendre en dessous de l’heure, nous conseillons de garder l’heure comme base de travail.
➡️ format (facultatif, available default, json, recommended to use json)
➡️ précision (facultatif, default = 2 digit)
Bien entendu, pour le développement de vos applications, vous n'effecturez pas les appels dans votre navigateur. Cependant l’URL finale restera la même, seuls vos identifiants devront être transmis en plus.
Exemple de code Python :
import pandas as pd
import requests
headers = {'Authorization':'Token {your token}'}
url = 'https://api.frogcast.com/api/v1/forecast/'
parameters = {'latitude':45.63562,
'longitude': 5.63256,
'time_step':60,
'horizon':2880,
'fields':"ghi"}
api_data = requests.get(url=url,params=parameters,headers=headers).json()
forecast = pd.DataFrame(data=api_data['data'], index=api_data['index'], columns=api_data['columns'])
print(forecast)
Nous avons rajouté dans cet exemple la mise en forme des données dans un dataframe, structure de base pour l’utilisation des données sous Python.
null
Les réponses de l’API
null
Après avoir envoyé une requête, le serveur API répondra avec un code 200 et des données au format JSON sous forme de trois listes : la première contenant les dates, la seconde les variables, et la dernière les valeurs. Pour utiliser ces données dans votre application, vous devrez extraire les informations dont vous avez besoin. De nombreux langages de programmation permettent d’analyser les données au format JSON, choisissez donc celui qui convient le mieux à vos besoins.
null
Une requête API unique pour toutes vos variables météorologiques
null
Maintenant que vous savez utiliser l’API météo Frogcast, vous pouvez récupérer toutes les données que vous souhaitez.
Notre API offre l’avantage de pouvoir récupérer les prévisions météorologiques de l’ensemble des variables météorologiques de votre point d'intérêt en une seule requête API, minimisant ainsi le nombre d'appels API que vous avez à faire !
null
Testez gratuitement !
null
null
null
null
null
null
