Vanliga frågor om SLU Artdatabankens API:er

Sidan granskad:  2025-04-29

Här hittar du svar om till exempel skillnader mellan API:er, sökning i listor, referensnummer, maxgräns och hantering av tidsangivelser.

 

Vilka är skillnaderna mellan API:et för artobservationer från flera dataset och API:et för särskild Artportalen-funktionalitet?

Båda alternativen hämtar data ur Artportalen, men en del viktiga skillnader finns. Här nedan listas de viktigaste.

API för artobservationer från flera dataset

  • Hämta och söka bland flertalet olika dataset för artobservationsdata, däribland Artportalen
  • Öppet API, godkännande krävs ej
  • Snabbt, bra prestanda
  • Dyntaxa taxon Service API behövs som stöd för sökningar

API för särskild Artportalen-funktionalitet (även kallat ”befintligt API”)

  • Hämta och söka i Artportalens databas
  • Ej öppet API. Mycket begränsad användning. Godkännande krävs.
  • Möjlighet till utökad sökning och funktionalitet som är specifikt för Artportalen
  • Har inbyggt stöd för Artportalens egen anpassade taxonomi. Denna taxonomi gör det lättare för användarna att rapportera på rätt taxon.

Vi rekommenderar API:et för artobservationer från flera datakällor (Species Observations – multiple data resources) för att söka i Artportalens databas om det täcker in de behov du har, då det API:et är öppet och har bättre prestanda.

Läs mer om de olika API:erna

  • Om API:et för artobservationsdata från flera dataset
  • Om API:et för särskild Artportalen-funktionalitet

 

Jag vill söka observationer för arter på olika naturvårdslistor - vilka listor finns och kan de användas för att söka observationer med API:erna?

Det går att hämta naturvårdslistor för t.ex. rödlistade arter, fridlysta arter och habitatdirektivsarter, genom att använda API:et för naturvårdslistor, Taxon List Service API.

API:et för naturvårdslistor kan användas tillsammans med API:et för artobservationer från flera dataset för att söka efter artobservationer för arter på dessa listor.
API:er för särskild Artportalen-funktionalitet har egna kopior av de flesta av naturvårdslistorna.
Vill man söka efter observationer för ett eget urval av arter kan man göra det genom att använda API:et för artobservationer från flera dataset. API:et har stöd för att använda en egen lista av taxon-id nummer (Dyntaxa taxon identifierare).

 

Jag vill kunna referera till en specifik utsökt datamängd av artobservationer, t.ex. när jag använder data i en rapport. Kan jag få ett referensnummer?

Det finns för närvarande inget stöd för detta, men det är planerat att implementeras under 2025 eller 2026.

Hur många fynd kan jag hämta?

API:et för artobservationer från flera dataset har stöd för att kunna hämta 10 000 artobservationer i ett anrop, men det är möjligt att hämta fler observationer på olika sätt: En observationssökning är idag begränsad till att returnera högst 10 000 observationer av prestandaskäl. Det är dock möjligt att fråga API:et om antalet observationer som finns i databasen för en specifik sökning och sedan dela upp sökningen i flera frågor om det skulle visa sig att antalet observationer i resultatet överskrider maxgränsen. Vill man ha fler än 10 000 observationer erbjuder API:et exporter i formaten: Excel, CSV, GeoJSON och Darwin Core Archive-format på upp till två miljoner observationer via API:et.

API:er för särskild Artportalen-funktionalitet har stöd för att hämta 50 (default) – 200 (max) fynd i ett anrop. Vill man ha fler kan man skicka fler anrop och anger ett offset värde, där man får fynd 1-200 för offset=0, fynd 201-400 för offset=2, osv.

 

Hur hanteras tidsangivelser för artobservationer?

API:erna returnerar svensk tid (UTC-tid + tidszon).

Jag vill få en lista över vilka taxa som har tillkommit i Dyntaxa det senaste året. Hur skapar jag den?

