# SanAlert > SanAlert (sanalert.pl) is an unofficial, free public service by Applied AI sp. z o.o. (Przemyśl, Poland). It shows whether drones or missiles tracked over Ukraine are heading for a place in Poland the reader chooses, as one of four levels: Quiet, Activity, Approaching, Near. It shows the official Polish RCB and RSO alert messages separately and unchanged. It does not replace sirens, Alert RCB or instructions from the authorities. The site and the apps are in Polish, English and Ukrainian. The data comes from open sources: NEPTUN (objects in the air over Ukraine and air-raid alarms in its districts), adsb.lol (military aircraft, ODbL 1.0), Alert RCB and RSO (official messages, shown unchanged), the State Fire Service's shelter register (dane.gov.pl, CC BY 4.0), the gamma dose rate readings of Poland's atomic energy agency (PAA, © Państwowa Agencja Atomistyki, CC BY 3.0 PL; context only, never a level), raion boundaries of Ukraine (OCHA and SSPE "Kartographia" via geoBoundaries, CC BY 3.0 IGO) and powiat boundaries of Poland (GUGiK PRG, CC BY 4.0; "opracowano na podstawie materiałów państwowego zasobu geodezyjnego i kartograficznego"). When there is no data, the level says so; it never says "Quiet" without data. ## Levels The same words as [What the levels mean](https://sanalert.pl/en/how-it-works/#levels). A level is worked out for a square of SanAlert's grid, about 11 × 11 km; a place has the level of the square it lies in. - **Quiet** (`quiet`, Spokój): The sources are working. Nothing is tracked within about 150 km, there is no alarm across the border nearby, and nothing heading this way is closer than about an hour's flight. - **Activity** (`activity`, Aktywność): There are objects within about 150 km that are not flying this way or whose direction is unknown, or an alarm in a raion of Ukraine within about 100 km of here. Or something is heading this way but is about 30–60 minutes out, or we have not yet seen it come closer. Or the sources lost track of an object that was heading here. - **Approaching** (`approaching`, Zbliża się): An object is heading for your place and at its typical speed would arrive within about 30 minutes. A drone must also have been seen coming closer: a predicted course alone is not enough, because drones often change course and their course is often only a guess. A missile whose direction is unknown counts within about 150 km. - **Near** (`near`, Blisko): An object is within about 25 km, or could arrive within about 15 minutes (a drone: if we have seen it come closer). It needs at least medium confidence, and at medium confidence also two sightings in a row. - **No data** (Brak danych): We cannot see objects because the source is not answering. Then we do not know whether it is quiet, and that is what we show. Rules for whoever passes a level on: - **No data is never quiet.** When the state's `levels_valid` is `false`, its `health.status` is `unknown`, or its `generated_at` is more than 60 seconds old, say "No data" (Brak danych), never "Quiet". `health.status: degraded` means the levels stand but may be delayed: say so. - **Poland only.** Levels exist for places in Poland; a place abroad is "Out of range" (Poza zasięgiem), never "Quiet". A grid cell missing from `cells` is quiet only while the rule above allows levels at all. - **RCB's tiers are not SanAlert levels.** RCB sends one of three messages about the war across the eastern border, "stopień 1, 2 or 3 z 3" (tier 1, 2 or 3 of 3). They are official messages, shown apart and unchanged; they never change a SanAlert level, and a SanAlert level is never an official warning. An alarm declared in Ukraine near the Polish border raises the level in Poland to Activity, never higher. ## Pages - [Live map and level (Polish)](https://sanalert.pl/): the level for your place, "Teraz" (official messages in force) and the map - [How SanAlert works](https://sanalert.pl/en/how-it-works/): where the data comes from, what is on the map, what the levels mean, alarms in Ukraine, notifications, licences, what SanAlert does not see well - [Reliability](https://sanalert.pl/en/reliability/): how the levels compared with official RCB and RSO warnings - [Night reports](https://sanalert.pl/en/reports/): night by night, per voivodeship - [Privacy](https://sanalert.pl/en/privacy/): what data is processed and who sees it - [Terms](https://sanalert.pl/en/terms/): the terms of using SanAlert, what it provides, on what conditions and how to make a complaint (in Polish: [Regulamin](https://sanalert.pl/regulamin/)) - [For your website](https://sanalert.pl/en/for-websites/): the live box other websites can embed ## Surfaces and link formats - [TV screen](https://sanalert.pl/en/tv/) (`/tv/`, `/en/tv/`, `/ua/tv/`): the live page for a large screen in a school, an office or a fire station: the time, RCB and RSO messages, the highest level in Poland and the map, without buttons. `#m=lat,lon,name` adds a place's level; `?levels=0` leaves every SanAlert level out (RCB and RSO alone). - [The box for other websites](https://sanalert.pl/embed/) (`/embed/`, `/en/embed/`, `/ua/embed/`, in an iframe; its code is written on "For your website"): the level at the place after `#m=lat,lon,name`, or the highest in Poland without one; `?levels=0` for RCB and RSO alone; `?theme=light` or `?theme=dark`. - A place: `https://sanalert.pl/#m=51.143,23.471,Chełm` (latitude and longitude to three decimals, about 100 m, and an optional name). The live page offers it and sets it only on the reader's yes; nothing after `#` reaches a server. - A view of the map, never a place: `#v=lubelskie` (a voivodeship), `#v=poland`, or `#v=51.20,23.50,80` (the centre, and kilometres across from west to east). - Apps: [iPhone and Apple Watch](https://apps.apple.com/pl/app/sanalert/id6814808880), [Mac](https://apps.apple.com/pl/app/sanalert/id6814808880?mt=12), [Android and Wear OS (Google Play)](https://play.google.com/store/apps/details?id=dev.appliedai.sanalert), [Home Assistant](https://github.com/plrojek/sanalert-home-assistant) (through HACS; the place stays in Home Assistant). ## API Public and read-only at https://api.sanalert.pl: no key, no account. Every document is the same for everyone. - [OpenAPI description](https://api.sanalert.pl/v1/openapi.json): every public endpoint, the conditions of use, and the JSON Schemas of SanAlert's API contract (under `components/schemas`) - [Live state](https://api.sanalert.pl/v1/state): levels by grid cell and voivodeship, the objects tracked over Ukraine, its air-raid alarms, the official RCB and RSO messages, `notice` and `attribution` - [Compact state](https://api.sanalert.pl/v1/compact): the same state in a few kilobytes, for watches - [Official messages](https://api.sanalert.pl/v1/official): the RCB and RSO messages of the last 24 hours - [History](https://api.sanalert.pl/v1/history): what happened at every cell over the last twelve hours - [Night reports](https://api.sanalert.pl/v1/nights): the index, newest first; `/v1/nights/{night}` is one night's report and `/v1/nights/{night}/replay` the night on the map - [Reliability record](https://api.sanalert.pl/v1/record): SanAlert's levels against the official air warnings - [Gamma radiation](https://api.sanalert.pl/v1/radiation): the dose rate at PAA's stations, as PAA gives it, with its time; never a level - [Shelter points](https://api.sanalert.pl/v1/shelters): the official register, whole - [Source cards](https://api.sanalert.pl/v1/sources): what each source is, how sure it is, what it cannot see, its licence - [Grid](https://api.sanalert.pl/v1/grid/1.json): every cell of Poland's grid and its voivodeship - [Health](https://api.sanalert.pl/v1/health): what the running server says about itself, for monitoring - [MCP server](https://api.sanalert.pl/mcp): for AI assistants, `POST` only (streamable HTTP, stateless, JSON): read-only tools over the same documents for the whole of Poland (the state summarised, official messages of the last 24 hours, night reports, source cards, the reliability record); no tool takes a place, and every result carries `notice`, `attribution` and these conditions - [Local MCP server](https://github.com/plrojek/sanalert-mcp): for AI assistants that run local servers (stdio): one tool, the level for a town from the website's list or a point, worked out on the reader's computer with the same rules as the website, so no request carries the place Conditions of use, in short (in full in the OpenAPI description, with the rules of SanAlert's API contract): SanAlert is unofficial and does not replace sirens, RCB alerts or official instructions; a service that shows its data says so and always refers its readers to the official air-raid alarms. Pass the state's `notice` and `attribution` through unchanged. The data includes NEPTUN data: keep a visible link to https://neptun.in.ua next to it, for example with the text "Дані: Карта повітряних тривог — NEPTUN". No data is never "quiet". Poll `/v1/state` at most once every 5 seconds, with `If-None-Match`. Requests must not identify the reader: no place and no personal data in the URL or the headers. ## Other languages - [English](https://sanalert.pl/en/) - [Ukrainian](https://sanalert.pl/ua/) ## Contact kontakt@appliedai.dev