{
  "layerType": "traffic",
  "name": "Live traffic",
  "source": "navvo-user-traffic",
  "tilePattern": "/api/v1/traffic/lines/tiles/{z}/{x}/{y}",
  "summary": "/api/v1/traffic/summary",
  "historicalGrid": "/api/v1/traffic/analysed/grid",
  "refreshSeconds": 60,
  "basisValues": ["current", "historical", "typical", "all-hours-fallback", "none"],
  "legend": {
    "free": { "label": "Free flow", "color": "#2dbe60" },
    "slow": { "label": "Slow", "color": "#f9a825" },
    "heavy": { "label": "Heavy", "color": "#e84b36" },
    "standstill": { "label": "Standstill", "color": "#a01a12" }
  }
}

{
  "source": "navvo-user-traffic",
  "bbox": "35.85,31.90,35.99,31.99",
  "conditions": {
    "hasData": true,
    "basis": "current",
    "sampleCount": 342,
    "sampledSegments": 128,
    "confidence": 1,
    "congestionScore": 0.42,
    "level": "slow",
    "congestion": "moderate",
    "summary": "Slow moving",
    "summaryAr": "حركة بطيئة",
    "breakdown": [
      { "level": "free", "congestion": "light", "segments": 60, "share": 46.9 },
      { "level": "slow", "congestion": "moderate", "segments": 40, "share": 31.2 }
    ]
  },
  "coverage": { "liveSegments": 128, "typicalSegments": null, "hour": 8, "hourSampleCount": null },
  "freshnessAt": "2026-06-09T08:55:00.000Z",
  "freshnessLabel": "From Navvo users",
  "freshnessLabelAr": "من مستخدمي Navvo"
}

{
  "source": "navvo-analysed-traffic",
  "bbox": "28.975,41.035,28.995,41.045",
  "conditions": {
    "hasData": true,
    "basis": "historical",
    "sampleCount": 0,
    "sampledSegments": 0,
    "confidence": 1,
    "congestionScore": 0.45,
    "level": "slow",
    "congestion": "moderate",
    "summary": "Usually moderate traffic at this hour",
    "summaryAr": "ازدحام متوسط عادةً في هذه الساعة",
    "breakdown": [ … ],
    "historical": {
      "country": "TR",
      "dayType": "workday",
      "holiday": null,
      "ramadanPhase": null,
      "occasion": null,
      "expected": { "speedRatio": 0.657, "level": "moderate", "delayPct": 52 },
      "topFactors": [
        { "family": "month", "key": "10", "label": "October", "labelAr": "أكتوبر", "effectPct": -2.2 }
      ],
      "confidence": 1,
      "basis": "local"
    }
  },
  "coverage": { "liveSegments": 0, "typicalSegments": null, "hour": 15, "hourSampleCount": null },
  "freshnessAt": "2026-10-06T09:16:34.000Z",
  "freshnessLabel": "From traffic history — no live data in this view",
  "freshnessLabelAr": "من سجل حركة المرور — لا توجد بيانات حيّة في هذا العرض"
}

curl -s "https://navvo.io/api/v1/traffic/lines/tiles/14/9783/6592" -H "x-api-key: nvvo_YOUR_KEY"

{
  "type": "FeatureCollection",
  "hasData": true,
  "features": [
    {
      "type": "Feature",
      "properties": { "level": "slow", "congestion": "moderate", "color": "#f9a825", "edgeId": "edge-12345", "averageSpeedKph": 22.4, "freeFlowSpeedKph": 50 },
      "geometry": { "type": "LineString", "coordinates": [[35.9106, 31.9539], [35.9121, 31.9558]] }
    }
  ]
}

{
  "layerType": "traffic", "zoom": 14, "capped": false,
  "tilePattern": "/api/v1/traffic/lines/tiles/{z}/{x}/{y}",
  "tiles": [ { "z": 14, "x": 9783, "y": 6592, "url": "/api/v1/traffic/lines/tiles/14/9783/6592" } ]
}

{
  "locations": [ { "lon": 35.91, "lat": 31.95 }, { "lon": 35.95, "lat": 31.99 } ],
  "costing": "auto",
  "departureTime": "2026-06-09T08:30:00.000Z"
}

{
  "locations": [ { "lon": 35.91, "lat": 31.95 }, { "lon": 35.95, "lat": 31.99 } ],
  "shape": [ [35.91, 31.95], [35.917, 31.958], [35.93, 31.972], [35.95, 31.99] ],
  "baseSeconds": 540,
  "costing": "auto"
}

