Query Examples
Get all observations:
https://api.laji.fi/v0/warehouse/query/unit/list?access_token=xxxGet all porpoise observations:
https://api.laji.fi/v0/warehouse/query/unit/list?taxonId=MX.47025&access_token=xxxNote: The easiest way to find the correct taxonId is to search for a species you want and copy the ID from its URL.
Get all porpoise observations as GeoJSON:
https://api.laji.fi/v0/warehouse/query/unit/list?crs=EUREF&featureType=ORIGINAL_FEATURE&taxonId=MX.47025&format=geojson&access_token=xxxGet all porpoise observations after the year 2010 as GeoJSON:
https://api.laji.fi/v0/warehouse/query/unit/list?crs=EUREF&featureType=ORIGINAL_FEATURE&taxonId=MX.47025&time=2010-01-01%2F&format=geojson&access_token=xxx
Get all porpoise observations after the year 2010 that are neutral, verified by experts or verified by community as GeoJSON:
https://api.laji.fi/v0/warehouse/query/unit/list?crs=EUREF&featureType=ORIGINAL_FEATURE&taxonId=MX.47025&time=2010-01-01%2F&recordQuality=COMMUNITY_VERIFIED,EXPERT_VERIFIED,NEUTRAL&format=geojson&access_token=xxxGet aggregated porpoise observations per 10 km x 10 km squares in the YKJ grid.
https://api.laji.fi/v0/warehouse/query/unit/aggregate?taxonId=MX.47025&countryId=ML.206&aggregateBy=gathering.conversions.ykj10kmCenter.lat,gathering.conversions.ykj10kmCenter.lon&access_token=xxxTips to query
1. An easy way to find the right parameters and values is to set filters on laji.fi and copy them from the URL.
2. Find the list of all endpoints and instructions for an access token from this page.
3. Use the Area endpoint to find countries, Finnish municipalities, Finnish biogeographical provinces, etc.
4. Use the Metadata endpoint to find variable names, descriptions, ranges, enumeration values, etc. in three languages. This data can be browsed on schema.laji.fi in human-readable
5. These were simple examples. Usually the queries end up being very long. Don’t be scared 🙂