Atlas data refers to the observations collected and stored in connection with the national bird and plant surveys. This project concentrated on the data on the distribution of Finnish bird species, which has been studied in three atlas surveys: the third atlas was conducted in 2006-10, the second one during 1986-89 and the first one 1974-79. The fourth atlas has begun in 2022.
This repostory contains only the backend API responsible for storing old atlas data and the grids, and retrieving the data for currently ongoing 4th atlas from laji.fi:s API.
API in Rahti container platform (staging) API in Rahti container platform (production)
Clone the ATLAS repository to your machine.
Open the .env.example file at the root of the project and modify it so that it contains the valid Oracle login credentials. Rename to .env.
Initiate VPN connection to the Helsinki University network. This is needed for the Oracle database connection to work.
While at the root of the project install dependencies with npm install. For a list of necessary dependencies, see package.json file. In addition, Oracle Instant Client software is needed and should be downloaded from here.
Run program with node .\src\main\start.js. You can now see the available API endpoints in your browser on http://localhost:3000. Stop the program with Ctrl+C.
The repository has webhooks set up that trigger automatic builds on Rahti, simply pushing changes to development- and main-branches will update staging and production versions, respectively.