{
  "provider": "navvo-user-traffic-routing",
  "available": true,
  "distanceKm": 6.42,
  "baseDurationSeconds": 540,
  "durationInTrafficSeconds": 637,
  "delaySeconds": 97,
  "departureTime": "2026-06-09T08:30:00.000Z",
  "arrivalTime": "2026-06-09T08:40:37.000Z",
  "traffic": {
    "hasData": true,
    "congestionScore": 0.33,
    "level": "slow",
    "trafficFactor": 1.18,
    "congestedShare": 50
  },
  "segments": {
    "type": "FeatureCollection",
    "features": [
      { "type": "Feature", "properties": { "level": "free", "color": "#1A73E8" }, "geometry": { "type": "LineString", "coordinates": [[35.91, 31.95], [35.92, 31.96]] } },
      { "type": "Feature", "properties": { "level": "slow", "color": "#F9A825" }, "geometry": { "type": "LineString", "coordinates": [[35.92, 31.96], [35.95, 31.99]] } }
    ]
  },
  "legend": { "free": { "label": "Free", "color": "#1A73E8" }, "slow": { "label": "Slow", "color": "#F9A825" } }
}

{
  "source": "navvo-analysed-traffic",
  "at": "2026-10-08T14:00:00.000Z",
  "country": "JO",
  "local": {
    "date": "2026-10-08", "time": "17:00", "weekday": "Thursday", "tz": "Asia/Amman",
    "dayType": "workday", "dayRole": "last_workday",
    "holiday": null, "eve": null, "ramadan": null,
    "schoolBreak": false, "approximate": true
  },
  "weather": { "class": "rain", "source": "forecast" },
  "expected": { "speedRatio": 0.48, "level": "heavy", "delayPct": 108 },
  "factors": [
    { "family": "weather", "key": "rain", "effectPct": -14.2, "label": "Rain", "labelAr": "مطر" },
    { "family": "month", "key": "10", "effectPct": -1.5, "label": "October", "labelAr": "أكتوبر" }
  ],
  "basis": "metro",
  "confidence": 0.58,
  "model": { "runId": 12, "trainedAt": "2026-10-06T09:12:00.000Z" }
}

{
  "source": "navvo-analysed-traffic",
  "country": "JO", "tz": "Asia/Amman", "from": "2026-10-06",
  "basis": "metro", "confidence": 0.55,
  "weather": { "source": "forecast", "note": "Forecast weather is applied to the next 72 hours only." },
  "model": { "runId": 12, "trainedAt": "2026-10-06T09:12:00.000Z" },
  "days": [
    {
      "date": "2026-10-06", "weekday": "Tuesday", "dayType": "workday", "dayRole": "workday_3",
      "holiday": null, "eve": null, "ramadan": null,
      "best":  { "from": "10:00", "to": "12:00", "startHour": 10, "speedRatio": 0.81, "level": "light", "delayPct": 23 },
      "worst": { "from": "16:00", "to": "18:00", "startHour": 16, "speedRatio": 0.47, "level": "heavy", "delayPct": 113 },
      "hours": [
        { "hour": 0, "speedRatio": 0.93, "level": "free", "delayPct": 8, "weather": "clear" }
      ]
    }
  ]
}

curl -s "https://navvo.io/api/v1/traffic/analysed/grid?bbox=28.975,41.035,28.995,41.045" -H "x-api-key: nvvo_YOUR_KEY"

{
  "source": "navvo-analysed-traffic",
  "at": "2026-10-06T12:45:00.000Z",
  "precision": 6,
  "extent": [28.970947, 41.033936, 29.003906, 41.050415],
  "cellSize": { "lngDeg": 0.010986328125, "latDeg": 0.0054931640625 },
  "truncated": false,
  "country": "TR",
  "countries": ["TR"],
  "local": { "date": "2026-10-06", "time": "15:45", "dayType": "workday", "holiday": null, "ramadan": null },
  "weather": { "class": "clear", "source": "forecast" },
  "cells": [
    { "g": "sxk97q", "ratio": 0.541, "level": "moderate", "liveLevel": "slow", "basis": "local" },
    { "g": "sxk97w", "ratio": 0.637, "level": "moderate", "liveLevel": "slow", "basis": "local" },
    { "g": "sxk97y", "ratio": 0.435, "level": "heavy", "liveLevel": "heavy", "basis": "local" },
    { "g": "sxk97r", "ratio": 0.591, "level": "moderate", "liveLevel": "slow", "basis": "local" },
    { "g": "sxk97x", "ratio": 0.657, "level": "moderate", "liveLevel": "slow", "basis": "local" },
    { "g": "sxk97z", "ratio": 0.503, "level": "moderate", "liveLevel": "slow", "basis": "local" },
    { "g": "sxk9e2", "ratio": 0.72, "level": "light", "liveLevel": "slow", "basis": "local" },
    { "g": "sxk9e8", "ratio": 0.549, "level": "moderate", "liveLevel": "slow", "basis": "local" },
    { "g": "sxk9eb", "ratio": 0.519, "level": "moderate", "liveLevel": "slow", "basis": "local" }
  ],
  "basis": "local"
}

