API

Kielecki Rower Miejski

Organizacja: Urząd Miasta Kielce 5 endpointów Nazwa techniczna: roovee Wersja: v1 Własne Publiczne

Publiczny dostęp do zsynchronizowanych danych systemu Kieleckiego Roweru Miejskiego.

Tagi

  • Rower
  • Transport i mobilność
Metadane Dostęp, właściciel i zakres publikacji
Organizacja Urząd Miasta Kielce
Źródła danych Roovee Dane z systemu miejskiego roweru Roovee.
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:17

Dokumentacja

API udostępnia lokalnie zapisany wykaz rowerów i stref, statystyki sezonów, zanonimizowane przejazdy oraz dane mapy na żywo z publicznego API Roovee. Nie udostępnia tras, usterek ani opłat.

Endpointy API

OpenAPI JSON OpenAPI YAML 5 endpointów
GET /bikes Wykaz rowerów json

Zwraca publiczne numery rowerów i przypisane typy bez danych o bieżącym położeniu i stanie operacyjnym.

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 Roovee
Wypróbuj endpoint

Endpoint

/api/public/roovee/bikes?version=v1
Request 
GET /api/public/roovee/bikes
Response 
[
  {"uri": "https://data.example.test/api/public/roovee/bikes#10001", "number": "10001", "type": "Standard"}
]
GET /zones Strefy rowerowe json

Zwraca zapisane strefy wraz z okresem aktywności i punktem WGS 84.

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 Roovee
Wypróbuj endpoint

Endpoint

/api/public/roovee/zones?version=v1
Request 
GET /api/public/roovee/zones
Response 
[
  {
    "uri": "https://data.example.test/api/public/roovee/zones#0198ef88-9e65-7d2e-83ef-3cb6bf7ff1f0",
    "id": "0198ef88-9e65-7d2e-83ef-3cb6bf7ff1f0",
    "name": "Rynek",
    "activeFrom": "2026-04-01",
    "activeTo": null,
    "temporary": false,
    "location": {"lat": 50.8703, "lon": 20.6275}
  }
]
GET /seasons Statystyki sezonów json

Zwraca roczne statystyki przejazdów, rowerów, stref, dystansu i czasu.

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 Roovee
Wypróbuj endpoint

Endpoint

/api/public/roovee/seasons?version=v1
Request 
GET /api/public/roovee/seasons
Response 
[
  {
    "uri": "https://data.example.test/api/public/roovee/seasons#2026",
    "year": 2026,
    "activeFrom": "2026-04-01",
    "activeTo": "2026-11-01",
    "days": 214,
    "ridesCount": 12000,
    "bikesCount": 300,
    "zonesCount": 61,
    "totalDistanceKm": 24500.5,
    "totalDurationMin": 180000.0,
    "ridesPerDay": 56.1,
    "ridesPerBikePerDay": 0.19,
    "ridesPerStationPerDay": 0.92,
    "distancePerBikePerDayKm": 0.38,
    "durationPerBikePerDayMin": 2.8
  }
]
GET /rides Przejazdy json

Zwraca stronicowaną listę zakończonych przejazdów nieserwisowych wraz z opcjonalną oceną, bez identyfikatorów rowerów, tras i opłat.

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 Roovee
Wypróbuj endpoint

Endpoint

/api/public/roovee/rides?version=v1

Parametry

Nazwa Położenie Typ Wymaganie Opis przykład
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. Zakres może obejmować maksymalnie 366 dni. 2026-08-31
timezone query string opcjonalny Opcjonalna strefa czasowa IANA używana do interpretacji zakresu i prezentacji czasu; domyślnie UTC. Europe/Warsaw
page query integer opcjonalny Numer strony, liczony od 1. 1
pageSize query integer opcjonalny Liczba rekordów na stronie od 1 do 500; domyślnie 100. 100
Request 
GET /api/public/roovee/rides?from=2026-08-01&to=2026-08-31&timezone=Europe/Warsaw&page=1&pageSize=100
Response 
{
  "data": [
    {
      "seasonUri": "https://data.example.test/api/public/roovee/seasons#2026",
      "startedZoneUri": "https://data.example.test/api/public/roovee/zones#0198ef88-9e65-7d2e-83ef-3cb6bf7ff1f0",
      "finishedZoneUri": null,
      "startedAt": "2026-08-01T10:00:00+02:00",
      "finishedAt": "2026-08-01T10:18:00+02:00",
      "seasonYear": 2026,
      "startedZoneId": "0198ef88-9e65-7d2e-83ef-3cb6bf7ff1f0",
      "finishedZoneId": null,
      "distance": 4200,
      "averageSpeed": 14.0,
      "rating": 5
    }
  ],
  "page": 1,
  "pageSize": 100,
  "hasNextPage": false
}
GET /live Mapa na żywo json

Zwraca bieżącą dostępność i położenie publicznych rowerów oraz publiczne strefy, korzystając z jawnego API mapy Roovee.

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 Roovee
Wypróbuj endpoint

Endpoint

/api/public/roovee/live?version=v1
Request 
GET /api/public/roovee/live
Response 
{
  "bikes": [
    {
      "uri": "https://data.example.test/api/public/roovee/bikes#10001",
      "number": "10001",
      "available": true,
      "type": "standard",
      "location": {"lat": 50.8703, "lon": 20.6275}
    }
  ],
  "zones": [
    {
      "name": "Rynek",
      "type": "preferredBikeReturnZone",
      "center": {"lat": 50.8703, "lon": 20.6275},
      "area": []
    }
  ]
}