Service de carte

Le service retourne des cartes de données d’une variable à une échéance pour un dataset donné.

Dépendances côté serveur

  • Python (3.7, 3.8, 3.9)

  • Django (3.0, 3.1)

  • Django REST Framework (3.10, 3.11, 3.12)

  • Matplotlib library (1.9)

  • Numpy (1.19)

  • ARIA library (1.2.27) - ariapy à partir d’ARIA Gitlab repository

Usage

GET /maps/(int: zoom)/(int: tx)/(int: ty)?
Query Parameters

  • dataset – nom du dataset

  • variable – nom du variable (tsmax, tsmin, rr, …)

  • date – la date de l’échéance au format AAAAMMJJ

  • time – l’échéance au format ISO AAAA-MM-JJTHH:MM:SS

  • format – le format de la réponse (png, json)

  • modifier – le type de données (avg, ano)

  • timeavg – la méthode de moyennage (year, month)

  • stat – la méthode de statistiques (mean, q10, q90, score)

Request Headers

  • Accept – Le type du contenu de la réponse accepté: application/json

  • Authorization – Le mécanisme d’authentification par Token

Response Headers

  • Content-Type – Le type du contenu de la réponse: application/json

Status Codes

Le service GET comprend trois paramètres dans le chemin de l’URL: int: zoom, tx and ty. Les paramètres tx, ty sont les coordonnées du tule Google. Le paramètre zoom est le niveau zoom du système des coordonnées de tuile Google. La réponse est une image au format png qui représente une carte colorée en 2D des valeurs d’une variable.

Exemple d’une requête:

GET /maps/6/33/25/?format=json&dataset=INMCLIMAT_RCP45&variable=CDD&time=1995-10-30T00:00:00&date=19900801&modifier=avg&timeavg=year&stat=mean HTTP/1.1
Host: apibeta.aria.fr/py/v2
Accept: image/png

Exemple d’une réponse:

HTTP/1.1 200 OK
Allow: GET, HEAD, OPTIONS
Vary: Accept
Content-Type: image/png
_images/rcp45_cdd_6_33_25.png

CDD, la carte d’un nombre de jours consécutifs secs centrée à l’année 1990 pour le tuile Google (z=6, x=33, y=25)