{
  "source": "navvo-analysed-traffic",
  "country": "JO", "scope": "cc:JO", "date": "2026-10-08", "lang": "ar",
  "text": "عمّان، الخميس 8 أكتوبر: يوم عمل عادي. يُتوقع أن تكون الطرق أكثر ازدحاماً حوالي الساعة 08:00 (ازدحام متوسط) و16:00 (ازدحام شديد)، وهو قريب من يوم الخميس المعتاد.",
  "facts": {
    "city": "Amman", "date": "2026-10-08", "weekday": "Thursday", "dayType": "workday",
    "holiday": null, "eve": null, "iftar": null,
    "busiest": [
      { "time": "08:00", "hour": 8, "level": "moderate", "delayPct": 54 },
      { "time": "16:00", "hour": 16, "level": "heavy", "delayPct": 121 }
    ],
    "vsUsualPct": 0, "basis": "metro", "confidence": 0.55
  },
  "writer": "template",
  "stored": true,
  "updatedAt": "2026-10-06T23:41:07.000Z"
}

{
  "source": "navvo-analysed-traffic",
  "model": { "runId": 12, "trainedAt": "2026-10-06T09:12:00.000Z" },
  "rows": { "patternBase": 184212, "patternFactors": 96540 },
  "runs": [
    { "id": 12, "kind": "grid", "status": "done", "stats": { "rows": 21800000, "baseRows": 184212, "factorRows": 96540 }, "startedAt": "2026-10-06T08:40:00.000Z", "finishedAt": "2026-10-06T09:12:00.000Z" },
    { "id": 11, "kind": "grid-holdout", "status": "done", "stats": { "validation": { "heldOutFrom": "2024-07-01", "maeSpeedRatio": { "model": 0.061, "hourOfDayOnly": 0.083 } } }, "startedAt": "2026-10-06T07:55:00.000Z", "finishedAt": "2026-10-06T08:31:00.000Z" }
  ]
}

curl -s "https://navvo.io/api/v1/incidents/types" -H "x-api-key: $NAVVO_API_KEY"

{
  "provider": "navvo-incidents", "count": 10, "confirmBumpMinutes": 25, "maxTtlMinutes": 720,
  "types": [
    { "type": "jam", "label": "Traffic jam", "defaultSeverity": 2, "defaultTtlMinutes": 90, "routeBlocking": false },
    { "type": "closure", "label": "Road closure", "defaultSeverity": 4, "defaultTtlMinutes": 240, "routeBlocking": true },
    { "type": "accident", "label": "Accident", "defaultSeverity": 4, "defaultTtlMinutes": 120, "routeBlocking": true }
  ]
}

{
  "total": 1,
  "items": [
    {
      "id": "b1f2c3d4-…",
      "type": "accident",
      "status": "active",
      "location": "POINT(35.9106 31.9539)",
      "title": "Two-car collision",
      "severity": 4,
      "expiresAt": "2026-06-09T10:40:00.000Z",
      "confirmations": 3,
      "rejections": 0
    }
  ],
  "metadata": { "layerType": "incidents", "source": "navvo-incidents", "dataUrl": "/api/v1/incidents/geojson", "hasData": true }
}

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": { "type": "Point", "coordinates": [35.9106, 31.9539] },
      "properties": { "id": "b1f2c3d4-…", "type": "accident", "title": "Two-car collision", "severity": 4, "confirmations": 3, "rejections": 0, "photoUrl": null }
    }
  ],
  "metadata": { "layerType": "incidents", "hasData": true }
}

{ "type": "hazard", "lat": 31.9539, "lng": 35.9106, "title": "Debris on road", "severity": 3, "ttlMinutes": 120, "photoUrl": "https://cdn.example.com/hazard.jpg" }

curl -s -X POST "https://navvo.io/api/v1/incidents/report" \
  -H "x-api-key: $NAVVO_API_KEY" -H "content-type: application/json" \
  -d '{ "type": "jam", "lat": 31.97, "lng": 35.92, "severity": 3, "title": "Heavy traffic" }'

{ "provider": "navvo-incidents", "merged": true, "distanceM": 31, "confirmations": 2, "incident": { } }

{ "vote": "confirm" }

curl -s "https://navvo.io/api/v1/road-edits/geojson?bbox=35.8,31.9,36.0,32.0" \
  -H "x-api-key: $NAVVO_API_KEY"

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": { "type": "LineString", "coordinates": [[35.911, 31.954], [35.912, 31.955]] },
      "properties": {
        "id": "…", "layerType": "road_edits", "editType": "closure", "geometryType": "line",
        "name": "Rainbow St closed", "reason": "construction", "status": "active",
        "severity": 4, "blocksRouting": true,
        "startsAt": null, "endsAt": "2026-07-01T18:00:00.000Z", "permanent": false,
        "color": "#DC2626"
      }
    }
  ],
  "metadata": { "layerType": "road_edits", "name": "Road edits", "source": "navvo-road-edits", "hasData": true }
}