# Swiss Sun

> Hours of sunshine at any address in Switzerland, by month and year: clouds and fog from MeteoSwiss climate normals 1991–2020, and the shade of the mountains around each place. Free, built on open data from MeteoSwiss and swisstopo.

The map at https://swiss-sun.app/ computes in the browser and keeps the place after `#`, so it can't be read without JavaScript. To answer a question about a Swiss place, fetch the API instead. No key needed.

## API

- [Sunshine as JSON](https://swiss-sun.app/api/sunshine?q=Bundesplatz%203%20Bern): `GET https://swiss-sun.app/api/sunshine?q=<address, street, town or postcode>`, or `?lat=46.9466&lon=7.4443` for coordinates.
- [The same answer as a web page](https://swiss-sun.app/sun?q=Bundesplatz%203%20Bern): `https://swiss-sun.app/sun?q=<address>`, plain HTML.
- [OpenAPI description](https://swiss-sun.app/openapi.json): every field, for tools, agents and custom GPT actions.

Each answer has the yearly and monthly sunshine hours, the share of the possible maximum, the hours lost to mountain shade, the times of direct sun on the 21st of each month with and without the mountains, notes on morning and evening shade, temperature and precipitation, and a link to the place on the map. Shade from buildings and trees is not included.

A town name lands on the town centre. If the name exists in several municipalities, `place.other_matches` lists the others: ask again with the canton, e.g. [Wil SG](https://swiss-sun.app/api/sunshine?q=Wil%20SG). Errors: 400 no place given, 404 nothing found or outside Switzerland, 502 the address search is unavailable (give coordinates instead).

Please credit "Source: Swiss Sun (swiss-sun.app), with data from MeteoSwiss and swisstopo" and link the place's `links.map` or `links.page`.

## Towns

60 towns with their own page, sunniest first:

- [Crans-Montana (VS)](https://swiss-sun.app/crans-montana/): 2220 hours of sunshine a year
- [Locarno (TI)](https://swiss-sun.app/locarno/): 2200 hours of sunshine a year
- [Sion (VS)](https://swiss-sun.app/sion/): 2170 hours of sunshine a year
- [Ascona (TI)](https://swiss-sun.app/ascona/): 2120 hours of sunshine a year
- [Mendrisio (TI)](https://swiss-sun.app/mendrisio/): 2090 hours of sunshine a year
- [Lugano (TI)](https://swiss-sun.app/lugano/): 2090 hours of sunshine a year
- [Sierre (VS)](https://swiss-sun.app/sierre/): 2040 hours of sunshine a year
- [Geneva (GE)](https://swiss-sun.app/geneva/): 1950 hours of sunshine a year
- [Morges (VD)](https://swiss-sun.app/morges/): 1930 hours of sunshine a year
- [Vevey (VD)](https://swiss-sun.app/vevey/): 1920 hours of sunshine a year
- [Nyon (VD)](https://swiss-sun.app/nyon/): 1920 hours of sunshine a year
- [Lausanne (VD)](https://swiss-sun.app/lausanne/): 1910 hours of sunshine a year
- [Verbier (VS)](https://swiss-sun.app/verbier/): 1850 hours of sunshine a year
- [Fribourg (FR)](https://swiss-sun.app/fribourg/): 1830 hours of sunshine a year
- [Bern (BE)](https://swiss-sun.app/bern/): 1800 hours of sunshine a year
- [Thun (BE)](https://swiss-sun.app/thun/): 1780 hours of sunshine a year
- [Bellinzona (TI)](https://swiss-sun.app/bellinzona/): 1780 hours of sunshine a year
- [Montreux (VD)](https://swiss-sun.app/montreux/): 1770 hours of sunshine a year
- [Yverdon-les-Bains (VD)](https://swiss-sun.app/yverdon-les-bains/): 1760 hours of sunshine a year
- [Rapperswil-Jona (SG)](https://swiss-sun.app/rapperswil-jona/): 1760 hours of sunshine a year
- [Martigny (VS)](https://swiss-sun.app/martigny/): 1760 hours of sunshine a year
- [La Chaux-de-Fonds (NE)](https://swiss-sun.app/la-chaux-de-fonds/): 1740 hours of sunshine a year
- [Interlaken (BE)](https://swiss-sun.app/interlaken/): 1740 hours of sunshine a year
- [Neuchâtel (NE)](https://swiss-sun.app/neuchatel/): 1730 hours of sunshine a year
- [Chur (GR)](https://swiss-sun.app/chur/): 1730 hours of sunshine a year
- [Basel (BS)](https://swiss-sun.app/basel/): 1720 hours of sunshine a year
- [Uster (ZH)](https://swiss-sun.app/uster/): 1700 hours of sunshine a year
- [Appenzell (AI)](https://swiss-sun.app/appenzell/): 1700 hours of sunshine a year
- [Thalwil (ZH)](https://swiss-sun.app/thalwil/): 1690 hours of sunshine a year
- [Baar (ZG)](https://swiss-sun.app/baar/): 1690 hours of sunshine a year
- [Delémont (JU)](https://swiss-sun.app/delemont/): 1680 hours of sunshine a year
- [Dübendorf (ZH)](https://swiss-sun.app/duebendorf/): 1680 hours of sunshine a year
- [Zurich (ZH)](https://swiss-sun.app/zurich/): 1670 hours of sunshine a year
- [Wädenswil (ZH)](https://swiss-sun.app/waedenswil/): 1660 hours of sunshine a year
- [Solothurn (SO)](https://swiss-sun.app/solothurn/): 1660 hours of sunshine a year
- [Küsnacht (ZH)](https://swiss-sun.app/kuesnacht/): 1660 hours of sunshine a year
- [Horgen (ZH)](https://swiss-sun.app/horgen/): 1660 hours of sunshine a year
- [Kloten (ZH)](https://swiss-sun.app/kloten/): 1660 hours of sunshine a year
- [Liestal (BL)](https://swiss-sun.app/liestal/): 1650 hours of sunshine a year
- [Emmen (LU)](https://swiss-sun.app/emmen/): 1650 hours of sunshine a year
- [Zug (ZG)](https://swiss-sun.app/zug/): 1640 hours of sunshine a year
- [Winterthur (ZH)](https://swiss-sun.app/winterthur/): 1640 hours of sunshine a year
- [Davos (GR)](https://swiss-sun.app/davos/): 1640 hours of sunshine a year
- [Biel/Bienne (BE)](https://swiss-sun.app/biel/): 1630 hours of sunshine a year
- [Schwyz (SZ)](https://swiss-sun.app/schwyz/): 1630 hours of sunshine a year
- [Frauenfeld (TG)](https://swiss-sun.app/frauenfeld/): 1630 hours of sunshine a year
- [Wil (SG)](https://swiss-sun.app/wil/): 1630 hours of sunshine a year
- [St. Moritz (GR)](https://swiss-sun.app/st-moritz/): 1630 hours of sunshine a year
- [St. Gallen (SG)](https://swiss-sun.app/st-gallen/): 1630 hours of sunshine a year
- [Aarau (AG)](https://swiss-sun.app/aarau/): 1620 hours of sunshine a year
- [Lucerne (LU)](https://swiss-sun.app/lucerne/): 1610 hours of sunshine a year
- [Olten (SO)](https://swiss-sun.app/olten/): 1610 hours of sunshine a year
- [Kreuzlingen (TG)](https://swiss-sun.app/kreuzlingen/): 1610 hours of sunshine a year
- [Schaffhausen (SH)](https://swiss-sun.app/schaffhausen/): 1590 hours of sunshine a year
- [Zermatt (VS)](https://swiss-sun.app/zermatt/): 1560 hours of sunshine a year
- [Baden (AG)](https://swiss-sun.app/baden/): 1560 hours of sunshine a year
- [Brig (VS)](https://swiss-sun.app/brig/): 1540 hours of sunshine a year
- [Altdorf (UR)](https://swiss-sun.app/altdorf/): 1380 hours of sunshine a year
- [Engelberg (OW)](https://swiss-sun.app/engelberg/): 1360 hours of sunshine a year
- [Glarus (GL)](https://swiss-sun.app/glarus/): 1330 hours of sunshine a year

## Every municipality

Every municipality of Switzerland and Liechtenstein (2124 places) has a page like the towns' (https://swiss-sun.app/grindelwald/), listed by canton, sunniest first:

- [Aargau](https://swiss-sun.app/canton-aargau/)
- [Appenzell Ausserrhoden](https://swiss-sun.app/canton-appenzell-ausserrhoden/)
- [Appenzell Innerrhoden](https://swiss-sun.app/canton-appenzell-innerrhoden/)
- [Basel-Landschaft](https://swiss-sun.app/canton-basel-landschaft/)
- [Basel-Stadt](https://swiss-sun.app/canton-basel-stadt/)
- [Bern](https://swiss-sun.app/canton-bern/)
- [Fribourg](https://swiss-sun.app/canton-fribourg/)
- [Geneva](https://swiss-sun.app/canton-geneva/)
- [Glarus](https://swiss-sun.app/canton-glarus/)
- [Graubünden](https://swiss-sun.app/canton-graubunden/)
- [Jura](https://swiss-sun.app/canton-jura/)
- [Liechtenstein](https://swiss-sun.app/liechtenstein/)
- [Lucerne](https://swiss-sun.app/canton-lucerne/)
- [Neuchâtel](https://swiss-sun.app/canton-neuchatel/)
- [Nidwalden](https://swiss-sun.app/canton-nidwalden/)
- [Obwalden](https://swiss-sun.app/canton-obwalden/)
- [Schaffhausen](https://swiss-sun.app/canton-schaffhausen/)
- [Schwyz](https://swiss-sun.app/canton-schwyz/)
- [Solothurn](https://swiss-sun.app/canton-solothurn/)
- [St. Gallen](https://swiss-sun.app/canton-st-gallen/)
- [Thurgau](https://swiss-sun.app/canton-thurgau/)
- [Ticino](https://swiss-sun.app/canton-ticino/)
- [Uri](https://swiss-sun.app/canton-uri/)
- [Valais](https://swiss-sun.app/canton-valais/)
- [Vaud](https://swiss-sun.app/canton-vaud/)
- [Zug](https://swiss-sun.app/canton-zug/)
- [Zurich](https://swiss-sun.app/canton-zurich/)

## Optional

- [Sunniest towns in Switzerland](https://swiss-sun.app/sunniest-towns/): the 60 towns ranked, with winter and summer sunshine and temperature.
- [Methodology](https://swiss-sun.app/methodology/): how the numbers are made and how accurate they are.