Publiczne API Mapy Oświatowej

curl "https://api.mapaoswiatowa.pl/api/institutions?city=Czy%C5%BCowice&type=PRIMARY_SCHOOL"

curl "https://api.mapaoswiatowa.pl/api/locations/search?q=Czy%C5%BCowice"
curl "https://api.mapaoswiatowa.pl/api/institutions/nearby?lat=49.9828&lng=18.4088&radius=10&type=NURSERY"

curl "https://api.mapaoswiatowa.pl/api/institutions?voivodeship=slaskie&subtype=TECHNICAL_SECONDARY&sortBy=views&limit=20"

Wyszukiwanie i geokodowanie

• GET/api/locations/search?q={fraza}

  Jedyny sposób zamiany nazwy miejscowości na współrzędne. Wynik typu city niesie id — to cityId, którym filtruje się placówki jednoznacznie.

• GET/api/locations/reverse?lat={lat}&lng={lng}

  Najbliższa miejscowość dla podanych współrzędnych.

Placówki

• GET/api/institutions

  Paginowana lista z ponad 30 filtrami. Bez danych kontaktowych. Odpowiedź niesie institutions[] i pagination.

• GET/api/institutions/nearby?lat={lat}&lng={lng}&radius={km}

  Placówki w promieniu, posortowane po odległości (pole distance w km). Wpisy promowane wracają osobno, w polu promoted.

• GET/api/institutions/{id}

  Pełny profil: ponad 50 pól, zdjęcia z atrybucją, statystyki SIO, dane kontaktowe. Jako {id} zadziała id, slug, numer RSPO (z ?by=rspo) albo numer rejestru żłobków.

• GET/api/institutions/popular

  Dzienna próbka najczęściej oglądanych placówek z opisem.

Miejscowości i podziały administracyjne

• GET/api/cities?voivodeship={slug}

  Miejscowości z liczbą placówek, malejąco.

• GET/api/cities/{slug}

  Szczegóły miejscowości: rodzaj TERYT, środek z PRNG, ludność NSP 2021, szeregi oświatowe GUS i agregaty SIO.

• GET/api/divisions/{woj}

  Powiaty województwa z kodami TERC i liczbami placówek.

• GET/api/divisions/{woj}/{powiat}

  Szczegóły powiatu. Miasto na prawach powiatu zwraca obiekt redirect ze slugiem swojej strony miejskiej.

• GET/api/divisions/{woj}/{powiat}/{gmina}

  Szczegóły gminy razem ze wskaźnikami GUS BDL. Gmina miejska zwraca obiekt redirect.

• GET/api/voivodeships/{slug}

  Statystyki województwa, 10 największych miast i oficjalne szeregi GUS BDL od 2008 roku.

Statystyki

• GET/api/statistics

  Agregaty krajowe wg typu, podtypu i województwa oraz krajowe sumy SIO za najnowszy rok szkolny.

• GET/api/statistics/fees?type=NURSERY|PRESCHOOL

  Statystyki opłat. Przy zbyt małej próbie zakres rozszerza się z miasta na województwo, a potem na kraj — pole scope mówi, czego wynik faktycznie dotyczy.

• GET/api/statistics/vocational-trends

  Krajowe trendy naboru do zawodów szkolnictwa branżowego wg danych SIO.

• GET/api/statistics/demographic-forecast

  Prognoza ludności GUS do 2060 roku w edukacyjnych grupach wieku, dla kraju i 16 województw.

• GET/api/statistics/specialists

  Zatrudnienie logopedów, psychologów i pedagogów oraz nauczane języki — z otwartego eksportu RSPO.

Patroni i zawody

• GET/api/patrons/search?q={fraza}

  Patroni szkół z liczbą placówek.

• GET/api/patrons/top

  Ranking patronów wraz ze slugiem strony patrona.

• GET/api/patrons/stats

  Podział patronów na kategorie i płeć — klasyfikacja automatyczna, z datą w polu classifiedAt.

• GET/api/patrons/{slug}

  Patron po slugu. Patron z mniej niż 10 placówkami nie ma własnej strony i zwraca 404.

• GET/api/vocational/professions

  Zawody nauczane w technikach i szkołach branżowych — słownik do podpowiedzi i filtrowania.

Status

• GET/health

  Stan usługi i jej bazy danych. Ten adres wskazuje relacja status w katalogu API.