# Waze Driving Directions

> Waze Driving Directions 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 candidate driving routes from Waze between two coordinates, including travel time, distance, traffic conditions, and real-time alerts along each route.

## Facts

- Endpoint: GET https://agents.openwebninja.com/waze/driving-directions?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-waze-driving-directions-deef04a7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qExhiR0HBLyNrLIYLwJI0

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-waze-driving-directions-deef04a7
```

Example prompt: What are the Waze driving routes from 37.7749,-122.4194 to 34.0522,-118.2437, and can you flag any accidents or road closures along the way? I need to arrive by 6pm today.

## When to prefer this

Choose this endpoint when you need real-time Waze-sourced route data including live alerts (accidents, police, hazards, road closures), traffic labels, toll and HOV metadata, and optional future arrival time planning — especially if you want the community-sourced alert layer that Waze is uniquely known for, rather than generic turn-by-turn navigation from other mapping providers.

## Known failure modes

- Invalid or unparseable coordinate strings return an error
- No routes found between very distant or unroutable coordinate pairs
- Arrival timestamp in the past or too far in the future may produce unexpected results
- Rate limiting or authentication failure from the underlying OpenWeb Ninja proxy
- Waze data unavailable for certain regions or remote areas

## How this service works

Get routes / driving directions from Waze, including alerts along each possible route. Supports setting the wanted arrival time.

## Output

Returns an array of candidate driving routes, each with a human-readable route name, estimated duration in seconds, length in meters, traffic label (e.g. 'heavy traffic'), toll and HOV flags, a danger area flag, whether it is the fastest route, a list of real-time alerts (accidents, hazards, police, road closures, construction), traffic jams, and optionally a full polyline of route coordinates.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source_coordinates",
  "destination_coordinates"
 ],
 "properties": {
  "arrival_timestamp": {
   "type": "number",
   "description": "Unix-timestamp (seconds since epoch) of the arrival time (in case not specified directions will be returned for current time)"
  },
  "source_coordinates": {
   "type": "string",
   "description": "Geographic coordinates (latitude, longitude pair) of the starting point"
  },
  "destination_coordinates": {
   "type": "string",
   "description": "Geographic coordinates (latitude, longitude pair) of the destination"
  },
  "return_route_coordinates": {
   "type": "boolean",
   "description": "Whether to return route coordinate pairs (route_coordinates field)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "jams": {
      "type": "array",
      "items": {
       "type": "object"
      },
      "description": "Traffic jams along the route."
     },
     "alerts": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "type": {
         "type": "string",
         "description": "Alert category. Values include: ACCIDENT, HAZARD, JAM, ROAD_CLOSED, POLICE, CONSTRUCTION, MISC."
        },
        "subtype": {
         "type": "string",
         "nullable": true,
         "description": "More specific alert subtype."
        },
        "alert_id": {
         "type": "string",
         "description": "Unique identifier of the alert."
        },
        "latitude": {
         "type": "number",
         "description": "Latitude of the alert in decimal degrees."
        },
        "longitude": {
         "type": "number",
         "description": "Longitude of the alert in decimal degrees."
        }
       }
      },
      "description": "Alerts along the route."
     },
     "is_hov": {
      "type": "boolean",
      "description": "True when the route uses HOV (carpool) lanes."
     },
     "is_toll": {
      "type": "boolean",
      "description": "True when the route uses toll roads."
     },
     "is_fastest": {
      "type": "boolean",
      "description": "True when this is the fastest of the returned candidate routes."
     },
     "route_name": {
      "type": "string",
      "description": "Human-readable route label as displayed by Waze."
     },
     "length_meters": {
      "type": "integer",
      "description": "Length of the route in meters."
     },
     "traffic_label": {
      "type": "string",
      "description": "Human-readable traffic summary for the route (e.g. 'usual traffic', 'heavy traffic')."
     },
     "duration_seconds": {
      "type": "integer",
      "description": "Estimated travel time in seconds."
     },
     "route_coordinates": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "lat": {
         "type": "number",
         "description": "Latitude in decimal degrees."
        },
        "lon": {
         "type": "number",
         "description": "Longitude in decimal degrees."
        }
       }
      },
      "description": "Polyline of the route. Populated only when return_route_coordinates=true; otherwise an e
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-waze-driving-directions-deef04a7/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)