API ruchu i korków
Publiczne API RoadPilota udostępnia korki i zdarzenia na drogach (z jazdy kierowców, pętli indukcyjnych i zgłoszeń) w obszarze, który podasz. Faza 1 jest tylko do odczytu — wkład danych i SDK mobilne są w planie (niżej).
Zaczynamy
- Klucz API — napisz do nas po klucz (
rpk_…). Przekazujesz go w nagłówkuX-Api-Key. - Adres bazowy:
https://roadpilot.pl/api/v1 - Obszar: parametr
bbox=minLon,minLat,maxLon,maxLat(kolejność jak w GeoJSON). Obszar nie może być zbyt duży (ok. 1,6°). - Limit: 600 zapytań/min na klucz. Dane odświeżają się co ~minutę — nie pytaj częściej niż co 30–60 s.
Punkty końcowe
| Metoda i ścieżka | Zwraca |
|---|---|
GET /traffic?bbox=… | Korki i wolne odcinki (JSON) |
GET /events?bbox=… | Zdarzenia na drogach (JSON) |
GET /traffic.geojson?bbox=… | Korki jako GeoJSON (nakładka na mapę) |
GET /events.geojson?bbox=… | Zdarzenia jako GeoJSON |
POST /traffic/route | Korki na Twojej trasie: odcinki (km od startu) i łączne opóźnienie |
Przykładowe odpowiedzi
/traffic — level: slow (wolniej) lub jam (korek); kmh — prędkość, hdg — kierunek (stopnie).
{
"updated": 1760899200,
"cells": [
{ "lat": 52.231, "lon": 21.006, "hdg": 95, "kmh": 8, "level": "jam" }
]
}
/events — type: jam, roadworks, police, inspection, closure; t — czas zgłoszenia (unix s).
{
"updated": 1760899200,
"events": [
{ "type": "roadworks", "lat": 52.10, "lon": 21.00, "hdg": 180, "t": 1760898000 }
]
}
Ruch na trasie
Wyślij swoją trasę jako listę punktów [lat, lon] (2–5000 punktów, do 1500 km). Dostaniesz odcinki z korkiem
z kilometrem od startu i łączne opóźnienie — to samo liczenie, którego używa nawigacja RoadPilot.
curl -X POST -H "X-Api-Key: rpk_twoj_klucz" -H "Content-Type: application/json" \
-d '{"points":[[52.18,20.88],[52.06,20.2],[51.84,19.45]]}' \
"https://roadpilot.pl/api/v1/traffic/route"
{ "updated": 1760899200, "delayMin": 6.5,
"sections": [ { "fromKm": 41.2, "toKm": 44.0, "kmh": 18, "delayMin": 6.5, "level": 3, "cause": "jam", "reason": null } ] }
curl
curl -H "X-Api-Key: rpk_twoj_klucz" \
"https://roadpilot.pl/api/v1/traffic?bbox=20.9,52.15,21.15,52.35"
SDK JavaScript
Bez zależności, działa w przeglądarce i w bundlerze. Dołącz plik:
<script src="https://roadpilot.pl/traffic-sdk.js"></script>
<script>
const traffic = RoadPilotTraffic.create({ apiKey: "rpk_twoj_klucz" });
const bbox = [20.9, 52.15, 21.15, 52.35]; // minLon, minLat, maxLon, maxLat
const { cells } = await traffic.traffic(bbox);
console.log(cells.length + " komórek ruchu");
</script>
Na mapie — Leaflet
const traffic = RoadPilotTraffic.create({ apiKey: "rpk_twoj_klucz" });
const layer = L.geoJSON(null, {
pointToLayer: (f, latlng) => L.circleMarker(latlng, {
radius: 5, color: f.properties.level === "jam" ? "#e23" : "#f90",
}),
}).addTo(map);
async function refresh() {
const b = map.getBounds();
const fc = await traffic.trafficGeoJSON([b.getWest(), b.getSouth(), b.getEast(), b.getNorth()]);
layer.clearLayers(); layer.addData(fc);
}
map.on("moveend", refresh); refresh();
Na mapie — MapLibre GL
const traffic = RoadPilotTraffic.create({ apiKey: "rpk_twoj_klucz" });
map.addSource("rp-traffic", { type: "geojson", data: { type: "FeatureCollection", features: [] } });
map.addLayer({ id: "rp-traffic", type: "circle", source: "rp-traffic",
paint: { "circle-radius": 5,
"circle-color": ["match", ["get", "level"], "jam", "#e23", "#f90"] } });
async function refresh() {
const b = map.getBounds();
const fc = await traffic.trafficGeoJSON([b.getWest(), b.getSouth(), b.getEast(), b.getNorth()]);
map.getSource("rp-traffic").setData(fc);
}
map.on("moveend", refresh); map.on("load", refresh);
Prywatność i zasady
Oddajemy wyłącznie zagregowane korki i zdarzenia — bez śladów, bez danych pojedynczych kierowców. Nie pokazuj klucza API w publicznym kodzie aplikacji mobilnej bez proxy po swojej stronie. Dane służą do informowania o ruchu; nie gwarantujemy ich kompletności.
Wkład sond (Faza 2)
Z kluczem typu contributor Twoja aplikacja może dokładać sondy ruchu — zasada wzajemności: kto dokłada, czyta
gęstsze dane. Wysyłaj tylko za zgodą użytkownika, bez identyfikatorów. Sonda: { lat, lon, t(unix s), spd(m/s), hdg }.
Serwer odrzuca sondy spoza obszaru, przeterminowane i o niemożliwej prędkości; po agregacji surowe sondy są kasowane.
const traffic = RoadPilotTraffic.create({ apiKey: "rpk_contributor_klucz" });
const { accepted, dropped } = await traffic.sendProbes([
{ lat: 52.231, lon: 21.006, t: Math.floor(Date.now()/1000), spd: 8.3, hdg: 95 },
]);
curl -X POST -H "X-Api-Key: rpk_contributor_klucz" -H "Content-Type: application/json" \
-d '{"probes":[{"lat":52.231,"lon":21.006,"t":1760899200,"spd":8.3,"hdg":95}]}' \
"https://roadpilot.pl/api/v1/probes"
Co dalej (plan)
- Faza 2+ — fuzja i wzajemność. Ważenie wielu źródeł, reputacja kluczy, rozliczanie wkładu (ile czytasz zależy od tego, ile dokładasz).
- Faza 3 — SDK mobilne. Gotowe biblioteki dla Androida (Kotlin) i iOS (Swift).
Chcesz klucz albo dołączyć jako partner? Napisz do nas ze strony O RoadPilot.