API
Punkty adresowe
Zbiór danych przedstawiający lokalizacje punktów adresowych na terenie Miasta Kielce. Każdy rekord odpowiada jednemu punktowi adresowemu przypisanemu do budynku lub działki, zawiera pełen zapis adresu, numer oraz kod TERYT ulicy. 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
/punkty_adresowe/data
Dane tabeli: Punkty adresowe
json
Zwraca rekordy publicznej tabeli punkty_adresowe. Zbiór danych przedstawiający lokalizacje punktów adresowych na terenie Miasta Kielce. Każdy rekord odpowiada jednemu punktowi adresowemu przypisanemu do budynku lub działki, zawiera pełen zapis adresu, numer oraz kod TERYT ulicy.
Metadane publikacyjne danych
Wypróbuj endpoint
Schematy odpowiedzi
Endpoint
/api/public/punkty-adresowe/punkty_adresowe/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 6
| Kolumna | Typ | Opis | Semantyka | Filtrowanie | Sortowanie |
|---|---|---|---|---|---|
Punkt adresowy: ID
adres_id
|
VARCHAR(20) |
unikalny identyfikator punktu adresowego | - | tak | tak |
Punkt adresowy: Pełna nazwa
adres_pelny
|
VARCHAR(255) |
pełen zapis adresu w formacie tekstowym | - | nie | nie |
Punkt adresowy: Numer
adres_nr
|
VARCHAR(10) |
numer porządkowy budynku przypisany do punktu adresowego. | - | nie | nie |
Ulica: TERYT
ulica_teryt
|
VARCHAR(5) |
kod TERYT ulicy – 5-znakowy identyfikator z rejestru ulic SIMC/ULIC. | - | nie | nie |
Punkt adresowy: Geometria
geometry
|
GEOMETRY(POINT,2178) |
lokalizacja punktu adresowego w przestrzeni | - | tak | nie |
URI
_uri
|
URL |
Stable semantic URI generated from the unique table column. | Semantyczny identyfikator URI | nie | nie |
Filtry 2
| Nazwa | Typ | Wymaganie | Sposób | przykład |
|---|---|---|---|---|
adres_id |
VARCHAR(20) |
opcjonalny | równość (exact) | filter[adres_id]=sample |
geometry |
GEOMETRY(POINT,2178) |
opcjonalny | bbox: xmin,ymin,xmax,ymax | filter[geometry]=20.58,50.82,20.72,50.90 |
GET /api/public/punkty-adresowe/punkty_adresowe/data?columns=adres_id,adres_pelny&limit=10&offset=0
{
"tableName": "punkty_adresowe",
"columns": [
{
"name": "adres_id",
"type": "VARCHAR(20)",
"filterable": true,
"requiredFilter": false,
"sortable": true,
"label": "Punkt adresowy: ID",
"description": "unikalny identyfikator punktu adresowego",
"semanticRole": null,
"semanticPredicate": null
},
{
"name": "adres_pelny",
"type": "VARCHAR(255)",
"filterable": false,
"requiredFilter": false,
"sortable": false,
"label": "Punkt adresowy: Pełna nazwa",
"description": "pełen zapis adresu w formacie tekstowym",
"semanticRole": null,
"semanticPredicate": null
}
],
"requiredFilters": [],
"allowedFilters": [
"adres_id"
],
"pagination": {
"limit": 10,
"offset": 0,
"count": 1,
"total": 1
},
"filters": [],
"items": [
{
"adres_id": "sample",
"adres_pelny": "sample"
}
]
}