info.laji.fi

Lajitietokeskuksen ohje- ja tietopankki

Sarakkeiden kuvaukset REST-rajapinnassa

Huom. Sarakkeiden nimitykset riippuvat käytetystä tiedostoformaatista. Esimerkiksi yksinkertaisessa taulukkolatauksessa on mukana vain ne kentät, jotka näkyvät selaimessakin. Lisäksi paikkatietoformaateissa tai API:n kautta hyödynnetyissä aineistoissa kentät ovat erit.

Sarakkeiden kuvaukset

Tiedoston sarakkeet on järjestetty kolmelle tasolle:

  1. Document (suom. havaintoerä): Sisältää metatietoa havainnosta. Yksi havaintoerä voi sisältää useita keruutapahtumia.
  2. Gathering (suom. keruutapahtuma): Sisältää keruutapahtumaan sisältyvää tietoa. Yksi keruutapahtuma voi sisältää useita havaintoja.
  3. Unit (suom. havainto): Sisältää yksittäisiin havaintoihin liittyvää informaatiota.

Seuraava taulukko sisältää sarakkeiden nimet, tyypit (string, int, boolean, or enum (= listamainen tietorakenne). Huom. rajapinta sisältää vielä lisää muuttujia, jotka löytää osoitteesta https://schema.laji.fi/.

SarakeKuvaus suomeksiTyyppiTulkittu?Esimerkit enum-arvoille
Unit.UnitIDhavainnon pysyvä tunnistestring
Unit.TaxonVerbatimKäyttäjän syöttämä tieteellinen nimistring
Unit.Quality.Issue.Issue(ei käytössä vielä)
Unit.Quality.Issue.Source(ei käytössä vielä)
Unit.Quality.Issue.Message(ei käytössä vielä)
Unit.Quality.Taxon.ReliabilityHavainnon laadun arviointienumRELIABLE, LIKELY, NEUTRAL, SUSPICIOUS, IMPOSSIBLE
Unit.Quality.Taxon.SourceHavainnon laadun arvioinnin lähdeenumCOLLECTION_QUALITY_RATING, USER_ANNOTATION, ORIGINAL_OBSERVER
Unit.Quality.Taxon.Message(ei käytössä vielä)
Unit.ReportedTaxonConfidenceHavainnon luotettavuus alkuperäisessä lähteessäenumSURE, UNSURE, SUBSPECIES_UNSURE
Taxon.IDTaksonin pysyvä tunnistestringTRUE
Taxon.ScientificNameTieteellinen nimistringTRUE
Taxon.FinnishNameSuomenkielinen nimistringTRUE
Taxon.EnglishNameEnglanninkielinen nimistringTRUE
Taxon.SwedishNameRuotsinkielinen nimistringTRUE
Taxon.TaxonomicOrderTaksonominen järjestyslukuintTRUE
Unit.NameAccordingTo(ei käytössä vielä)
Unit.AbundanceMäärän kuvausstring
Unit.Interpretations.AnnotatedTaxonIdTaksonin pysyvä tunniste, jos tunnistus on muuttunut annotaation perusteellastringTRUE
Unit.Interpretations.IndividualCountHavaintojen lukumäärä, tulkittu automaattisesti kohdasta Unit.AbundanceintTRUE
Unit.Interpretations.PairCount(ei käytössä vielä)
Unit.RecordBasisTietueen tyyppienumHUMAN_OBSERVATION_UNSPECIFIED, PRESERVED_SPECIMEN
Unit.DetailedRecordBasisYksityiskohtaisempi tietueen tyyppienum
Unit.TypeSpecimenOnko havainto tyyppinäyte?boolean
Unit.DetTunnistuksen tehnyt henkilö (Det). Vapaa teksti, yleensä Etunimi, Sukunimi.string
Unit.SexHavaintojen sukupuolienum
Unit.LifeStageHavaintojen elämänvaiheenum
Unit.WildOnko havainto villi vai ei?boolean
Unit.BreedingSiteOnko havaintoa pesimäpaikasta?boolean
Unit.IndividualID(ei käytössä vielä)
Unit.InvasiveControlTorjunta/hävitystoimenpiteet vieraslajeja vastaanenum
Unit.NotesHuomautukset havainnostastring
Unit.AnnotationCounthavainnosta tehtyjen kommenttien lukumääräint
Unit.MediaCountMediatiedostojen lukumäärä havainnossaint
Gathering.GatheringIDKeruutapahtuman pysyvä tunnistestring
Gathering.Quality.Issue.IssueKeruutapahtumaan liittyvät automaattisesti havaitut paikkatieto-ongelmatenumTRUECOORDINATES_MUNICIPALITY_MISMATCH, INVALID_YKJ_COORDINATES, TOO_LARGE_AREA
Gathering.Quality.Issue.SourceOngelmien lähde – missä puutteet on havaittuenumTRUEAUTOMATED_FINBIF_VALIDATION, ORIGINAL_DOCUMENT
Gathering.Quality.Issue.MessageKuvaus sijaintiongelmistastring
Gathering.Date.BeginKeruutapahtuman alkamispäivästring
Gathering.Date.EndKeruutapahtuman päättymispäivä. Jos loppupäivää ei ole annettu, tämä on sama kuin alkamispäivä.string
Gathering.HourBeginKeruutapahtuman alkamistuntiint
Gathering.HourEndKeruutapahtuman päättymistunti. Tyhjä, jos ei loppuaikaa.int
Gathering.DisplayDateTimeKeruutapahtuman aikaviite (päivämäärät ja ajat) merkkijononastringTRUE2019-08-02 [12:00] – 2019-08-04 [19:00]
Gathering.TeamMembersHavainnoijien luettelo, erotettuna puolipisteillä. Nimet vapaatekstiä, usein Etunimi, Sukunimi.string
Gathering.Conversions.WGS84.LatMin(N)Keruutapahtuman sijainnin rajauksen WGS84-koordinaatitdecimalTRUE
Gathering.Conversions.WGS84.LatMax(N)Keruutapahtuman sijainnin rajauksen WGS84-koordinaatitdecimalTRUE
Gathering.Conversions.WGS84.LonMin(E)Keruutapahtuman sijainnin rajauksen WGS84-koordinaatitdecimalTRUE
Gathering.Conversions.WGS84.LonMax(E)Keruutapahtuman sijainnin rajauksen WGS84-koordinaatitdecimalTRUE
Gathering.Conversions.WGS84CenterPoint.Lat(N)Keruutapahtuman sijainnin rajauksen keskipiste WGS84-koordinaattinadecimalTRUE
Gathering.Conversions.WGS84CenterPoint.Lon(E)Keruutapahtuman sijainnin rajauksen keskipiste WGS84-koordinaattinadecimalTRUE
Gathering.Conversions.YKJ.LatMin(N)Keruutapahtuman sijainnin rajauksen YKJ-koordinaatitintTRUE
Gathering.Conversions.YKJ.LatMax(N)Keruutapahtuman sijainnin rajauksen YKJ-koordinaatitintTRUE
Gathering.Conversions.YKJ.LonMin(E)Keruutapahtuman sijainnin rajauksen YKJ-koordinaatitintTRUE
Gathering.Conversions.YKJ.LonMax(E)Keruutapahtuman sijainnin rajauksen YKJ-koordinaatitintTRUE
Gathering.Conversions.EUREF.LatMin(N)Keruutapahtuman sijainnin rajauksen EUREF-TM35-FIN-koordinaatitintTRUE
Gathering.Conversions.EUREF.LatMax(N)Keruutapahtuman sijainnin rajauksen EUREF-TM35-FIN-koordinaatitintTRUE
Gathering.Conversions.EUREF.LonMin(E)Keruutapahtuman sijainnin rajauksen EUREF-TM35-FIN-koordinaatitintTRUE
Gathering.Conversions.EUREF.LonMax(E)Keruutapahtuman sijainnin rajauksen EUREF-TM35-FIN-koordinaatitintTRUE
Gathering.Conversions.YKJ_10KM.Lat(N)Keruutapahtuman sijainnin rajauksen koordinaatti YKJ:n 10 km x 10 km ruudussa.intTRUE
Gathering.Conversions.YKJ_10KM.Lon(E)Keruutapahtuman sijainnin rajauksen koordinaatti YKJ:n 10 km x 10 km ruudussa.intTRUE
Gathering.Conversions.YKJ_1KM.Lat(N)Keruutapahtuman sijainnin rajauksen koordinaatti YKJ:n 1 km x 1 km ruudussa.intTRUE
Gathering.Conversions.YKJ_1KM.Lon(E)Keruutapahtuman sijainnin rajauksen koordinaatti YKJ:n 1 km x 1 km ruudussa.intTRUE
Gathering.Conversions.CenturyKeruutapahtuman vuosisata. Tyhjä, jos useita.intTRUE
Gathering.Conversions.DecadeKeruutapahtuman vuosikymmen. Tyhjä, jos useita.intTRUE
Gathering.Conversions.YearKeruutapahtuman vuosi. Tyhjä, jos useita.intTRUE
Gathering.Conversions.MonthKeruutapahtuman kuukausi. Tyhjä, jos useita.intTRUE
Gathering.Conversions.DayKeruutapahtuman päivä. Tyhjä, jos useita.intTRUE
Gathering.Conversions.DayOfYearBeginKeruutapahtuman alkamispäivä vuoden päivänä.intTRUE
Gathering.Conversions.DayOfYearEndKeruutapahtuman loppupäivä vuoden päivänä.intTRUE
Gathering.Interpretations.CoordinateAccuracyKoordinaattitarkkuuden arvio metreinäintTRUE
Gathering.Interpretations.CoordinateSourceKoordinaattien lähde.enumTRUEREPORTED_VALUE, FINNISH_MUNICIPALITY
Gathering.Interpretations.CountryMaastringTRUE
Gathering.Interpretations.BioprovinceEliömaakuntastringTRUE
Gathering.Interpretations.MunicipalityKuntastringTRUE
Gathering.Interpretations.CountrySourceMaan nimen lähdestringTRUEREPORTED_VALUE, COORDINATES, COORDINATE_CENTERPOINT
Gathering.Interpretations.BioProvinceSourceEliömaakunnan nimen lähdestringTRUE
Gathering.Interpretations.MunicipalitySourceKunnan nimen lähdestringTRUE
Gathering.HigherGeographyVerbatimSanatarkka nimi alkuperäislähteestä maata ylemmälle alueellestring
Gathering.CountryVerbatimSanatarkka maa nimi alkuperäislähteestästring
Gathering.MunicipalityVerbatimSanatarkka kunta nimi alkuperäislähteestästring
Gathering.BioProvinceVerbatimSanatarkka eliömaakunta nimi alkuperäislähteestästring
Gathering.ProvinceVerbatimSanatarkka hallintoalueen nimi alkuperäislähteestästring
Gathering.LocalityVerbatimSanatarkka paikkakunnan nimi alkuperäislähteestästring
Gathering.NotesHuomautuksia keruutapahtumastastring
Gathering.MediaCountMediatiedostojen lukumäärä keruutapahtumassaint
Document.DocumentIDHavaintoerään sisältyvän tallenteen pysyvä tunnistestring
Document.DataConcealmentOnko data julkista? Aina PUBLIC, jos data on ladattu julkisten kanavien kautta.enumPUBLIC
Document.DataSecureLevelTiedon kätkemisen taso. Aina NONE, jos data on ladattu julkisten kanavien kautta.enumNONE
Document.DataSecureReasonsDatan karkeutuksen syyenum
Document.PartialDocumentOnko osa havaintoerän havainnoista piilotettu?boolean
Document.CollectionIDHavaintoerän pysyvä tunnistestring
Document.Quality.CollectionReliabilityRatingHavaintoerän luotettavuusarviointi (1-5)int
Document.Quality.Issue.Issue(ei käytössä vielä)
Document.Quality.Issue.Source(ei käytössä vielä)
Document.Quality.Issue.Message(ei käytössä vielä)
Document.SourceIDPysyvä tunniste havaintoerän alkuperäisestä järjestelmästästring
Document.NamedPlaceIDHavaintoerän pysyvä tunniste, jos sellaista on käytettystring
Document.KeywordsAvainsanat havaintoerällestring
Document.FirstLoadDatePäivämäärä, jolloin havaintoerä ladattiin ensimmäisen kerran FinBIF-tietovarastoonstring
Document.LoadDateViimeisin päivämäärä, jolloin havaintoerä ladattiin FinBIF-tietovarastoonstring
Document.CreatedPäivämäärä, jolloin havaintoerä luotiin alun perinstring
Document.ModifiedPäivämäärä, jolloin havaintoerää viimeksi muokattiinstring
Document.NotesHuomautuksia havaintoerästästring
Document.MediaCountMediatiedostojen lukumäärä havaintoerässäint
Siirry sivun alkuun