API

Liczniki ruchu rowerowego

Organizacja: Urząd Miasta Kielce 2 endpointów Nazwa techniczna: bike-counter Wersja: v1 Własne Publiczne

Publiczny dostęp do lokalizacji liczników rowerowych i historycznych pomiarów ruchu.

Tagi

  • Rower
  • Transport i mobilność
Metadane Dostęp, właściciel i zakres publikacji
Organizacja Urząd Miasta Kielce
Źródła danych Eco-Visio Dane pomiarowe z liczników ruchu rowerowego w systemie Eco-Visio.
Typ API Własne
Zasady dostępu Publiczne
Wersja v1
Licencja Creative Commons Attribution 4.0 International
Kategorie Mobilność
Tagi Rower, Transport i mobilność
Zaktualizowano 13 h temu
Publikacja od 2026-08-26 10:16

Dokumentacja

API udostępnia listę liczników oraz godzinowe odczyty zapisane przez moduł Bike Counter. Zakres dat jest interpretowany w przekazanej strefie czasowej, a domyślną strefą jest UTC.

Endpointy API

OpenAPI JSON OpenAPI YAML 2 endpointów
GET /counters Lista liczników json

Zwraca liczniki wraz z lokalizacją WGS 84, dostawcą i zakresem działania.

Metadane publikacyjne danych
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Mobilność
Tagi Rower, Transport i mobilność
Źródła danych Eco-Visio
Wypróbuj endpoint

Endpoint

/api/public/bike-counter/counters?version=v1
Request 
GET /api/public/bike-counter/counters
Response 
[
  {
    "uri": "https://data.example.test/api/public/bike-counter/counters#krakowska",
    "id": "krakowska",
    "name": "Krakowska",
    "provider": "private",
    "externalId": null,
    "location": {"lat": 50.8501, "lon": 20.6154},
    "activeFrom": "2025-11-01T00:00:00+00:00",
    "activeTo": null,
    "lastSynchronizedAt": "2026-08-25T12:00:00+00:00"
  }
]
GET /counters/{counterId}/readings Odczyty licznika json

Zwraca historyczne odczyty wybranego licznika w zadanym zakresie dat.

Metadane publikacyjne danych
Licencja Creative Commons Attribution 4.0 International
Organizacja Urząd Miasta Kielce
Poziom otwartości
Kategorie Mobilność
Tagi Rower, Transport i mobilność
Źródła danych Eco-Visio
Wypróbuj endpoint

Endpoint

/api/public/bike-counter/counters/{counterId}/readings?version=v1

Parametry

Nazwa Położenie Typ Wymaganie Opis przykład
counterId ścieżka string wymagany Identyfikator licznika. krakowska
from query date wymagany Pierwszy dzień zakresu w formacie RRRR-MM-DD. 2026-08-01
to query date wymagany Ostatni dzień zakresu w formacie RRRR-MM-DD. 2026-08-02
timezone query string opcjonalny Opcjonalna strefa czasowa IANA używana do interpretacji zakresu i prezentacji czasu. Europe/Warsaw
Request 
GET /api/public/bike-counter/counters/krakowska/readings?from=2026-08-01&to=2026-08-02&timezone=Europe/Warsaw
Response 
{
  "uri": "https://data.example.test/api/public/bike-counter/counters/krakowska/readings?from=2026-08-01&to=2026-08-02",
  "counterUri": "https://data.example.test/api/public/bike-counter/counters#krakowska",
  "counterId": "krakowska",
  "readings": [
    {"readAt": "2026-08-01T12:00:00+02:00", "value": 42}
  ]
}