API

Akty planowania przestrzennego

Organizacja: Urząd Miasta Kielce Endpointy: 6 Nazwa techniczna: planning-act Wersja: v1 Własne Publiczne

Akty planowania i ich opublikowane wersje, dokumenty formalne oraz obiekty przestrzenne. Zakres API obejmuje wyłącznie wersje udostępnione w publicznych, dostępnych plikach GML zbiorów danych.

Tagi

  • MPZP
  • Planowanie przestrzenne

Metadane

Organizacja Urząd Miasta Kielce
Źródła danych ISDP Źródłowy system danych przestrzennych i ewidencyjnych.
Typ API Własne
Zasady dostępu Publiczne
Wersja v1
Licencja Creative Commons Attribution 4.0 International
Kategorie Gospodarka, Mieszkalnictwo, Przestrzeń i geografia
Tagi MPZP, Planowanie przestrzenne
Zaktualizowano 4 h temu
Publikacja od 2026-11-01 01:39

Wywołania całej usługi API

Wczytywanie statystyk…

Podsumowania dzienne · UTC

Dokumentacja

Wersje dostarczane przez dostępne dystrybucje GML w publicznych zbiorach danych. Listy obsługują limit (1–100, domyślnie 25) i offset (domyślnie 0), ze stałą kolejnością. Dla aktu wybierana jest ostatnia opublikowana wersja, a następnie sprawdzany jej stan. Prywatne zbiory i wycofane dystrybucje są pomijane. Geometria ma układ EPSG:4326; brakujące wartości pozostają null. Niepoprawne filtry zwracają 400, a niedostępne szczegóły 404.

Endpointy API

OpenAPI JSON OpenAPI YAML Endpointy: 6
GET /acts Akty planowania przestrzennego json

Ostatnia opublikowana wersja każdego aktu, w kolejności UUID aktów.

Metadane publikacyjne danych
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Gospodarka, Mieszkalnictwo, Przestrzeń i geografia
Tagi MPZP, Planowanie przestrzenne
Źródła danych ISDP
Kontakt smartcity@kielce.eu
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

Endpoint

/api/public/planning-act/acts?version=v1

Parametry

Nazwa Położenie Typ Wymaganie Opis przykład
limit query integer opcjonalny Liczba rekordów: 1–100, domyślnie 25. -
offset query integer opcjonalny Liczba pomijanych rekordów, domyślnie 0. -
actType query string opcjonalny Rodzaj aktu: general_plan, local_spatial_plan lub landscape_resolution. -
lifecycleState query string opcjonalny Stan: effective, in_progress lub obsolete; dla aktów filtruje ostatnią opublikowaną wersję. -
actId query string opcjonalny UUID aktu planowania przestrzennego. -
Request 
GET /api/public/planning-act/acts?limit=25&offset=0
Response 
[
    {
        "uri": "https:\/\/data.example.test\/api\/public\/planning-act\/acts\/01900000-0000-7000-8000-000000000001",
        "id": "01900000-0000-7000-8000-000000000001",
        "namespace": "PL.EXAMPLE",
        "localId": "PLAN_1",
        "actType": "local_spatial_plan",
        "title": "Example planning act",
        "lifecycleState": "effective",
        "latestPublishedVersionId": "01900000-0000-7000-8000-000000000002",
        "latestPublishedVersionUri": "https:\/\/data.example.test\/api\/public\/planning-act\/versions\/01900000-0000-7000-8000-000000000002"
    }
]
GET /acts/{actId} Akt planowania przestrzennego json

Metadane aktu i ostatnia opublikowana wersja.

Metadane publikacyjne danych
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Gospodarka, Mieszkalnictwo, Przestrzeń i geografia
Tagi MPZP, Planowanie przestrzenne
Źródła danych ISDP
Kontakt smartcity@kielce.eu
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

Endpoint

/api/public/planning-act/acts/{actId}?version=v1

Parametry

Nazwa Położenie Typ Wymaganie Opis przykład
actId ścieżka string wymagany UUID aktu planowania przestrzennego. -
Request 
GET /api/public/planning-act/acts/01900000-0000-7000-8000-000000000001
Response 
{
    "uri": "https:\/\/data.example.test\/api\/public\/planning-act\/acts\/01900000-0000-7000-8000-000000000001",
    "id": "01900000-0000-7000-8000-000000000001",
    "namespace": "PL.EXAMPLE",
    "localId": "PLAN_1",
    "actType": "local_spatial_plan",
    "title": "Example planning act",
    "lifecycleState": "effective",
    "latestPublishedVersionId": "01900000-0000-7000-8000-000000000002",
    "latestPublishedVersionUri": "https:\/\/data.example.test\/api\/public\/planning-act\/versions\/01900000-0000-7000-8000-000000000002"
}
GET /versions Opublikowane wersje json

Publiczne wersje w kolejności UUID aktów i wersji.

Metadane publikacyjne danych
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Gospodarka, Mieszkalnictwo, Przestrzeń i geografia
Tagi MPZP, Planowanie przestrzenne
Źródła danych ISDP
Kontakt smartcity@kielce.eu
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

Endpoint

/api/public/planning-act/versions?version=v1

Parametry

