RoadPilot

API ruchu i korków

Wspólne źródło live traffic dla aplikacji nawigacyjnych — podłącz w kilka linii (web, Android, iOS).

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

Punkty końcowe

Metoda i ścieżkaZwraca
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/routeKorki 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)

Chcesz klucz albo dołączyć jako partner? Napisz do nas ze strony O RoadPilot.