Via Dyntaxa Taxon Service API finns möjlighet att filtrera fram vilka taxonID som har skapats i Dyntaxa under en viss tidsperiod och/eller i en viss taxonomisk grupp. Läs mer här [ länk till https://www.slu.se/artdatabanken/rapportering-och-fynddata/oppna-data-och-apier/om-artdatabankens-apier/apier-for-taxonomisk-information/ ]

WFS och WMS

Ny WFS-tjänst ersätter gamla WMS och WFS-tjänster

Publicerad: 23 september 2022

Från 15 oktober fasas våra gamla WMS- och WFS-tjänster ut för att stängas ner vid årsskiftet 2022/2023. För den som ännu inte har bytt till den nya WFS-tjänsten för artobservationer är det hög tid att göra det nu.

SLU Artdatabankens nya WFS-tjänst tillåter dig att hämta in artobservationer direkt till ditt eget GIS-program. Du kan också använda tjänsterna för att göra direktanrop i din webbläsare utan att gå via ett GIS-program. WFS är en internationell standard för åtkomst av data via internet, som publicerar geografisk information i vektorformat. 

WFS-tjänsten är kopplad mot vårt API för artobservationer från flera datakällor (Species Observation System API) från ett flertal olika dataleverantörer. Datainnehåll, databasernas uppbyggnad och deras syfte kan skilja sig åt, men omvandlas till ett gemensamt format med minsta gemensamma nämnare i vårt Species Observation System. Liksom den gamla WFS-tjänsten kan den nya inte hantera skyddade fynd. Skyddade fynd kommer man för närvarande bara åt om man har behörighet för detta. Dokumentation för tjänsten: https://github.com/biodiversitydata-se/SOS/blob/master/Docs/WfsService.md 

Våra gamla WMS- och WFS-tjänster, som fram till 2020  drevs av Svenska LifeWatch (SLW), bygger på föråldrad teknik och har en rad problem som inte har kunnat åtgärdas. De stängs nu ned. Vi hänvisar därför till att övergå till den nya WFS-tjänsten så snart som möjligt för att få tillgång till aktuell och komplett data från våra datakällor. 

Fotnot: WMS (Web Map Service) är en visningstjänst och WFS (Web Feature Service) är en tjänst för direktåtkomst.

WFS-tjänst för artobservation

Publicerad: 17 juni 2022

Via API:et Species Observation System finns nu en WFS-tjänst (Web Feature Service) som blir ytterligare ett sätt att hämta och använda artobservationsdata.

SLU Artdatabankens nya WFS-tjänst (Web Feature Service) tillåter dig att hämta in artobservationer direkt till ditt eget GIS-program. Du kan också använda tjänsterna för att göra direktanrop i din webbläsare utan att gå via ett GIS-program. WFS är en internationell standard för åtkomst av data via internet, den publicerar geografisk information i vektorformat.

WFS-tjänsten är kopplad mot vårt API för artobservationer från flera datakällor (Species Observation System API) från ett flertal olika dataleverantörer. Datainnehåll, databasernas uppbyggnad och deras syfte kan skilja sig åt, men omvandlas till ett gemensamt format med minsta gemensamma nämnare i vårt Species Observation System. Den nya WFS-tjänsten kommer att ersätta nuvarande SLW WFS-tjänst som vi planerar att avveckla vid årsskiftet 2022-23.

Liksom den nuvarande SLW WFS-tjänsten kan den nya inte hantera skyddade fynd. Skyddade fynd kommer man av säkerhetsskäl bara åt direkt via API:et och om man har behörighet.

Dokumentation för tjänsten: https://github.com/biodiversitydata-se/SOS/blob/master/Docs/WfsService.md

OM man vill utveckla egna applikationer kan man också gå direkt mot vårt API för artobservationer från flera datakällor (Species Observation System API).

 

 

Länkar

 

Kontakt

För frågor och ärenden gällande SLU Artdatabankens API:er, använd kontaktformuläret för API:er.