PIA » API

API

v0.5 - 2021/09/03

API - Dades predicció de pòl·lens i espores al·lergògens a Catalunya i Balears

Aquesta API permet l'accés a les dades de la predicció de la setmana (actual) de pòl·lens i espores al·lergògens a Catalunya i Balears, disponibles públicament a: https://aerobiologia.cat/pia/ca/forecast/catalunya, i https://aerobiologia.cat/pia/ca/forecast/balears

La informació inclou:

  • Noms de tàxons presents a la predicció.
  • Llegenda de la predicció.
  • Informació sobre l'estació aerobiològica.
  • Data de la predicció (inici, final).
  • Valors de nivells actuals.
  • Valors de predicció.

NOTA: Les prediccions de Catalunya i de Balears es fan de manera separada. En una determinada setmana, els tàxons presents a la predicció podrien ser diferents entre la predicció de Catalunya i la predicció de Balears. El format de la API no varia, sempre és el mateix.

Llicència i condicions d'ús

https://aerobiologia.cat/pia/ca/terms

RESUM:

  • Llicència: CC BY-NC-SA 4.0
  • Reconeixement: Incloure un enllaç a la pàgina web del PIA, allà on es mostra la informació de la predicció, si el teu disseny ho permet. O d'altra manera, a un lloc dedicat a reconèixer l'autoria.
  • Si fas ús de les nostres dades al teu projecte, et demanem que ens ho facis saber a [email protected]. Per poder mostrar que les dades que el PIA produeix són útils per la societat, i poder continuar produint aquestes dades.
  • Per usos de les dades de prediccions, més enllà de la llicència CC BY-NC-SA 4.0, usos de les dades reals de pòl·lens i espores, etc estem oberts a arribar a acords de col·laboració. Posat en contacte amb nosaltres: [email protected]

Format

XML

Ús i paràmetres

Web API URL: https://aerobiologia.cat/api/v0/forecast/[locality]/[lang]/xml

  • [locality] és una de següents opcions: "barcelona", "bellaterra", "girona", "lleida", "manresa", "roquetes", "tarragona", "vielha", "son", "inca"
    o
    "catalunya" per totes les estacions de Catalunya
    o
    "balears" per totes les estacions de Balears (actualment només existeix una estació, Inca/Mallorca)
  • [lang] és una de les següents opcions: "ca", "es" o "en" (la absència del paràmetre, retorna per defecte en català)

Exemples

Roadmap

  • Consulta a partir de coordenades geogràfiques (com a alternativa a nom de localitat).

Feedback

Per problemes, comentaris, dubtes, suggeriments, peticions, etc relacionats amb la API, envia'ns un missatge a [email protected]