Nazwa Położenie Typ Wymaganie Opis przykład
limit query integer opcjonalny Liczba rekordów: 1–100, domyślnie 25. -
offset query integer opcjonalny Liczba pomijanych rekordów, domyślnie 0. -
actType query string opcjonalny Rodzaj aktu: general_plan, local_spatial_plan lub landscape_resolution. -
lifecycleState query string opcjonalny Stan: effective, in_progress lub obsolete; dla aktów filtruje ostatnią opublikowaną wersję. -
actId query string opcjonalny UUID aktu planowania przestrzennego. -
Request 
GET /api/public/planning-act/versions?limit=25&offset=0
Response 
[
    {
        "uri": "https:\/\/data.example.test\/api\/public\/planning-act\/versions\/01900000-0000-7000-8000-000000000002",
        "id": "01900000-0000-7000-8000-000000000002",
        "actId": "01900000-0000-7000-8000-000000000001",
        "actUri": "https:\/\/data.example.test\/api\/public\/planning-act\/acts\/01900000-0000-7000-8000-000000000001",
        "namespace": "PL.EXAMPLE",
        "localId": "PLAN_1",
        "actType": "local_spatial_plan",
        "actIdentifier": "PLAN_1",
        "title": "Example planning act",
        "lifecycleState": "effective",
        "sourceVersion": "2026-01-01",
        "versionStartedAt": "2026-01-01T00:00:00Z",
        "versionEndedAt": null,
        "effectiveFrom": null,
        "effectiveTo": null,
        "changeNumber": null,
        "modification": null
    }
]
GET /versions/{versionId} Opublikowana wersja json

Metadane wersji i daty obowiązywania.

Metadane publikacyjne danych
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Gospodarka, Mieszkalnictwo, Przestrzeń i geografia
Tagi MPZP, Planowanie przestrzenne
Źródła danych ISDP
Kontakt smartcity@kielce.eu
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

Endpoint

/api/public/planning-act/versions/{versionId}?version=v1

Parametry

Nazwa Położenie Typ Wymaganie Opis przykład
versionId ścieżka string wymagany UUID opublikowanej wersji. -
Request 
GET /api/public/planning-act/versions/01900000-0000-7000-8000-000000000002
Response 
{
    "uri": "https:\/\/data.example.test\/api\/public\/planning-act\/versions\/01900000-0000-7000-8000-000000000002",
    "id": "01900000-0000-7000-8000-000000000002",
    "actId": "01900000-0000-7000-8000-000000000001",
    "actUri": "https:\/\/data.example.test\/api\/public\/planning-act\/acts\/01900000-0000-7000-8000-000000000001",
    "namespace": "PL.EXAMPLE",
    "localId": "PLAN_1",
    "actType": "local_spatial_plan",
    "actIdentifier": "PLAN_1",
    "title": "Example planning act",
    "lifecycleState": "effective",
    "sourceVersion": "2026-01-01",
    "versionStartedAt": "2026-01-01T00:00:00Z",
    "versionEndedAt": null,
    "effectiveFrom": null,
    "effectiveTo": null,
    "changeNumber": null,
    "modification": null
}
GET /versions/{versionId}/documents Dokumenty formalne json

Stronicowany wykaz metadanych aktualnych dokumentów formalnych opublikowanej wersji.

Metadane publikacyjne danych
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Gospodarka, Mieszkalnictwo, Przestrzeń i geografia
Tagi MPZP, Planowanie przestrzenne
Źródła danych ISDP
Kontakt smartcity@kielce.eu
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

Endpoint

/api/public/planning-act/versions/{versionId}/documents?version=v1

Parametry

Nazwa Położenie Typ Wymaganie Opis przykład
versionId ścieżka string wymagany UUID opublikowanej wersji. -
limit query integer opcjonalny Liczba rekordów: 1–100, domyślnie 25. -
offset query integer opcjonalny Liczba pomijanych rekordów, domyślnie 0. -
Request 
GET /api/public/planning-act/versions/01900000-0000-7000-8000-000000000002/documents?limit=25&offset=0
Response 
[
    {
        "versionId": "01900000-0000-7000-8000-000000000002",
        "versionUri": "https:\/\/data.example.test\/api\/public\/planning-act\/versions\/01900000-0000-7000-8000-000000000002",
        "gmlId": "DOC_1",
        "externalIdentifier": "PL.EXAMPLE.DOC_1",
        "title": "Example resolution",
        "documentDate": null,
        "documentDateType": null,
        "identificationNumber": null,
        "establishingAuthority": null,
        "role": null
    }
]
GET /versions/{versionId}/features Obiekty przestrzenne json

Stronicowany wykaz aktualnych granic i stref z geometrią w EPSG:4326.

Metadane publikacyjne danych
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Gospodarka, Mieszkalnictwo, Przestrzeń i geografia
Tagi MPZP, Planowanie przestrzenne
Źródła danych ISDP
Kontakt smartcity@kielce.eu
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

Endpoint

/api/public/planning-act/versions/{versionId}/features?version=v1

Parametry

Nazwa Położenie Typ Wymaganie Opis przykład
versionId ścieżka string wymagany UUID opublikowanej wersji. -
limit query integer opcjonalny Liczba rekordów: 1–100, domyślnie 25. -
offset query integer opcjonalny Liczba pomijanych rekordów, domyślnie 0. -
Request 
GET /api/public/planning-act/versions/01900000-0000-7000-8000-000000000002/features?limit=25&offset=0
Response 
[
    {
        "versionId": "01900000-0000-7000-8000-000000000002",
        "versionUri": "https:\/\/data.example.test\/api\/public\/planning-act\/versions\/01900000-0000-7000-8000-000000000002",
        "objectType": "act_boundary",
        "gmlId": "BOUNDARY_1",
        "externalIdentifier": "PL.EXAMPLE.BOUNDARY_1",
        "label": null,
        "designation": null,
        "symbol": null,
        "geometry": null
    }
]