Baliabideak

1.- ALDERDI TEKNIKOAK: XML, JSON ETA DATA FORMATUAK

Formatu horietan eskuragarri dauden datu-multzoak identifika daitezke datuen katalogoan deskribapenaren azpian agertzen diren formatu-etiketen bidez. Datuak deskargatu nahi izanez gero, datu-multzora joan behar da eta, ondoren, "Arakatu" botoian klik egin eta deskargatzeko formatua hautatu.

Nafarroako Gobernuaren datu irekien plataforma berrian, XML, JSON eta data formatuen egitura ez da lehenagoko atarian zutenaren berdina.
 
XML:
Lehen, XML dokumentuen hasierako etiketa <OpenData> zen; orain, berriz, <data> da. Gainera, errenkadaren <OpenData> etiketaren ordez, <row _id=" "> erabiltzen da orain, errenkadaren zenbakia adierazteko.
Iturria: Osasun-zentroei buruzko XML dokumentuaren irudia, Nafarroako Datu Irekien ataritik hartua
 
JSON:
Gaur egun, egiturak bi bloke ditu: batetik, fields blokea, eremuaren identifikatzailea eta biltzen dituen datuen mota jasotzen dituena, eta, bestetik, records blokea, eremu bakoitzaren balioak errenkadaka jasotzen dituena.
Iturria: Osasun-zentroei buruzko JSON dokumentuaren irudia, Nafarroako Datu Irekien ataritik hartua

 
DATAK:
Lehenetsitako data formatua testu formatua da eta, berez, formatu horretan ematen dira datak. Halere, gerta daiteke dataset jakin batzuetan aldatuta egotea eta, halakoetan, “timestamp” data formatuan ematen dira datak, "AAAA-MM-DDTHH:MM:SS" moduan.
 
2.- API datuak deskargatzeko

Datu-baliabideetarako sarbidea, kontsulta-zerbitzu osoa duen API web baten bidez. Atal honek datuak irakurri, bilatu eta iragazteko API bat eskaintzen du, fitxategi osoa deskargatu beharrik gabe. Baliabideak datu-base batean daude, eta, horri esker, baliabide bat bila dezakezu, bai eta baliabide horiei buruzko kontsultak egin ere.

Datuen APIa honako ekintza hauen bidez eskura daiteke:
  • Kontsulta: https://datosabiertos.navarra.es/es/api/3/action/datastore_search?IDrecurso
  • Kontsulta (SQL bidez): https://datosabiertos.navarra.es/es/api/3/action/datastore_search_sql=Select
 
Lehenengo bost emaitzen adibidea kontsultatzea:
https://datosabiertos.navarra.es/es/api/3/action/datastore_search?resource_id=ID_RECURSO&limit=5
Kontsultatu "jonak" dituzten emaitzen adibidea:
https://datosabiertos.navarra.es/es/api/3/action/datastore_search?q=jones&resource_id=ID_RECURSO
Kontsulta adibidea SQL epaiaren bidez
https://datosabiertos.navarra.es/es/api/3/action/datastore_search_sql?sql=SELECT * from "c736f9a3-3efc-4b89-9d31-ef859607bc27" WHERE title LIKE 'jones'
 
Adibidea Javascript:

Una simple consulta ajax (JSONP) a la data API usando jQuery.
        var data = {
          resource_id: 'ID_RECURSO', // the resource id
          limit: 5, // get 5 results
          q: 'jones' // query for 'jones'
        };
        $.ajax({
          url: 'https://datosabiertos.navarra.es/es/api/3/action/datastore_search',
          data: data,
          dataType: 'jsonp',
          success: function(data) {
            alert('Total results found: ' + data.result.total)
          }
        });
 
Adibidea Python:

      import urllib
      url = 'https://datosabiertos.navarra.es/es/api/3/action/datastore_search?resource_id=ID_RECURSO&limit=5&q=title:jones' 
      fileobj = urllib.urlopen(url)
      print fileobj.read()
     
 

3.- APIa, geoerreferentziatutako datuak web aplikazioetan ikusteko


Web aplikazio eta orrietan mapa bisore interaktiboak sartzeko aukera ematen duen JavaScript API bat da, eta hortaz, informazio geoerreferentziatuaren irudikapenerako aukera ematen du.
Nafarroako Gobernuko web aplikazioetan erabiltzeko garatutako produktu bat da, baina edozein erabiltzailek edo erakundek erabil dezake bere web orrietan.

APIaren egungo bertsioa:
  • Mapa bisoreetan nabigatzeko ohizko funtzioak eskaintzen ditu. Esaterako, gerturatzea eta urrutiratzea, egoera mapa eta neurtzeko tresnak.
  • Nafarroako udalerri bat bere izenez edota puntu bat bere koordenatuez bilatzeko aukera ematen du.
  • Konfigurazio lehenetsiarekin, modu erraz batez Nafarroako oinarrizko mapa bat sortzeko aukera ematen du, erabilera arrunteko tresnekin eta Idenaren hondoko lau maparekin, zehazki: 2012ko ortofotoa, oinarrizko mapa, kartografia topografikoa eta katastroa.
  • WMS eta WMTS zerbitzuak erabiliz informazio geografikoa gehitzeko aukera ematen du.
  • Erlazionatutako informazioarekin markatzaile puntualak sortzeko bide ematen du.
  • KLM fitxategi batetik informazio geografikoa gehitu daiteke.
 
Datu geoerreferentziatuen bisorearen edo APIren konfigurazio lehenetsiarekin lortzen den oinarrizko maparen itxura hau da.




APIa hirugarren batzuen JavaScript liburutegietan oinarrituta dago, baina erabat eduki guztiak barnean ditu, eta orrian APIaren scripta gehitze hutsarekin beharrezkoak diren baliabideak dinamikoki eransten dira.  Helburua izan da GIS ezagutza handirik ez duen garatzaileei APIaren erabilera erraztea.

APIa ulertzen laguntzeko, dokumentazioa eta adibideak  helbide honetan daude.