Back to top

See How Viscar Works

Scroll through the data layers a single Viscar route call can return - geometry, traffic-control signs, ETA-aware weather, road-quality scoring, plus a live-traffic layer on the roadmap. The response on the left builds up exactly as it would in your code.

SCROLL TO EXPLORE
POST /dev/v1/routes
200 OK
01 - Route

Origin to Destination

A single POST request returns the snapped route geometry plus distance and duration. Each segment carries its own [[lon, lat], …] coordinate array - drop it straight into Leaflet, Mapbox GL, MapLibre or any client that speaks the GeoJSON coordinate order.

  • Road-snapped geometry between two coordinates
  • Total distance in meters, duration in seconds
  • route_id for the built route
02 - Signs

Traffic Control Along the Route

Stops, signals, give-way, crossings, speed cameras, hazards - pre-filtered for your actual driving direction. A stop on the side street appears; the same node on the through-road is suppressed.

  • Direction-aware filtering - no false stop alerts on through-roads
  • Speed camera enforcement type and posted limit
  • Each sign tagged with its segment sid
03 - Weather

Forecast at the Time You Arrive

Each weather point's reading is projected to the driver's expected arrival time at that point - not "now". In-house risk alerts (rain, snow, slippery road, strong wind, glare, fog, UV) carry severity marks of 1–4.

  • ETA-aware: forecast at now + travel_time_to_this_point
  • 36-hour forecast horizon, points sampled along the route
  • Eight alert types with severity 1–4 (informational → extreme)
04 - Road Quality

Surface Score

Each segment carries a 0–2.0 surface coefficient (avg_score, ≈1.0 = reference baseline) derived from device sensors: smooth highways read above 0.9, rough side streets fall below 0.56. Potholes surface as standalone points, and anomalies as short bad stretches drawn along the route - both anchored by coordinates.

  • Per-segment quality scores, keyed by sid
  • Potholes - point hits anchored by coordinates, each with its sid
  • Anomalies - short bad stretches as a points[] polyline
  • Viscar-derived from sensor analysis - not upstream-attributed
05 - Traffic

Live Traffic Flow

Per-segment congestion deltas keyed off the same sid backbone - free-flow versus current observed speed, with an ETA-aware projection along the route. Not in V1; the response field is reserved and will land in a later release without breaking existing clients.

  • Reserved layer: not in V1 responses yet - it will land as a new default-on block alongside weather and quality
  • Same sid join as quality, so existing client code maps over without restructuring
  • Slot in the contract is pre-allocated - adding the block won't bump the API version
01 - Route
02 - Signs
03 - Weather
04 - Road Quality
05 - Traffic
Computed route
Inline [[lon, lat], …] per segment
STOP Stop / All-way stop
Pedestrian crossing
55 Speed camera (with maxspeed)
CAM Red-light camera
Traffic signals
Red-light camera = speed_camera + cam_enforcement: "red_light"
Clear / Sun
Rain / Snow
Strong wind
! Severity alert (mark 1–4)
Excellent (8.5–10)
Fair (4.5–8.5)
Poor (under 4.5)
Pothole (point hit)
Anomaly (bad stretch)
Numbers show segment scores
Traffic layer is on the roadmap - visualization will land when the data does.

One endpoint. Four data layers. Whatever you need.

Pick only the layers your product actually uses - the response carries no dead weight.

Welcome back
Sign in to your Viscar account
Create account
Start navigating smarter today
Min 8 characters, uppercase, number, symbol
Verify your email
We sent a 6-digit code to your email
Didn't get the code?
Reset password
Enter your email to receive a reset code
Enter reset code
Check your email for the 6-digit code
Didn't get the code?
New password
Choose a strong password for your account
Min 8 characters, uppercase, number, symbol