Otevřená data
Fleky a koše pro každého

Co lidé zapíšou do Fleku, patří všem. Fleky i koše si může kdokoli stáhnout a použít ve své aplikaci, na webu obce nebo v mapě: bez klíče, bez registrace, jako GeoJSON.

Co tu je

Fleky	Místa, která lidé zapsali: velké a malé fleky na kráse, pěkná místa a co se uklidilo. U každého poloha, velikost, stav, poslední fotka a odkaz na mapu.
Koše	Veřejné koše a kontejnery: z OpenStreetMap a ty, které lidé přidali ve Fleku. U každého, co do něj patří.
Co tu není	Nic o lidech. Kdo flek přidal, z jakého telefonu nebo kdy kdo klepl, se nezveřejňuje.

Jak data získat

Výřez mapy (bbox = západ, jih, východ, sever ve stupních, nejvýš 0,5° na každou stranu):

https://flekit.com/api/open/v1/fleks?bbox=14.05,50.13,14.15,50.18
https://flekit.com/api/open/v1/bins?bbox=14.05,50.13,14.15,50.18

Celý katastr obce, oříznutý po její hranici:

https://flekit.com/api/open/v1/fleks?obec=brandysek
https://flekit.com/api/open/v1/bins?obec=brandysek

Obce, které zatím mají hranici: Brandýsek, Buštěhrad, Kamenné Žehrovice, Kladno, Libušín, Pchery, Podlešín a Žižice. Chcete svou? Napište nám.

Co vrací

{
  "type": "FeatureCollection",
  "license": "ODbL-1.0",
  "features": [{
    "type": "Feature",
    "geometry": { "type": "Point", "coordinates": [14.1, 50.15] },
    "properties": {
      "id": "01M6P…",
      "size": "big",          // big | small | nice
      "state": "open",        // open | cleaning | cleaned | fine
      "photo": "https://flekit.com/photos/…",
      "url": "https://flekit.com/p/01M6P…"
    }
  }]
}

Koš má v properties pole kinds: general, plastic, glass, paper, metal, textile, electro, bio. Odpověď se obnovuje každých pět minut. Nejvýš 5 000 míst na dotaz; když jich je víc, odpověď nese "truncated": true.

Licence

Data jsou pod licencí Open Database License (ODbL) 1.0: použijte je, jak chcete, uveďte zdroj „© přispěvatelé Flek, flekit.com“ (u košů také „© přispěvatelé OpenStreetMap“) a upravenou databázi sdílejte pod stejnou licencí. Fotky patří jejich autorům: odkazujte na ně, nekopírujte je.

Zápis z jiné aplikace

Aplikace (třeba portál obce) může fleky a koše i přidávat. Přihlašuje se přes OAuth 2 (client credentials): napište nám, pošleme jí client_id a tajný klíč s denním limitem zápisů. Za klíč dostane token na hodinu:

POST https://flekit.com/api/open/v1/oauth/token
grant_type=client_credentials&client_id=…&client_secret=…

→ { "access_token": "…", "token_type": "Bearer", "expires_in": 3600, "scope": "fleks:write bins:write" }

S tokenem v hlavičce Authorization: Bearer … přidá flek (JSON, nebo multipart s fotkou v poli photo):

POST https://flekit.com/api/open/v1/fleks
{ "lat": 50.15, "lon": 14.1, "size": "big" }          // big | small | nice

POST https://flekit.com/api/open/v1/bins
{ "lat": 50.15, "lon": 14.1, "kinds": ["glass", "paper"] }