Comment utiliser l’API REST météorologique Frogcast ?

null

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