Źródła danych i metodologia

Ta strona opisuje, co pobieramy, jak rozpoznajemy miejscowości i lokalizacje oraz które rekordy wchodzą do średnich. Obecny zbiór pobrano: 2026-07-23.

1. Źródło podstawowe

Dane o kolejkach pobieramy przez HTTPS z publicznego endpointu Narodowego Funduszu Zdrowia:

api.nfz.gov.pl/app-itl-api/queues

Import obejmuje przypadki stabilne (case=1) we wszystkich 16 województwach. Nie przedstawiamy tego zbioru jako danych o przypadkach pilnych. Nie przypisujemy źródłu licencji, której warunków nie potwierdziliśmy w metadanych publikacji.

2. Pobieranie fail-closed

1. Akceptowany jest wyłącznie host api.nfz.gov.pl i protokół HTTPS.
2. Sprawdzamy kod odpowiedzi, typ treści, wersję API, komplet kluczy, typy pól i wartości dozwolone.
3. Limit API wynosi 25 rekordów. Dla każdego województwa pobieramy wszystkie strony i porównujemy liczbę unikalnych rekordów z polem meta.count.
4. Sprawdzamy 16 kodów województw, brak duplikatów ID, zakres współrzędnych, format dat i minimalny rozmiar całego zbioru.
5. Dane są najpierw zapisywane do nowego pliku oznaczonego SHA-256. Manifest wskazujący aktywny zbiór zmieniamy dopiero po przejściu wszystkich kontroli.
6. Jeżeli format, paginacja, typ lub semantyka ulegną nieznanej zmianie, proces kończy się błędem i poprzednia wersja pozostaje aktywna.

3. Mapowanie świadczeń

Zachowujemy każdy poprawny rekord kolejki i jego oficjalny identyfikator. Dla najczęściej używanych nazw stosujemy ręcznie zdefiniowane kategorie i dotychczasowe adresy URL. Każda pozostała oficjalna nazwa otrzymuje osobną kategorię fallback o deterministycznym adresie utworzonym z tej dokładnej nazwy i stabilnego skrótu. Nie używamy dopasowania „na podobieństwo” ani modelu językowego, a kolizja adresów przerywa publikację.

4. Miejscowości i lokalizacje

Miejscowość identyfikujemy za pomocą województwa, nazwy i identyfikatora TERYT. Homonimy — także w tym samym województwie — otrzymują osobne rekordy i jednoznaczne adresy. Istniejący krótki adres zachowujemy bez zmian, gdy wskazuje jedną miejscowość; gdy stał się niejednoznaczny, pozostaje stroną wyboru prowadzącą do właściwych lokalizacji TERYT.

Lokalizacja świadczeniodawcy jest identyfikowana m.in. kodem województwa, kodem świadczeniodawcy, numerem rejestrowym, identyfikatorami części resortowych, TERYT, adresem i nazwą miejsca udzielania świadczeń. Organizacja działająca pod wieloma adresami ma stronę zbiorczą oraz osobne strony lokalizacji.

5. Braki, zera i aktualność

• Brak wartości pozostaje brakiem danych; nigdy nie jest zamieniany na zero.
• 0 dni jest pokazywane jako literalna wartość raportowana przez NFZ, bez obietnicy przyjęcia od ręki.
• Data, która minęła jest oznaczana jako wygasła, a nie jako aktualnie wolny termin.
• Rekord jest uwzględniany w średnich, gdy ma liczbowy średni czas oraz miesiąc statystyk nie starszy niż 4 miesiące względem pobrania. Brak daty sytuacji nie unieważnia samej statystyki oczekiwania.
• Próg 45 dni dotyczy oceny aktualności pierwszego wolnego terminu: termin bez świeżej daty sytuacji jest oznaczany jako stary, niezależnie od statusu średniego czasu.
• Rekordy stare i brakujące pozostają widoczne z odpowiednią etykietą, ale nie obniżają sztucznie rankingów.

6. Agregaty i rankingi

Średnie są liczone bezpośrednio ze wszystkich oficjalnych kolejek oznaczonych jako aktualnie raportowane; każda kolejka zachowuje własny identyfikator i stanowi osobną obserwację. Nie wybieramy jednego „najlepszego” rekordu z lokalizacji. providerCount liczy natomiast odrębne lokalizacje bez duplikowania tej samej placówki, a queueCount pokazuje liczbę kolejek. Na stronie placówki wszystkie rozpoznane kolejki i świadczenia pozostają widoczne osobno.

7. Zachowanie istniejących adresów

Przed każdą publikacją nowy korpus jest porównywany z kontraktem obejmującym wszystkie adresy dostępne przed przebudową. Brak choćby jednego adresu przerywa proces. Gdy rekord znika z bieżącego API, stara strona pozostaje dostępna, lecz wyraźnie informuje o braku aktualnych danych i nie pokazuje historycznej kolejki jako bieżącej.

8. Ograniczenia

• NFZ i placówki odpowiadają za dane źródłowe oraz częstotliwość ich raportowania.
• Podany termin może zostać zajęty po publikacji.
• Informacje o parkingu, rampie, windzie i toalecie są deklaracjami z API i nie są przez nas sprawdzane na miejscu.
• Dane nie zastępują kontaktu z placówką ani porady medycznej.