README file from
GithubPlaces Environment
Environmental data for Places: tides, solar events, and weather, as charts, tables, cards, and user templates.
Network requests
| Area | Request |
|---|---|
| Tides | Finds the nearest station and reads its tide predictions |
| Solar events | Reads sunrise, sunset, and twilight times for a coordinate |
| Weather | Reads current, hourly, and daily forecast values |
| Seasonal forecast | Reads forecast values beyond the 16 day forecast window |
Requests go to api.tidesandcurrents.noaa.gov, api.sunrise-sunset.org, api.open-meteo.com,
and seasonal-api.open-meteo.com. Responses are cached in the note's
frontmatter or in plugin data, with a lifetime set by each block's cache: setting.
Background tasks
None.
Dependencies
| Library | Purpose |
|---|---|
| Chart.js | Tide, solar, and weather charts |
| chartjs-adapter-date-fns | Time axis support for Chart.js |
| date-fns | Date arithmetic and formatting |
| lunarphase-js | Moon phase for solar output |
| markdown-table | Renders generated tables |
| openmeteo | Decodes Open-Meteo flatbuffers responses |
| user-template-renderer | Runs the user template in places-weather-template |
| places-shared | Shared map, overlay, routing, and utility code |