Comment utiliser notre URL Creator

La mission de Meteomatics est de rendre l'accès aux données météorologiques intuitif et direct. Nous y parvenons notamment grâce à notre URL Creator. Lisez cet article pour en savoir plus.

Qu'est-ce que l'URL Creator ?

L'URL Creator est une interface utilisateur graphique (GUI) qui vous aide à créer des requêtes URL pour l'API de Meteomatics. Il vous suffit de cliquer ici pour le voir en action ! Pour ce faire, vous aurez besoin d'un compte API - voir ci-dessous.

Pourquoi Meteomatics a-t-il créé l'URL Creator ?

La création d'une URL est le principal moyen d'utiliser l'API de Meteomatics. La plupart de nos connecteurs pour les langages de programmation sont simplement des bibliothèques qui écrivent automatiquement une URL et effectuent une requête dans les coulisses.

La particularité d'une URL est qu'elle doit être écrite d'une manière très spécifique. De petites fautes de frappe peuvent conduire à des messages d'erreur frustrants ; placer des arguments dans le mauvais ordre peut générer des résultats déroutants. Bien que l'URL Creator ne vous offre pas toute la flexibilité de notre API, il vous aidera à créer et à comprendre vos premières requêtes simples. De nombreuses personnes n'auront jamais besoin de demander à l'API quoi que ce soit de plus compliqué que ce que le créateur d'URL peut gérer. Pour tous les autres, il s'agit d'un outil précieux pour apprendre à écrire une URL correctement formatée, avant d'ajouter de la complexité à l'avenir.

Comment utiliser l'URL Creator

Regardez la vidéo ci-dessous pour voir à quel point il est facile d'utiliser l'URL Creator, ou continuez à lire pour voir mon exemple facile, étape par étape, dans lequel je l'utilise afin de récupérer des données de température pour le lendemain à Lisbonne.

Apprenez à utiliser l'URL Creator en moins d'une minute

Format

Tout d'abord, je choisis le type de sortie que je souhaite obtenir de l'API. Dans ce cas, je veux qu'une série temporelle apparaisse dans mon navigateur web, je choisis donc HTML (plot).

Les autres options me permettent de :

• ouvrir une carte 2D des données dans mon navigateur (carte HTML)
• voir la carte en couleur des données 2D sans données cartographiques (PNG)
  • notez que la taille des pixels dans un .png est fixe, vous devrez donc peut-être interroger une zone plus grande ou à une résolution plus élevée pour produire une image suffisamment grande
• visualiser un format de données structuré (JSON ou XML) dans mon navigateur
• télécharger un fichier CSV, NetCDF ou GeoTIFF contenant les données

Lieu

Je choisis ensuite le lieu de ma requête.

