The official source code for Serenum API. https://api.serenum.org
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Airikr 7236c89b8a Update 'README.md' 4 weeks ago
vendor Small update 1 month ago
.gitignore Minor update 6 months ago
.htaccess Minor update 4 months ago
LICENSE Initial commit 6 months ago
README.md Update 'README.md' 4 weeks ago
api-airpollution.php Minor update 4 weeks ago
api-alerts.php Minor update 4 weeks ago
api-ambee.php Minor update 4 weeks ago
api-astronomy.php Minor update 4 weeks ago
api-current-weather.php Minor update 4 weeks ago
api-forecast-daily.php Minor update 4 weeks ago
api-forecast-hourly.php Minor update 4 weeks ago
api-forecast-minutely.php Minor update 4 weeks ago
api-place.php Minor update 4 weeks ago
class-geotimezone.php Release 6 months ago
class-moonphase.php Small update 1 month ago
class-suncalc.php Release 6 months ago
composer.json Small update 1 month ago
composer.lock Small update 1 month ago
diff.php Minor update 2 months ago
functions.php Minor update 1 month ago
index.php Minor update 4 weeks ago
wiki.css Minor update 4 weeks ago
wiki.php Minor update 4 weeks ago

README.md

Serenum API

What is Serenum API?

Serenum API is a weather API that uses OpenWeatherMap API and aims to be as detailed and simple as it can possible be. You can choose to call the data from api.serenum.org or download the files and use it on your own server. It requires your own API key from OpenWeatherMap or Ambee Pollen API. Read more: https://api.serenum.org/wiki#download

Attention! If you enable Ambee Pollen API in Serenum API, expect much longer load then usual! We are currently trying to fix this together with Ambee.

Features

  • Current timezone, date, and time for the given place
  • Detailed overview for the given place
    • Direct link to OpenStreetMap to the coordinates
  • Current weather
    • Current weather's id, icon, and description
    • Probability of rain and/or snow
    • Temperature with feels like temperature + dew point
    • Wind speed and direction
    • Cloud cover
    • Humidity
    • Pressure
    • UV index
    • Grams of H2O per kg of air
    • Risk of pollen (requires secondary API key from Ambee)
    • Air pollution
  • Global weather map from yr.no (clouds only)
  • Weather forecast
    • Minutely for 1 hour (probability only)
    • Hourly for 24 hours
    • Daily for 7 days
    • Astronomical data about the hourly and daily forecast
  • Astronomy data
    • Sun and Moon hours
    • Sun and Moon positions
    • Moon's distance to Earth
    • Moon's distance to the Sun
    • The current phase of the Moon
    • Forecast of Moon phases
      • Countdowns to the Moon phases
    • Moon's angle, age, and fraction
    • If the Sun are up or not
    • If the Moon are always up or always down
    • Daylight and night time
    • Support for Stellarium API for more accurate data about the Sun and the Moon. This requires the Stellarium software to be installed on the machine and the RemoteControl plugin to be enabled
  • Compare 2 places with diff.php
    • See the current weather for both of the places. Is it for an example warmer on the first place compared to the second place?
    • See the distance (bird's eye view) and the difference between both places.

Plans

  • Add thunderstorm data for the current weather and maybe also for the forecast
  • Show if the Sun are always up or always down

Bugs

Contact us

If you want to see all of our plans and the issues we have encountered, please go to our project management page. For any issues, create a new issue or write to us on Telegram.


How to get started

  1. Clone the repo or download the files.
  2. Change [your-api-key] with your own API key from OpenWeatherMap or append &key=[your-key-from-owm] to the address. If you have an API key from Ambee, uncomment the cURL for Ambee Pollen API and replace [your-api-key] with your API key from Ambee.
  3. Visit http://localhost/api in your browser and follow the instructions.

How to get started with the difference page

  1. Clone the repo or download the files.
  2. Change [your-api-key] with your own API key from OpenWeatherMap or append &key=[your-key-from-owm] to the address.
  3. Visit http://localhost/api/diff.php in your browser and follow the instructions.