Files
Dashboard_Projects_Management/docs/open-meteo-widget.md
T
2026-10-15 20:38:02 +02:00

2.7 KiB

Open-Meteo widget

Verified 14 October 2026 against the Forecast API documentation, terms, pricing, and licence page.

Source and use

  • Endpoint: https://api.open-meteo.com/v1/forecast. The adapter requests current, 48 hourly, and two daily periods with timezone=auto, Celsius, km/h and millimetres. It uses Open-Meteo's default Best Match models. The browser calls only the authenticated Django endpoint; it never calls Open-Meteo directly.
  • The free API is for non-commercial use, without an API key. The published limits are under 10,000 weighted calls/day, 5,000/hour, 600/minute, and 300,000/month. Requests with more than ten variables may count as multiple calls. This internal personal dashboard is intended for non-commercial use. Recheck eligibility and use a commercial plan before commercial or advertising-supported deployment.
  • The weather card visibly credits and links Open-Meteo and the CC BY 4.0 licence, and notes that forecast data is adapted for display. Best Match can combine models; confirm any additional model attribution requirements before broad publication.
  • Cached forecasts are shared between server workers via a file-based cache. Fresh data lasts 15 minutes; a failed refresh may show the last forecast for up to one hour with an explicit stale label. A short cache lock limits duplicate upstream requests. The UI refreshes every 15 minutes while mounted.
  • Browser location is requested only after clicking Use my location. A denial is remembered for the current page session to avoid repeated prompts. Manual coordinates and Heerenveen fallback are available. Coordinates are rounded to two decimals before the server request, sent in a POST body, and not stored in layout settings or browser storage. The cache key is a hash of rounded coordinates. No location is written to application logs by this adapter. Open-Meteo may log request URLs containing rounded coordinates under its own privacy policy.

Display and limits

  • Current conditions are Open-Meteo model data, not a local instrument reading. Precipitation periods and forecast probabilities follow the API definitions. Hourly detail is selectable by mouse, touch, and keyboard; 24 hours display initially, expandable to 48.
  • API errors do not affect other widgets. If no prior data is available, the card shows an error without inventing conditions. If older data is available, it stays visible with a stale warning.
  • Forecasts are estimates; accuracy and uptime are not guaranteed. Recheck provider terms and dataset attribution before public deployment.