Il feed RSS migliore di sempre

Quello per sapere quando un dataset ISTAT viene aggiornato

Originally published at blog.ondata.it.

Una premessa sui web service di ISTAT

L’ISTAT pubblica i propri dati (anche) tramite web service SDMX (Statistical Data and Metadata eXchange). È un servizio interrogabile che restituisce in output delle strutture XML, secondo il formato omonimo (è uno standard ISO).

<item>
<title>Indici dei costi di costruzione - dati mensili</title>
<pubDate>2018-01-18T10:12:40 AM</pubDate>
<guid>145_361</guid>
<content:encoded>
<![CDATA[
<?xml version="1.0" encoding="iso-8859-1"?><QueryMessage
xmlns="http://www.SDMX.org/resources/SDMXML/schemas/v2_0/message"
xmlns:query="http://www.SDMX.org/resources/SDMXML/schemas/v2_0/query"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:schemaLocation="http://www.SDMX.org/resources/SDMXML/schemas/v2_0/message SDMXMessage.xsd"><Header><ID>145_361</ID><Test>false</Test><Name xml:lang="en">Indici dei costi di costruzione - dati mensili</Name><Prepared>2018-01-20</Prepared><Sender id="IT1" /><Receiver id="4D0" /></Header><Query><query:DataWhere><query:And><query:Time><query:StartTime>2017</query:StartTime><query:EndTime>2017</query:EndTime></query:Time><query:Dataflow>145_361</query:Dataflow></query:And></query:DataWhere></Query></QueryMessage>]]>
</content:encoded>
</item>

L’accesso tramite API

Ai dati del warehouse di ISTAT si può accedere anche tramite API. Ce l’ha ben descritto Vincenzo Patruno (che lavora a ISTAT) in questo post (leggetelo è interessante e utile).
Averlo tra i soci di onData, ci ha consentito di fargli più agilmente qualche domanda su queste API (le ha fra l’altro sviluppate lui).

{
"accesslevel": "public",
"landingPage": "http://dati.istat.it/Index.aspx?DataSetCode=DCSC_FABBRESID_1&Lang=it",
"issued": "",
"@type": "dcat:Dataset",
"modified": "",
"keyword": [],
"contactPoint": {
"@type": "vcard:Contact",
"fn": "<Nobody>",
"hasEmail": ""
},
"publisher": {
"@type": "org:Organization",
"Name": "Istat"
},
"identifier": "http://dati.istat.it/Index.aspx?DataSetCode=DCSC_FABBRESID_1&Lang=it",
"description": "",
"title": "Indici dei costi di costruzione - dati mensili ",
"distribution": [
{
"@type": "dcat:Distribution",
"downloadURL": "http://dati.istat.it/Index.aspx?DataSetCode=DCSC_FABBRESID_1&Lang=it",
"mediaType": "text/html"
}
],
"licence": "CC-BY 4.0",
"theme": [
"Prezzi"
]
}
  • il catalogo delle risorse esposto via API contiene l’URL per risalire alla pagina della risorsa.
  • da questi estrae titoli e date degli elementi pubblicati;
  • scarica il catalogo dati esposto via API;
  • da questo estrae titoli e identificatore del dataset (nel caso di sopra è DCSC_FABBRESID_1)
  • fa il JOIN via “titolo” e crea un unica risorsa che contiene titolo, URL della pagina del dataset e data di pubblicazione;
  • sfrutta questa risorsa per creare il feed RSS.

Cosa c’è nel feed

L’output di base è quello sottostante. Al titolo, al link, e alla data di pubblicazione sono stati aggiunti alcuni elementi aggiuntivi:

  • a livello di <item>
  • l’identifier di ogni dataset;
  • una <description> con l’endpoint che consente di identificare le “dimensioni” che compongono ciascun dataset.
<?xml version="1.0" encoding="utf-8"?>
<rss
xmlns:atom="http://www.w3.org/2005/Atom"
xmlns:creativeCommons="http://backend.userland.com/creativeCommonsRssModule" version="2.0">
<channel>
<language>it</language>
<title>ISTAT - Aggiornamento dataset del data warehouse I.Stat | Non ufficiale</title>
<description>Un RSS costruito a partire dai web service SDMX e dalle API di ISTAT</description>
<link>http://dev.ondata.it/projs/istatDataRSS/feed.xml</link>
<atom:link rel="self" href="http://dev.ondata.it/projs/istatDataRSS/feed.xml" type="application/rss+xml"/>
<docs>https://medium.com/@vincpatruno/come-accedere-ai-dati-statistici-pubblicati-dallistituto-nazionale-di-statistica-istat-ca874316f5a9</docs>
<creativeCommons:license>http://creativecommons.org/licenses/by-sa/4.0/</creativeCommons:license>
<item>
<title>Indici dei costi di costruzione - dati mensili</title>
<link>http://dati.istat.it/Index.aspx?DataSetCode=DCSC_FABBRESID_1&amp;Lang=it</link>
<pubDate>Thu, 18 Jan 2018 10:12:40 +0100</pubDate>
<description>DATA URI: http://apistat.istat.it/?q=getdim&amp;dataset=DCSC_FABBRESID_1&amp;lang=0</description>
<guid>http://dati.istat.it/Index.aspx?DataSetCode=DCSC_FABBRESID_1&amp;Lang=it</guid>
<category domain="http://apistat.istat.it/specs#identifier">DCSC_FABBRESID_1</category>
</item>
</channel>
</rss>

Come usare il feed RSS

I feed RSS sono basati su uno vecchio e buon standard, quindi esistono centinaia di modalità per leggerli, adatti a qualsiasi tipo di utente.
Vi potrete “iscrivere” con un lettore dedicato, attivare delle notifiche automatiche via email magari filtrate su una parola chiave (con strumenti come IFTTT), scrivere del codice per produrre nuovi output, ecc..

Nota finale “personale”

Lo stimolo che ci ha portato alla scoperta e all’approfondimento di queste risorse nasce da questo messaggio di Alice Corona e da questo stimolo di Andria Tzedda. Ringraziamo entrambi 🙏

#data #maps #GIS #baci #condivisione. Orgoglioso di essere presidente di @ondatait

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store