API to get alerts and jams

आपको इस सप्ताह भेजने के लिए लाइव ट्रैफिक डेटा की आवश्यकता है: दुर्घटनाओं, खतरों, पुलिस, सड़क बंद होने और आपके सेवा क्षेत्र को प्रभावित करने वाले सटीक जाम के लिए अलर्ट। इस गाइड के अंत तक, आप एक वास्तविक एंडपॉइंट को क्वेरी करेंगे जो एक बाउंडिंग बॉक्स के लिए Waze अलर्ट और जाम लौटाता है, परिणामों को पार्स करेंगे, और उन्हें रूटिंग, ETA और घटना डैशबोर्ड में एकीकृत करने के लिए तैयार होंगे।

यह API आपको क्या देती है

Zyla API Hub पर Waze डेटा API वास्तविक समय की ट्रैफिक इंटेलिजेंस सीधे Waze से लौटाता है, जो इस पर केंद्रित है:

• अलर्ट: दुर्घटनाएं, सड़क बंद, खतरे, पुलिस, और अधिक।
• जाम: आपके चयनित आयत के भीतर भीड़भाड़ की घटनाएं।
• रूटिंग: संभावित मार्गों के साथ अलर्ट के लिए ड्राइविंग निर्देशों के लिए वैकल्पिक एंडपॉइंट।

सामान्य उपयोगों में सेवा डिस्पैच, गतिशील ETA, ट्रैफिक-जानकारी वाले नोटिफिकेशन, ड्राइवर रूटिंग UI, और शहर संचालन डैशबोर्ड शामिल हैं। सब कुछ एक ही Zyla खाते और API कुंजी पर चलता है, जिसमें सब्सक्रिप्शन + कोटा बिलिंग (पे-पर-कॉल नहीं)। आप इसके मार्केटप्लेस पृष्ठ से इस API का 7-दिन का परीक्षण शुरू कर सकते हैं।

Zyla API Hub पर शुरुआत करना

API कुंजी प्राप्त करने और अपना पहला कॉल करने के लिए:

1. API लिस्टिंग खोलें और अपना परीक्षण शुरू करें: Waze डेटा API पर 7-दिन का परीक्षण शुरू करें.
2. सब्सक्राइब पर क्लिक करें या मुफ्त परीक्षण शुरू करें (जब उपलब्ध हो) और अपनी API कुंजी कॉपी करें।
3. Authorization: Bearer YOUR_API_KEY का उपयोग करके नीचे दस्तावेज़ किए गए एंडपॉइंट्स को कॉल करें।

Zyla API Hub एक ही सब्सक्रिप्शन मॉडल और एक API कुंजी के तहत 10,000 से अधिक सार्वजनिक APIs की मेज़बानी करता है। आप बाद में बिना अपने ऑथ सेटअप को बदले अन्य ट्रैफिक, मैपिंग, या उपयोगिता APIs जोड़ सकते हैं।

एंडपॉइंट: अलर्ट और जाम

इस एंडपॉइंट का उपयोग एक भौगोलिक आयत के लिए वास्तविक समय के अलर्ट और जाम लाने के लिए करें जिसे नीचे-बाएं और ऊपर-दाएं अक्षांश/देशांतर जोड़ों द्वारा परिभाषित किया गया है।

• विधि: GET
• URL: https://zylalabs.com/api/4814/waze-data-api/6003/alerts-and-jams
• विवरण: नीचे-बाएं और ऊपर-दाएं अक्षांश, देशांतर जोड़ों द्वारा एक भौगोलिक आयत से Waze से वास्तविक समय के अलर्ट डेटा और जाम जानकारी प्राप्त करें। सभी Waze अलर्ट प्रकारों का समर्थन करता है जिसमें दुर्घटनाएं, सड़क ब्लॉक, खतरे, ट्रैफिक जाम, पुलिस, और अधिक शामिल हैं।

आवश्यक क्वेरी पैरामीटर

• bottom_left (string, आवश्यक): 51.2800,-0.5100
• top_right (string, आवश्यक): 51.5000,-0.0800

वैकल्पिक क्वेरी पैरामीटर

• max_alerts (string, वैकल्पिक): 100
• max_jams (string, वैकल्पिक): 0

cURL उदाहरण (कॉपी-पेस्ट)

curl -s -X GET "https://zylalabs.com/api/4814/waze-data-api/6003/alerts-and-jams?bottom_left=51.2800%2C-0.5100&top_right=51.5000%2C-0.0800&max_alerts=100&max_jams=0" \
-H "Authorization: Bearer YOUR_API_KEY"

आधिकारिक नमूना प्रतिक्रिया

