This project generates tide timings JSONs by web scraping from https://www.nea.gov.sg/weather/tide-timings tables.
Codes are tested on Node.js v16 only, as of point of writing. Other versions, use at own risk!
- Run
npm run startto generate current and next month's JSONs on your own machine. - Run
npm run actionsto generate with an extralatest.jsonto reflect current month tide timings, and save all months atarchives/directory. Designed for current GitHub Actions script use.
Always remember to install the dependencies! 🙂
Current month's tide timings can be accessed by:
https://vincentneo.github.io/SGTideTimings/latest.json
Previous/Future month's tide timings, by month and year, can be accessed by:
https://vincentneo.github.io/SGTideTimings/archives/2022-09.json
https://vincentneo.github.io/SGTideTimings/archives/{yyyy}-{MM}.json
You must adhere to the terms of the Singapore Open Data Licence version 1.0 when using the tide timings data.
JSONs are formatted as array with objects of such format:
{
"date": "2022-09-01T01:39:00.000+08:00",
"height": 2.8,
"classification": "H"
}Formatted according to ISO 8601 standard, with Singapore's timezone offset, as it represents local time in Singapore.
Seconds and milliseconds can be disregarded.
In metres, and according to NEA:
Tidal height is in metres above the ‘Chart Datum’, which is the lowest water level recorded over a fixed period (usually 18 years) at a particular point.
Whether if tide is classified as high (H) or low (L).
This uses GitHub Actions to automatically scrape, generate usable JSON files and deploy to the gh-pages branch of this repo, automatically.
NEA / data.gov.sg currently does not have an API for tide timings prediction, unlike many other data provided on the NEA website.
Codes in the main branch of the repository, which contains code that does the web scraping, etc, is licensed under MIT License.
Generated contents (including gh-pages branch contents) contains information from Tide Timings table, and will be accessed every 1st and 2nd day of each month from National Environment Agency (NEA) / Maritime and Port Authority of Singapore (MPA) which is made available under the terms of the Singapore Open Data Licence version 1.0.