polish-cities/README.md

Zbiór danych o miastach w Polsce w formacie JSON – gotowy do użycia w aplikacjach frontendowych, backendowych lub do analiz.

# 🇵🇱 polish-cities

📅 **Aktualność danych:** czerwiec 2025

Zbiór danych o miastach (z powiązaniem do powiatu i województwa) w Polsce w formacie JSON – gotowy do użycia w aplikacjach frontendowych, backendowych lub do analiz.

Jest to lista wszystkich polskich miast, zawierająca informacje o:
- położeniu geograficznym każdego miasta – określonym jako środek bounding boxa (latitude, longitude) pobranego z danych Nominatim (OpenStreetMap),
- promieniu (radius) – liczonym jako największa odległość (w stopniach) od środka bounding boxa do jego narożników, co pozwala oszacować przybliżony zasięg miasta na mapie.

Dane te można wykorzystać m.in. do:
- filtrowania obiektów położonych w pobliżu danego miasta,
- lokalizacji punktów w obrębie miasta,
- prezentacji danych na mapach,
- prostych analiz przestrzennych.

Dane posiadają klucze możliwe do stworzenia relacji między nimi w bazie danych.

Dane pochodzą z:
- OpenStreetMap (https://nominatim.openstreetmap.org) © współtwórcy OSM, licencja ODbL 1.0: dane lokalizacyjne wyliczane na podstawie boundingbox
- Główny Urząd Statystyczny (https://stat.gov.pl/): baza TERYD (TERC + SIMC) (https://eteryt.stat.gov.pl/eTeryt/rejestr_teryt/udostepnianie_danych/baza_teryt/uzytkownicy_indywidualni/pobieranie/pobieranie.aspx?contrast=default)


## 📦 Instalacja

```bash
npm install polish-cities
```