{
"status": "OK",
"request_id": "86b7f40f-b386-4aee-af95-274974d93184",
"parameters": {
"bottom_left": [
"51.2800",
"-0.5100"
],
"top_right": [
"51.5000",
"-0.0800"
],
"max_alerts": 100,
"max_jams": 0
},
"data": {
"alerts": [
{
"alert_id": "alert-1851823848/7b5e52cb-9549-4955-a117-ce19dd01fe9b",
"type": "HAZARD",
"subtype": "HAZARD_ON_ROAD_CONSTRUCTION",
"reported_by": "Causeway one.network",
"description": ".",
"image": null,
"publish_datetime_utc": "2026-07-22T08:30:00.000Z",
"country": "GB",
"city": "Mole Valley",
"street": null,
"latitude": 51.281508,
"longitude": -0.369863,
"num_thumbs_up": 7,
"alert_reliability": 0,
"alert_confidence": 0,
"near_by": null,
"provider": "Elgin (Road works)",
"provider_id": "151505923",
"comments": [],
"num_comments": 0
},
{
"alert_id": "alert-1191763163/60f6957d-0668-49d6-b43f-710177584187",
"type": "HAZARD",
"subtype": "HAZARD_ON_ROAD_CONSTRUCTION",
"reported_by": "Causeway one.network",
"description": ".",
"image": null,
"publish_datetime_utc": "2026-05-15T13:00:00.000Z",
"country": "GB",
"city": "Mole Valley",
"street": "Durleston Park Dr",
"latitude": 51.280691,
"longitude": -0.365612,
"num_thumbs_up": 39,
"alert_reliability": 0,
"alert_confidence": 0,
"near_by": null,
"provider": "Elgin (Road works)",
"provider_id": "149944301",
"comments": [],
"num_comments": 0
},
{
"alert_id": "alert-1618880859/60722796-8030-486e-913c-4e683837b754",
"type": "ROAD_CLOSED",
"subtype": null,
"reported_by": "ClosureMonitor",
"description": "Closed until Jul 31 for roadworks. Ref #151583431",
"image": null,
"publish_…

आप वास्तव में क्या उपयोग करेंगे:

• status और request_id अनुरोध ट्रैकिंग और त्रुटि हैंडलिंग के लिए।
• parameters क्वेरी आयत और लागू किसी भी कैप की पुष्टि करने के लिए।
• data.alerts[n] फ़ील्ड मैपिंग और नोटिफिकेशन के लिए:
  • alert_id: डुप्लिकेशन के लिए अद्वितीय पहचानकर्ता।
  • type और subtype: घटनाओं को वर्गीकृत करें (जैसे, HAZARD, ROAD_CLOSED)।
  • publish_datetime_utc: अलर्ट की ताजगी के लिए ISO 8601 UTC टाइमस्टैम्प।
  • latitude, longitude: आपके मानचित्र परतों के लिए WGS84 समन्वय।
  • city, street, country: UI के लिए टेक्स्ट लेबल।
  • num_thumbs_up: त्वरित सामुदायिक विश्वास संकेत।

Python उदाहरण: अलर्ट लाना और फ़िल्टर करना

नीचे दिया गया स्निपेट उसी अलर्ट और जाम एंडपॉइंट को क्वेरी करता है, कोर फ़ील्ड्स को निकालता है, और बंद होने और खतरों के लिए फ़िल्टर करता है। चलाने से पहले YOUR_API_KEY को बदलें।

import os
import requests
from datetime import datetime, timezone

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/4814/waze-data-api/6003/alerts-and-jams"

params = {
"bottom_left": "51.2800,-0.5100",
"top_right": "51.5000,-0.0800",
"max_alerts": "100",
"max_jams": "0",
}

headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(URL, headers=headers, params=params, timeout=30)
resp.raise_for_status()
payload = resp.json()

if payload.get("status") != "OK":
raise SystemExit(f"API error: {payload}")

alerts = payload.get("data", {}).get("alerts", [])

def parse_iso_utc(ts):
# publish_datetime_utc is ISO 8601 with Z
try:
return datetime.fromisoformat(ts.replace("Z", "+00:00"))
except Exception:
return None

# Example: focus on closures and hazards from the last 24 hours
now = datetime.now(timezone.utc)
recent = []
for a in alerts:
ts = parse_iso_utc(a.get("publish_datetime_utc"))
if ts and (now - ts).total_seconds() <= 24 * 3600:
if a.get("type") in {"ROAD_CLOSED", "HAZARD"}:
recent.append({
"alert_id": a.get("alert_id"),
"type": a.get("type"),
"subtype": a.get("subtype"),
"city": a.get("city"),
"street": a.get("street"),
"lat": a.get("latitude"),
"lon": a.get("longitude"),
"published": a.get("publish_datetime_utc"),
"thumbs": a.get("num_thumbs_up"),
})

for r in recent:
print(f"[{r['published']}] {r['type']} ({r['subtype']}) at {r['lat']},{r['lon']} - {r['city']} {r['street'] or ''} (id={r['alert_id']}, 👍{r['thumbs']})")

पैरामीटर और डेटा हैंडलिंग नोट्स

• समन्वय अक्षांश, देशांतर जोड़े (WGS84) हैं। API अपेक्षा करता है कि bottom_left और top_right एक मान्य आयत बनाते हैं।
• max_alerts और max_jams आपको परिणामों को कैप करने देते हैं यदि आप घने मानचित्र पर रेंडर कर रहे हैं। जब लिस्टिंग दस्तावेज़ द्वारा समर्थित हो, तो एक श्रेणी को अक्षम करने के लिए 0 पर सेट करें (जैसे, max_jams=0 में नमूना)।
• टाइमस्टैम्प UTC (Z-संलग्नक) के रूप में लौटाए जाते हैं। ISO 8601 के रूप में पार्स करें।
• डैशबोर्ड के लिए, प्रतिक्रियाओं को संक्षिप्त रूप से कैश करें (जैसे, 30–60 सेकंड) ताकि ताज़गी बनी रहे। हमेशा लॉग में कहीं भी request_id प्रदर्शित करें ताकि मुद्दों का पता लगाया जा सके।

एंडपॉइंट: ड्राइविंग निर्देश (मार्ग के साथ अलर्ट)

वैकल्पिक रूप से, दो समन्वयों के बीच संभावित मार्गों और प्रत्येक मार्ग को प्रभावित करने वाले अलर्ट को लाएं। यह तब उपयोगी है जब आप ट्रैफिक-जानकारी वाले रूटिंग या ETA बना रहे हों और उम्मीदवार पथों के साथ जाम और घटनाओं को सतह पर लाने की आवश्यकता हो।

• विधि: GET
• URL: https://zylalabs.com/api/4814/waze-data-api/6004/driving-directions
• विवरण: Waze से मार्ग / ड्राइविंग निर्देश प्राप्त करें, प्रत्येक संभावित मार्ग के साथ अलर्ट सहित। वांछित आगमन समय सेट करने का समर्थन करता है।

आवश्यक क्वेरी पैरामीटर

• source_coordinates (string, आवश्यक): 32.0852999,34.78176759999999
• destination_coordinates (string, आवश्यक): 32.7940463,34.989571

cURL उदाहरण

प्रतिक्रियाओं में मार्ग मेटाडेटा जैसे length_meters और duration_seconds शामिल हैं, और एक अलर्ट्स एरे जिसमें type=JAM और JAM_STAND_STILL_TRAFFIC जैसे आइटम शामिल हैं। इनका उपयोग अपने UI में जोखिम भरे या धीमे खंडों को चिह्नित करने और ट्रैफिक-समायोजित ETA की गणना करने के लिए करें।

व्यावहारिक उपयोग के मामले जिन्हें आप इस सप्ताह भेज सकते हैं

• सेवा क्षेत्र घटना फ़ीड: अपने डिलीवरी/फील्ड ऑप्स आयत के लिए अलर्ट और जाम एंडपॉइंट को पोल करें। ROAD_CLOSED और HAZARD अलर्ट को समन्वय और शहर/सड़क के साथ Slack पर पुश करें।
• ट्रैफिक-जानकारी वाले ETA: ड्राइविंग निर्देशों की duration_seconds को अलर्ट घनत्व के साथ मिलाएं ताकि यह तय किया जा सके कि कब रूट बदलना है या ETA को बफर करना है। ड्राइवर ऐप्स के लिए मार्ग अलर्ट के साथ मार्गों को एनोटेट करें।
• मानचित्र ओवरले: अलर्ट को प्रकार/उपप्रकार के अनुसार आइकनों के साथ बिंदुओं के रूप में चित्रित करें और num_thumbs_up को त्वरित विश्वास संकेत के रूप में प्रदर्शित करें। जाम को खतरों से अलग रंग कोड करें।
• ऑप्स मैट्रिक्स: अपने आयत के भीतर घंटे और प्रकार के अनुसार अलर्ट की गणना को ट्रैक करें ताकि आवर्ती बाधाओं को समझा जा सके (जैसे, निर्माण हॉटस्पॉट)।

AI एजेंटों से MCP के माध्यम से API कॉल करें

आप Zyla के MCP एंडपॉइंट का उपयोग करके AI कोडिंग सहायक या स्वायत्त एजेंटों से लाइव ट्रैफिक कॉल भी व्यवस्थित कर सकते हैं। कोई भी MCP-संगत क्लाइंट (जैसे, Claude Code, Cursor, Windsurf) निम्नलिखित के माध्यम से मार्केटप्लेस उपकरणों तक पहुंच सकता है:

MCP

• अपने क्लाइंट को MCP एंडपॉइंट और अपनी Zyla API कुंजी (जैसा कि आपके खाते में प्रदान किया गया है) के साथ कॉन्फ़िगर करें।
• एजेंट को Waze डेटा API के अलर्ट और जाम या ड्राइविंग निर्देश उपकरणों को कॉल करने दें, ऊपर दिखाए गए समान क्वेरी पैरामीटर पास करते हुए।
• MCP ऑथ और टूल खोज को केंद्रीकृत करता है ताकि आप कोडिंग सत्रों या CI नौकरियों के भीतर ट्रैफिक जांच को स्क्रिप्ट कर सकें बिना HTTP प्लंबिंग को फिर से लागू किए।

समय बचाने वाले एकीकरण संकेत

• बाउंडिंग बॉक्स: अपने सेवा आयत को बाजार या डिपो द्वारा स्टोर करें, और कॉल करने से पहले validate करें कि bottom_left.lat < top_right.lat और bottom_left.lon < top_right.lon है।
• डुप्लिकेशन: अपने डेटाबेस या कैश में स्थिर कुंजी के रूप में alert_id का उपयोग करें। यदि आप बार-बार पोल करते हैं, तो अपसर्ट करें बजाय जोड़ने के।
• रीफ्रेश कैडेंस: घटनाएं तेजी से विकसित होती हैं; 30–120 सेकंड के अंतराल ताजगी और कोटा को संतुलित करते हैं। बाजार की घनत्व के अनुसार ट्यून करें।
• मानचित्र UX: प्रकार/उपप्रकार को आइकनोग्राफी में परिवर्तित करें। खतरों जैसे HAZARD_ON_ROAD_CONSTRUCTION के लिए, जब आपके संगठन में उपलब्ध हो, तो निर्धारित कार्य कैलेंडर में बंधें।
• त्रुटि हैंडलिंग: स्थिति और request_id लॉग करें। यदि स्थिति ठीक नहीं है, तो पीछे हटें और जिटर के साथ पुनः प्रयास करें।

सुरक्षा और मूल्य निर्धारण नोट्स

• ऑथ: हर अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें।
• बिलिंग: सब्सक्रिप्शन + कोटा, पे-पर-कॉल नहीं। कोई मुफ्त योजना नहीं है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
• परीक्षण: Waze डेटा API लिस्टिंग एक 7-दिन का परीक्षण प्रदान करती है जिसे आप आइटम पृष्ठ से शुरू कर सकते हैं।

अगले कदम

यदि आपको अलर्ट और जाम प्राप्त करने के लिए एक API की आवश्यकता है, तो आप आज ही आयत क्वेरी लागू कर सकते हैं और मिनटों में अपने पहले घटनाओं को प्रदर्शित कर सकते हैं। अपना खाता बनाएं, सब्सक्राइब करें, और अपने सेवा या एजेंट कार्यप्रवाह से एंडपॉइंट्स को कॉल करें। यहाँ से शुरू करें: Waze डेटा API पर 7-दिन का परीक्षण शुरू करें.

FAQ

API किस समन्वय प्रारूप की अपेक्षा करता है?
अक्षांश, देशांतर जोड़े (WGS84) स्ट्रिंग के रूप में, दोनों bottom_left और top_right के लिए। उदाहरण: 51.2800,-0.5100।

यदि एक आयत घनी है तो मैं परिणामों को कैसे सीमित करूं?
max_alerts और max_jams का उपयोग करें लौटाए गए आइटम को कैप करने के लिए, जैसा कि cURL उदाहरण में दिखाया गया है।

टाइमस्टैम्प किस समय क्षेत्र में हैं?
publish_datetime_utc UTC में है और ISO 8601 के रूप में स्वरूपित है (जैसे, 2026-07-22T08:30:00.000Z)। तदनुसार पार्स करें।

क्या मैं एक मार्ग के साथ अलर्ट प्राप्त कर सकता हूँ बजाय आयत के?
हाँ। स्रोत और गंतव्य समन्वय के बीच उन मार्गों और अलर्ट को प्राप्त करने के लिए ड्राइविंग निर्देश एंडपॉइंट का उपयोग करें।

मैं अपनी API कुंजी और योजना का प्रबंधन कहाँ करूं?
Zyla API Hub लिस्टिंग और आपके खाते के डैशबोर्ड पर। 7-दिन का परीक्षण शुरू करने, कोटा की समीक्षा करने और अपनी कुंजी प्राप्त करने के लिए लिस्टिंग पृष्ठ का उपयोग करें।