Windy API v4, also known as as Windy Leaflet Plugin, is simple to use javascript API based on Leaflet and technology, that powers Windy.com.
Windy API uses Leaflet version 0.7.7
.
- Windy API
v2.3
will be discontinued as of 31.11.2018 - Windy API
v3
will be discontinued as of 31.10.2018 or even earlier.
Obtain your Windy API key here and check out our tutorials. You will handle our API in less than 20 minutes!
- Hello World
- Change Windy parameters
- Observe what is happening inside
- Mess with User Interface
- Change units
- Use weather picker
- Boat tracker
- Windy API is not compatible with higher versions of Leaflet and we have no intention to upgrade so far.
- While providing coordinates to Leaflet can be done via object
{ lat, lng }
with lng property, Windy supports{ lat, lon }
with lon property. - There can be only one instance of Windy Map on a page, but you can use multiple instances of Leaflet map on the same page.
- All classes of
leaflet.css
are nested inside#windy
selector (not to interfere with your own CSS), so if you want to use another instance of Leaflet map on the same page loadleaflet.css
yourself once more. - Windy uses a lot of global defined CSS classes, and id selectors, with nice names like
#bottom, #logo
etc. Windy also puts a lot of CSS classes tobody
tag dynamically. If design of Windy Map is broken, check your CSS and rename your id and selectors please. - Windy API v4 does not use cookies
- Windy API v4 heavily uses
localStorage
. Unintentional or intentional modifications of our items can lead to instability of Windy API. - Using undocumented functions of Windy engine can break your app, when we decide to upgrade our codes. If you miss something, rather let us know here and ask us to document and expose other features.
Please bear in mind that we pay for ecmwf
forecasting data. Therefore Windy API is free, with unrestricted traffic usage, but offers only gfs
forecast model. Windy logo MUST remain clickable on the map without rescaling down, or messing with logo's opacity. However you are free to move logo wherever you want inside Windy map. For free version of API we reserve the right to 1) display advertisement inside the Windy map, 2) Place "Download Windy App" message time to time on mobile device, or 3) discontinue free version of Windy API v4 at any time without prior notice.
For serious work we recommend to use paid version, that contains ecmwf
, iconEu
, nam
and gfs
models and will not contain ads. It costs only 720USD per year (ordered via this form and paid annually via invoice). Dvelopers of paid version can decrease opacity of Windy logo to 0.8 (however logo must remain clickable) and usage limit is average of 5.000 Unique Visitors a day (measured by Google Analytics). Contact us for quote for higher amounts.
Interesting, and non-commercial sites, using Windy API can ask for free upgrade to paid version. The condition is, that your project will be open sourced on GitHub. If this is your case, use the same form for paid version and describe your request.
Drop a line at our Windy API section of our Windy Community forum.
- Leaflet and Windy library based on Leaflet
v0.7.7
and based on Windy Clientv15.15.1
- Windy API as easy to use console, using
iframe
and requires all apps to run onmywindy.com
domain.
- Fixed bug after changing URL from
windyty.com
towindytv.com
- boot.js now run on https
- Increased size od typed arrays storage to handle retina displays
- Completely new version of API based on new Windyty 6.X.X codes