API
Budynki
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
| Czas (UTC) | Seria | Wartość |
|---|
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
Wypróbuj endpoint
Schematy odpowiedzi
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"
}
]
}