Direkte eksport av data
Det er mulig å hente ut klimaguiden.nos data direkte på flere måter. Dette kan være nyttig dersom du ønsker å lage din egen import av dataene, eller for eksempel bruke dem i et regnerark eller ligndende. Her finnes en beskrivelse av tilgjengelige formater og metoder for uthenting av data.
CSV - Komma-separerte verdier
CSV er et enkelt format der dataene presenteres i en flat tekstfil med en linje pr innslag, og de forskjellige verdiene skilt med komma. Dette formatet er enkelt å håndtere. Dete formatet kan også brukes til import til for eksempel excel eller andre programmer.
CSV-data finnes med tegnsett utf-8 for maksimal interoperabilitet (standard) men kan også hentes ut som ISO-8859-1 (western latin1). Standard listing viser alle data i databasen, men datautvalget kan begrenses.
Adresse til CSV-data:
http://www.klimaguiden.no/eksport/csv.php
Aksepterte parametre:
q (string/int) : Begrenser utvalg.
En tekststreng her vil føre til et søk etter gitt tekst i varenavn og varekategorier.
charset (string) : Sett tegnsett
Dersom denne settes til "iso-8859-1" vil resultatet være med tegnsett ISO-8859-1 (western latin1) i stedet for standard tegnsett utf8. Dette kan være en fordel dersom du har problemer med norske tegn ved import til for eksempel excel.
CSV-eksempler:
List alt:
http://www.klimaguiden.no/eksport/csv.php
Søk etter varer med stikkord "mat" og "energi":
http://www.klimaguiden.no/eksport/csv.php?q=mat
http://www.klimaguiden.no/eksport/csv.php?q=engergi
Overfor nevnte eksempler med tegnsett ISO-8859-1:
http://www.klimaguiden.no/eksport/csv.php?charset=iso-8859-1
http://www.klimaguiden.no/eksport/csv.php?q=engergi&charset=iso-8859-1
XML
XML er et standardformat der dataene presenteres i strukturert form. Det finnes mange verktøy og systemer som kan importere og behandle XML.
XML-data finnes med tegnsett utf-8 for maksimal interoperabilitet (standard) men kan også hentes ut som ISO-8859-1 (western latin1). Standard listing viser alle data i databasen, men datautvalget kan begrenses.
Adresse til XML-data:
http://www.klimaguiden.no/eksport/xml.php
Aksepterte parametre:
q (string/int) : Begrenser utvalg.
En tekststreng her vil føre til et søk etter gitt tekst i varenavn og varekategorier.
charset (string) : Sett tegnsett
Dersom denne settes til "iso-8859-1" vil resultatet være med tegnsett ISO-8859-1 (western latin1) i stedet for standard tegnsett utf8. Dette kan være en fordel dersom du har problemer med norske tegn ved import til for eksempel excel.
xml-eksempler:
List alt:
http://www.klimaguiden.no/eksport/xml.php
Søk etter varer med stikkord "mat" og "energi":
http://www.klimaguiden.no/eksport/xml.php?q=mat
http://www.klimaguiden.no/eksport/xml.php?q=engergi
Overfor nevnte eksempler med tegnsett ISO-8859-1:
http://www.klimaguiden.no/eksport/xml.php?charset=iso-8859-1
http://www.klimaguiden.no/eksport/xml.php?q=engergi&charset=iso-8859-1
JSON - data for direkte bruk i JavaScript
Dette er formatet klimaguiden.nos egen JavaScript-widget bruker. JSON er et format laget spesielt for direkte datautveksling med javascript. Formatet er dermed ikke nyttig med mindre du ønsker å lage din egen JavaScript-applikasjon som skal bruke data fra klimaguiden.no direkte.
JSON-data finnes med tegnsett utf-8 og iso-8859-1. Datautvalg må foretas.
JSON-definisjon for klimaguiden.no:
Resultatet leveres i et object, med følgende nøkler:
"query" søketeksten som ble benyttet
"error" kun til stede om det har skjedd en feil, et søk uten resultat gir ikke error, men et tomt array.
"resultset" et array med produkter, hvor hvert produkt ijen er et objekt som holder nøkkel:verdi for informasjonen som finnes på hvert produkt (alle nøkler i lowercase)
Adresse til JSON-data:
http://www.klimaguiden.no/eksport/utf-8/json.php (utf-8)
http://www.klimaguiden.no/eksport/utf-8/json.php (iso-8859-1)
Aksepterte parametre:
q (string/int) : Begrenser utvalg.
En tekststreng her vil føre til et søk etter gitt tekst i varenavn og varekategorier. Denne variabelen er påkrevet.
callback (string) : Optional callback-variabel
Setter navnet på en callback-funksjon som legges rundt JSON strengen. Dette for at den dynamiske script-tagen som skrives av widgeten skal kunne sende JSON-dataene tilbake til widgeten.
debug (bool) : Enable debug output
Dersom debug settes til true vises JSON-dataene på en form som er lettere å lese for mennesker, denne kan ikke brukes for direkte import.
JSON-eksempler:
Søk etter varer med stikkord "mat" og "energi":
http://www.klimaguiden.no/eksport/utf-8/json.php?q=mat
http://www.klimaguiden.no/eksport/utf-8/json.php?q=engergi
Vis detaljer for vare med id 39:
http://www.klimaguiden.no/eksport/utf-8/json.php?q=39
Søk etter varer med stikkord "elektrisitet" og legg rundt callback-funksjon:
http://www.klimaguiden.no/eksport/utf-8/json.php?q=avis&callback=_kgw.callBack
Overfor nevnte eksempler på menneskelig lesbar form:
http://www.klimaguiden.no/eksport/utf-8/json.php?q=mat&debug=true
http://www.klimaguiden.no/eksport/utf-8/json.php?q=avis&callback=_kgw.callBack&debug=true
Ressurser:
Mer om JSON på www.json.org