API

Budynki

Organizacja: Urząd Miasta Kielce Endpointy: 1 Nazwa techniczna: budynki Wersja: v1 Własne Publiczne

Obrysy budynków, ich identyfikatory, funkcje, powierzchnie oraz rok zakończenia budowy, jeżeli występuje w źródle. Publiczne API umożliwia stronicowanie, wybór kolumn i filtrowanie po indeksowanych polach.

Wywołania całej usługi API

Wczytywanie statystyk…

Podsumowania dzienne · UTC

Dokumentacja

API udostępnia dane publicznych tabel z obsługą wyboru kolumn, filtrów, sortowania i paginacji.

Endpointy API

GET /budynki_publiczne/data Dane tabeli: Budynki json

Zwraca rekordy publicznej tabeli budynki_publiczne. Obrysy budynków, ich identyfikatory, funkcje, powierzchnie oraz rok zakończenia budowy, jeżeli występuje w źródle.

Metadane publikacyjne danych
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Mieszkalnictwo, Przestrzeń i geografia
Zakres przestrzenny POLYGON((20.51161975 50.79354309,20.71545425 50.79354309,20.71545425 50.91363549,20.51161975 50.91363549,20.51161975 50.79354309))
Źródła danych Ewidencja budynków
Wypróbuj endpoint

Schematy odpowiedzi

Sprawdź udokumentowane schematy odpowiedzi w dokumencie OpenAPI.

Otwórz dokument OpenAPI

Endpoint

/api/public/budynki/budynki_publiczne/data?version=v1

Parametry

Nazwa Położenie Typ Wymaganie Opis przykład
columns query string opcjonalny Opcjonalna lista kolumn rozdzielona przecinkami. Puste oznacza wszystkie publiczne kolumny. id,name
filter[column] query string opcjonalny Filtr po publicznej, indeksowanej kolumnie. Nazwę kolumny podaj w nawiasie, np. filter[status]=active. active
sort query string opcjonalny Sortowanie po publicznej, sortowalnej kolumnie. Prefiks "-" oznacza kolejność malejącą. -updated_at
limit query integer opcjonalny Opcjonalna liczba rekordów od 1 do 1000; domyślnie 100. Zero jest niedozwolone. 100
offset query integer opcjonalny Opcjonalne nieujemne przesunięcie całkowite; domyślnie 0. -
Kolumny 7
Kolumna Typ Opis Semantyka Filtrowanie Sortowanie
Identyfikator budynku identyfikator VARCHAR(100) - - tak tak
Funkcja budynku funkcja VARCHAR(100) - - tak tak
Powierzchnia zabudowy [m²] powierzchnia_zabudowy_m2 DECIMAL(20,4) - - nie nie
Powierzchnia całkowita [m²] powierzchnia_calkowita_m2 DECIMAL(20,4) - - nie nie
Rok zakończenia budowy rok_zakonczenia_budowy INTEGER - - tak tak
Obrys budynku geometry GEOMETRY(MULTIPOLYGON,2178) - - tak nie
URI _uri URL Stable semantic URI generated from the unique table column. Semantyczny identyfikator URI nie nie
Filtry 4
Nazwa Typ Wymaganie Sposób przykład
identyfikator VARCHAR(100) opcjonalny równość (exact) filter[identyfikator]=sample
funkcja VARCHAR(100) opcjonalny równość (exact) filter[funkcja]=sample
rok_zakonczenia_budowy INTEGER opcjonalny zakres: min i/lub max (lub równość) filter[rok_zakonczenia_budowy][min]=10&filter[rok_zakonczenia_budowy][max]=100
geometry GEOMETRY(MULTIPOLYGON,2178) opcjonalny bbox: xmin,ymin,xmax,ymax filter[geometry]=20.58,50.82,20.72,50.90
Request
GET /api/public/budynki/budynki_publiczne/data?columns=identyfikator,funkcja&limit=10&offset=0
Response
{
    "tableName": "budynki_publiczne",
    "columns": [
        {
            "name": "identyfikator",
            "type": "VARCHAR(100)",
            "filterable": true,
            "requiredFilter": false,
            "sortable": true,
            "label": "Identyfikator budynku",
            "description": null,
            "semanticRole": null,
            "semanticPredicate": null
        },
        {
            "name": "funkcja",
            "type": "VARCHAR(100)",
            "filterable": true,
            "requiredFilter": false,
            "sortable": true,
            "label": "Funkcja budynku",
            "description": null,
            "semanticRole": null,
            "semanticPredicate": null
        }
    ],
    "requiredFilters": [],
    "allowedFilters": [
        "identyfikator",
        "funkcja"
    ],
    "pagination": {
        "limit": 10,
        "offset": 0,
        "count": 1,
        "total": 1
    },
    "filters": [],
    "items": [
        {
            "identyfikator": "sample",
            "funkcja": "sample"
        }
    ]
}