# Traffic Alerts - Live Incident Lookup by Bounding Box

> Traffic Alerts - Live Incident Lookup by Bounding Box is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Returns live traffic incidents (accidents, construction, road closures, and generic slowdowns) within a geographic bounding box defined by two corner coordinates and a zoom level.

## Facts

- Endpoint: GET https://agents.openwebninja.com/google-maps-traffic-alerts/traffic-alerts?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-traffic-alerts-live-incident-lookup-by-56b36557
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DGWlLxgXAAAfN8uvw-V8a

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-traffic-alerts-live-incident-lookup-by-56b36557
```

Example prompt: Can you pull up all live traffic incidents — accidents, road closures, and construction zones — for the area from coordinates 40.63,-74.10 (bottom-left) to 40.81,-73.87 (top-right), using zoom level 13?

## When to prefer this

Choose this endpoint when you need real-time, geolocated traffic incident data (accidents, closures, construction) for a specific rectangular area on a map. It is ideal for route planning, logistics monitoring, event management, and map-based dashboards that need structured JSON incident data with precise coordinates. Prefer it over general directions APIs when you specifically need incident awareness rather than turn-by-turn routing.

## Known failure modes

- Bounding box area exceeds the maximum allowed for the chosen zoom level — reduce the box size or lower the zoom
- Invalid coordinate format for bottom_left or top_right — must be 'latitude,longitude' strings
- Zoom level outside allowed range 11–16 — returns validation error
- No incidents found in the area — returns empty alerts array with count of 0
- Upstream Google Maps data unavailable — may return error status

## How this service works

Returns live traffic incidents (accidents, construction zones, road closures, and other slowdowns) within the bounding box defined by two corner coordinates. Each alert includes its incident type and precise latitude/longitude.

The bounding box area is capped per `zoom` level (higher zoom returns finer detail over a smaller maximum area). To scan a larger area, use a lower zoom level.

## Output

A JSON object containing the count of traffic alerts found and an array of incidents, each with an incident type (road_closed, construction, accident, or incident) and precise latitude/longitude coordinates. Also includes echoed request parameters and a unique request ID for tracing.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "bottom_left",
  "top_right"
 ],
 "properties": {
  "zoom": {
   "type": "integer",
   "default": 13,
   "maximum": 16,
   "minimum": 11,
   "description": "Google Maps zoom level for the scan - the same zoom value Google Maps uses (higher is more zoomed in, returning finer detail over a smaller maximum area). Each zoom level has a maximum bounding-box area; to cover a larger area, use a lower zoom level.\n\n  **Allowed values:** `11-16`\n\n  **Maximum area per zoom:**\n\n  - zoom 11: 8000 km²\n  - zoom 12: 2000 km²\n  - zoom 13: 500 km² (default)\n  - zoom 14: 125 km²\n  - zoom 15: 30 km²\n  - zoom 16: 8 km²\n\n  **Default:** `13`"
  },
  "top_right": {
   "type": "string",
   "description": "Top-right (north-east) corner of the area to scan, as `latitude,longitude`. The total box area is capped per `zoom` level (see the `zoom` parameter).\n\n  **Example:** `40.81,-73.87`"
  },
  "bottom_left": {
   "type": "string",
   "description": "Bottom-left (south-west) corner of the area to scan, as `latitude,longitude`. The total box area is capped per `zoom` level (see the `zoom` parameter).\n\n  **Example:** `40.63,-74.10`"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "request_id",
  "parameters",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "count",
    "alerts"
   ],
   "properties": {
    "count": {
     "type": "integer",
     "description": "Number of traffic alerts found within the requested area (the length of the alerts array)."
    },
    "alerts": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "type",
       "latitude",
       "longitude"
      ],
      "properties": {
       "type": {
        "type": "string",
        "description": "Incident type. Values: road_closed, construction, accident, incident (generic incident when a more specific type cannot be determined)."
       },
       "latitude": {
        "type": "number",
        "description": "Latitude of the incident location."
       },
       "longitude": {
        "type": "number",
        "description": "Longitude of the incident location."
       }
      }
     },
     "description": "The traffic incidents detected within the requested area."
    }
   },
   "description": "The traffic alerts found within the requested area."
  },
  "status": {
   "type": "string",
   "description": "The status of the API response."
  },
  "parameters": {
   "type": "object",
   "required": [
    "zoom"
   ],
   "properties": {
    "zoom": {
     "type": "integer",
     "description": "Google Maps zoom level used for the scan."
    },
    "top_right": {
     "type": "string",
     "description": "Top-right (north-east) corner of the scanned area, as received."
    },
    "bottom_left": {
     "type": "string",
     "description": "Bottom-left (south-west) corner of the scanned area, as received."
    }
   },
   "description": "The parameters the API received and used for this request, echoed back."
  },
  "request_id": {
   "type": "string",
   "description": "A unique ID to trace the API request."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-traffic-alerts-live-incident-lookup-by-56b36557/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)