канарче
Отворени данни
Данни
Канарче публикува измерванията зад картата. Това са ФПЧ2.5 и ФПЧ10 от граждански сензори в мрежата на Sensor.Community, измервания от станциите на Изпълнителната агенция по околна среда (ИАОС), публикувани чрез Европейската агенция по околна среда (ЕАОС), температура, влажност, налягане, вятър, прогнози за прашец и границите на районите.
Формати
Данните са достъпни като JSON през публичния API на /api/v1. Няма изтегляне във формат CSV. Добри начални точки са /api/v1/areas за списъка с райони, /api/v1/overview за текущите стойности, /api/v1/area/{slug}/series за историята на един район и /api/v1/sensor/{id}/series за един сензор. Историята приема показател и период. Не са нужни ключ или профил.
Лицензи и посочване
Всеки източник запазва своя лиценз. Данните на Sensor.Community са под ODbL 1.0 и DbCL 1.0. Данните на OpenStreetMap са под ODbL 1.0. Данните за вятъра, прашеца и водите за къпане на ЕАОС са под CC BY 4.0. За данните на ИАОС важат условията за ползване на ЕАОС. Ако използвате данните, трябва да посочите всеки източник, както е описано на страницата Лицензи. Всеки отговор на API съдържа връзка към нея. Стойностите, изчислени от Канарче, като медианите за районите и средните стойности за 24 часа, са под ODbL 1.0, защото идват от данни под ODbL. Посочвайте Канарче и Sensor.Community. Данните се предоставят такива, каквито са, без гаранции.
Обновяване
Гражданските сензори изпращат измерване на около 5 минути. Канарче показва последните измервания и изчислява стойностите за районите от тях. Официалните станции публикуват по-рядко. Скорошните измервания се пазят около месец, а за по-дълги периоди се показват осреднени стойности.
Значка за вашия сайт
Показвайте текущото качество на въздуха в един район на вашата страница. Сменете името на района в адреса с частта от адреса на страницата на района, например plovdiv-oblast. Значката сочи към страницата на района в Канарче, което е посочването на източника. Копирайте кода по-долу. Политиката ви за защита на съдържанието (CSP) трябва да разрешава изображения от kanarche.eu. Изображението се обновява на около 5 минути. Данните са ориентировъчни и не са за решения за здравето.
<a href="https://kanarche.eu/area/plovdiv-oblast"><img src="https://kanarche.eu/badge/plovdiv-oblast.svg" alt="Качество на въздуха в Пловдив: умерено, ФПЧ2.5 24,4 µg/m³. Канарче" width="200" height="40"></a>Ограничения на заявките
Заявките са ограничени за всеки адрес. В момента API допуска около 10 заявки в секунда на кратки серии, историята около 1 заявка в секунда, а клиент, който прочете над 60 различни района или 40 различни сензора за час, се забавя за 15 минути. Ограничената заявка получава статус 429 със заглавие Retry-After. Запазвайте получените данни. За редовно ползване на целия набор пишете на privacy@kanarche.eu.