Vous pouvez voir dans les boîtes d'information de cette étape que, comme je veux une série temporelle, je ne peux choisir qu'un seul lieu - j'ai choisi Lisbonne. Le créateur d'URL vous permet de saisir des noms de lieux et détermine automatiquement le point central de ces lieux pour vous (s'ils sont suffisamment connus - sinon, vous pouvez indiquer vos propres latitudes et longitudes).

Pour les données cartographiques, l'URL Creator détermine également automatiquement le cadre englobant les lieux bien connus. Bien entendu, vous pouvez également indiquer vos propres latitudes et longitudes.

Paramètres

Bien que notre série temporelle soit limitée à un seul lieu par requête, nous pouvons ajouter plusieurs paramètres pour le même lieu. Cela peut être visuellement peu attrayant si les résultats sont représentés sur le même graphique (parce qu'ils partagent un axe y et que l'échelle peut donc être faussée), mais c'est très utile si vous avez l'intention de télécharger les données et de les utiliser hors ligne.

Les données 2D ne vous permettent cependant pas de demander plusieurs paramètres à la fois - cela impliquerait de dessiner deux cartes de couleurs différentes sur la même zone, et le résultat serait plutôt désordonné ! (Si vous voulez vraiment faire cela, notre outil de visualisation météorologique MetX vous permet de tracer des données cartographiques avec différents schémas de couleurs, opacités et styles, par exemple des contours par opposition à des couleurs unies, afin que vous puissiez contrôler entièrement la visualisation de vos données).

Time steps

Ensuite, nous devons décider les time steps impliqués dans nos demandes. Là encore, les requêtes de données 2D ne permettent de visualiser qu'un seul time step à la fois. Pour notre série temporelle 1D, je peux sélectionner un point de départ et un point d'arrivée, ainsi que l'espacement souhaité entre les time steps.

Enfin, nous pouvons choisir notre modèle météorologique. Pour vos premières utilisations, je vous suggère de laisser la valeur par défaut "mix", qui est notre façon de vous éviter d'avoir à réfléchir précisément au modèle à sélectionner. Mix sélectionne automatiquement le modèle le plus pertinent pour une heure et un lieu donnés.

Si vous souhaitez voir les résultats d'une source de données spécifique, vous pouvez l'ajouter ici, mais en général, le mélange vous donnera toujours le résultat le plus fiable.

Lorsque vous aurez terminé de travailler avec l'URL Creator, votre URL aura le format ci-dessus, rempli selon vos spécifications. Vous avez ensuite la possibilité de copier l'URL, ce qui vous permet de la coller dans n'importe quelle application, ou de cliquer simplement sur "ouvrir dans le navigateur" pour faire automatiquement la demande dans un nouvel onglet.

Ici, si vous ne l'avez pas encore fait, votre navigateur vous demandera votre nom d'utilisateur et votre mot de passe - si vous ne les avez pas, visitez cette page pour vous inscrire à un compte Free Basic ou allez ici pour un essai gratuit de notre API. Vous ne savez pas quelle est la différence entre ces deux types de compte ? Consultez cet article pour en savoir plus.

Ci-dessus, vous pouvez voir le résultat de ma demande. Si, au lieu de demander une série temporelle, je décide de regarder un seul time step pour toute l'Europe (HTML (carte) dans la section format), ma sélection de lieux ressemblera à ceci...

...et la requête qui en résulte est la suivante :

La latitude et la longitude de la région sont automatiquement ajoutées par l'interface graphique, et les données numériques pour chaque pixel sont disponibles sous forme d'info-bulle au passage de la souris.

Comment télécharger des données avec l'URL Creator ?

Il est facile de télécharger des données avec l'URL Creator. Nous prenons en charge trois types de fichiers pour le téléchargement : CSV, NetCDF et GeoTIFF. Il vous suffit de sélectionner l'un d'entre eux lors de la deuxième étape ("format de réponse et forme des données") et l'URL terminé contiendra automatiquement des instructions pour télécharger le fichier correspondant.

Quel type de données pouvez-vous obtenir avec l'URL Creator ?

Vous pouvez utiliser l'URL Creator pour récupérer toutes les données auxquelles vous avez droit ! Cela varie en fonction de votre abonnement à l'API. Nous proposons trois types d'abonnement.

Pour les utilisateurs qui commencent à utiliser notre API, ou qui ont des besoins très limités, un compte Free Basic répondra à vos besoins.

Le compte Free Basic ne coûte rien, n'est pas limitée dans le temps et vous donne accès aux données des 24 heures précédentes ainsi qu'aux prévisions à 10 jours pour 15 des paramètres météorologiques les plus élémentaires, dont la température, la pression, la vitesse du vent et les précipitations.

Si vous avez besoin de plus de paramètres, d'un plus grand nombre de demandes quotidiennes, et/ou d'un accès à des prévisions plus longues ou à davantage de données historiques, vous devrez vous procurer un compte Business. Le coût est ajusté en fonction de vos besoins, de sorte que vous n'avez pas à payer pour des choses dont vous n'avez pas besoin. Les comptes Business vous permettent également de sélectionner n'importe quel modèle disponible via l'API, plutôt que d'être contraint à un mélange, et incluent des profils verticaux de nombreuses variables, et vous permettent d'interroger des modèles climatiques et d'ensemble. Notre gamme complète de données météorologiques représente environ 15 PetaBytes et s'accroît chaque jour !

Si vous n'êtes pas convaincu des avantages d'un compte Business, vous pouvez l'essayer gratuitement pendant 14 jours grâce à notre essai gratuit. La seule chose qui n'est pas incluse est notre gamme complète de données historiques, pour laquelle vous êtes limité à six mois. Pour le reste, l'essai gratuit comprend tous les avantages que vous pouvez attendre d'un compte Business, et la seule limitation est la période d'essai de deux semaines. Si vous avez envisagé de passer à la version supérieure, c'est l'occasion idéale pour vous d'essayer !