Waze API | Waze Scraper

Get driving directions, autocomplete/type-ahead functionality and fetch all types of Waze alerts in real-time including accidents, hazards, traffic jams, police, and more.

原始信息汇总

数据集概述

Waze API | Waze Scraper 是一个提供实时交通数据和路线规划功能的REST API，由开发者 cavsn 创建，归类于交通（Transportation）类别。该API旨在为开发者提供实时道路情报，包括交通警报、拥堵、路线和地点搜索等信息，适用于地图增强、物流调度、导航应用、移动出行仪表盘、配送工作流及基于位置的产品开发。

核心功能

• 实时警报与拥堵查询：通过地理区域（bounding box或中心点+半径）获取Waze实时道路警报（如事故、危险、警察、道路封闭）和交通拥堵信息。
• 驾驶路线规划：获取起点和终点之间的路线方案，包含距离、预计时长、交通标签、收费/HOV标识以及可选的路线几何坐标。
• 地点搜索与自动补全：提供地点和位置的自动补全搜索功能，支持语言和区域偏好。
• 场所详情查询：根据地点搜索结果中的 venue_id 获取具体场所的详细信息。

端点说明

端点	方法	功能
/waze/alerts-and-jams	GET	获取指定区域内的实时警报和交通拥堵
/waze/driving-directions	GET	获取两点之间的驾驶路线、时长和距离
/waze/location-search（别名：/waze/autocomplete）	GET	地点搜索与自动补全建议
/waze/venues/{venue_id}	GET	获取特定场所的详情信息

主要参数

• 区域参数（用于警报/拥堵）：支持 bottom_left + top_right（边界框）或 center + radius（中心点+半径）两种方式。
• 路线参数（用于路线规划）：source_coordinates 和 destination_coordinates（必填），可选 return_route_coordinates、arrival_timestamp、n_paths、avoid_toll_roads、avoid_ferries 等。
• 通用参数：env（区域提示，支持 na、row、il），以及各端点特定的筛选/限制参数（如 max_alerts、max_jams、alert_types、alert_subtypes、limit、lang 等）。

认证方式

使用 RapidAPI 标准凭据，每个请求需包含以下请求头：

• X-RapidAPI-Key: YOUR_RAPIDAPI_KEY
• X-RapidAPI-Host: YOUR_RAPIDAPI_HOST

响应格式

• 成功响应：返回 status: "OK"，数据以JSON格式呈现。
• 错误响应：返回统一的JSON错误结构，包含 status: "ERROR"、error 和 message 字段。

应用场景

• 实时交通事件地图
• 事故、危险、警察、道路封闭监控
• 仪表盘和运营中心的交通拥堵叠加层
• 路线ETA和距离检查
• 带可选路线几何的地图渲染路线方案
• 地点和位置自动补全
• 场所信息丰富化工作流
• 车队、快递、配送和现场服务路线工具

定价方案

方案	价格
BASIC	$0.00 / 月
PRO	$19.99 / 月
ULTRA	$39.99 / 月
MEGA	$129.99 / 月

使用建议

• 使用小范围、聚焦的地理区域进行警报和拥堵查询，以获得更精准的数据。
• 需要在地图上绘制路线时，启用 return_route_coordinates=true。
• 通过 alert_types 参数筛选所需的警报类别。
• 已知区域时使用 env 参数优化响应。
• 在应用中缓存稳定的UI数据，仅在需要时效性数据时请求实时交通信息。