UGC-hubben (användargenererat innehåll)

K-samsök har en tjänst för sk användargenererat innehåll (på engelska: ”user-generated content” eller UGC) där användare kan bidra själv med semantiska länkar. Länkarna kan vara mellan objekt inom K-samsök – t ex påståenden om att ett foto avbildar en lämning – eller till externa objekt hos Libris, Wikipedia, Wikimedia Commons, eller Europeana.

UGC-hubben nås enklast via Kringla för inloggade användare, och via ett eget API för UGC-datat.

UGC-hubben i Kringla

I Kringla kan du koppla ihop olika objekt (t ex ett foto eller föremål) och dessutom välja hur de hänger ihop. Denna betydelsebärande länkning kallar vi för ”relationer”. Nedan följer en lista på de relationer som finns och en förklaring kring hur de används på bästa sätt. Det finns fler relationstyper men vi har valt att begränsa mängden inledningsvis.

Just nu kan du bara skapa länkar till andra objekt i K-samsök, Europeana, Libris, Wikipedia och Wikimedia Commons.

Skapar du en relation mellan två objekt kommer det automatiskt att skapas en relation åt andra hållet, dvs länkar du ihop bilden som avbildar kyrkan (enligt exemplet nedan) så kommer det att finnas en länk tillbaka mellan kyrkan som avbildas av bilden.

Avbildar
Denna relation använder du om du vill länka ihop t ex ett foto (exempel) eller en teckning med en byggnad (t ex denna, Visby domkyrka), dvs fotot avbildar kyrkan. Relationen används när du skapar länken och befinner dig på fotots sida.
Avbildas av
Denna relation används när du vill länka åt andra hållet, dvs du befinner dig på byggnadens sida och vill länka den till det foto som avbilder kyrkan, dvs kyrkan avbildas av fotot.
Består av
Denna relation används t ex när du har en samling eller ett föremål som består av flera delar (t ex denna samurajrustning) och vill länka ihop den med de delar som rustningen består av, t ex hjälmen. Relationen används när du befinner dig på rustningens sida, rustningen består av flera delar.
Är en del av
Denna relation används när du när du vill länka åt andra hållet, dvs du befinner dig på rustningsdelens/hjälmens sida och vill länka till hela rustningen, hjälmen är en del av rustningen.
Samma som
Denna relation använder du om två olika objekt beskriver samma sak, t ex två objekt som beskriver Gustav Vasa. Denna Gustav Vasa är samma som denna Gustav Vasa. OBS: Relationen bör inte användas för att t ex koppla ihop två foton som avbildar samma sak (t ex en kyrka). Använd i sådant fall avbildar och avbildas av istället.
Beskrivs av
Denna relation använder du om du om du befinner dig på t ex ett föremåls sida som beskrivs av ett dokument eller annan text.

UGC-hubbens API

Det finns ett API för att få ut semantiska länkar från UGC-hubben på ett strukturerat, maskinläsbart sätt.

Här är några exempel på hur API:et kan användas. Svaren levereras per default i XML-format; om svar önskas i JSON-format, lägg till &format=json i query-strängen. Flera av exemplen innehåller maxCount=5; man kan ändra detta till det maxantal träffar du vill hämta.

Retrieve (använd all som scope för att hämta alla relaterade objekt för denna objectUri):
http://ugc.kulturarvsdata.se/UGC-hub/api?x-api=ex2147ap36&method=retrieve&scope=all&maxCount=5&objectUri=http://kulturarvsdata.se/raa/fmi/10048200010001
Retrieve (hämta objekt inom ett spann):
http://ugc.kulturarvsdata.se/UGC-hub/api?x-api=ex2147ap36&method=retrieve&scope=all&selectFrom=10&maxCount=5&objectUri=all
Retrieve (hämta alla objekt):
http://ugc.kulturarvsdata.se/UGC-hub/api?x-api=ex2147ap36&method=retrieve&scope=all&objectUri=all
Retrieve (hämta totala antalet objekt):
http://ugc.kulturarvsdata.se/UGC-hub/api?x-api=ex2147ap36&method=retrieve&scope=count&objectUri=all
Retrieve (hämta objekt på objektets id):
http://ugc.kulturarvsdata.se/UGC-hub/api?x-api=ex2147ap36&method=retrieve&objectUri=all&contentId=2089464&scope=single