अलर्ट और जाम के लिए API

आपकी टीम को एक विशिष्ट क्षेत्र में Waze-ग्रेड घटना अलर्ट और लाइव ट्रैफिक जाम की आवश्यकता है, और आपको इस सप्ताह इसके खिलाफ शिप करने के लिए एक एंडपॉइंट की आवश्यकता है। इस लेख के अंत तक, आप एक वास्तविक API को क्वेरी करेंगे जो एक बाउंडिंग बॉक्स के लिए Waze अलर्ट और जाम लौटाता है, प्रतिक्रिया को पार्स करेंगे, और समझेंगे कि इसे अपने बैकएंड और AI एजेंटों के माध्यम से MCP से कैसे उपयोग करना है।

आप इस API के साथ क्या बना सकते हैं

Waze डेटा API दो क्षमताओं को उजागर करता है जिनकी डेवलपर्स आमतौर पर मांग करते हैं:

• भौगोलिक आयत में वास्तविक समय के अलर्ट और जाम (दुर्घटनाएँ, सड़क बंद, खतरें, पुलिस, ट्रैफिक जाम, और अधिक) ताकि आप मानचित्र पर घटनाओं को चिह्नित कर सकें, रीरूटिंग को ट्रिगर कर सकें, या फील्ड टीमों को अलर्ट कर सकें।
• उम्मीदवार मार्गों के साथ अलर्ट के साथ ड्राइविंग निर्देश, मार्ग चयन और ETA-संवेदनशील कार्यप्रवाहों को सक्षम करना।

आप इन एंडपॉइंट्स को एकल Zyla API Hub सदस्यता और API कुंजी के माध्यम से कॉल करेंगे। सीधे Waze एकीकरण की आवश्यकता नहीं है।

Zyla API Hub पर शुरू करना

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

Waze डेटा API पर 7-दिन की परीक्षण अवधि शुरू करें

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

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

• विधि: GET
• URL: https://zylalabs.com/api/4814/waze-data-api/6003/alerts-and-jams
• आवश्यक पैरामीटर:
  • bottom_left (string): 51.2800,-0.5100
  • top_right (string): 51.5000,-0.0800
• वैकल्पिक पैरामीटर:
  • max_alerts (string): 100
  • max_jams (string): 0
• प्राधिकरण: Authorization: Bearer YOUR_API_KEY

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।
• यह पुष्टि करने के लिए कि आपका बाउंडिंग बॉक्स और कैप लागू किए गए थे, पैरामीटर।
• data.alerts[] को दोहराने और प्रकार, उपप्रकार, अक्षांश, देशांतर, publish_datetime_utc (UTC टाइमस्टैम्प), शहर, सड़क, और प्रदाता जैसे फ़ील्ड निकालने के लिए।

समय बचाने वाले नोट्स:

• निर्देशांक दशमलव डिग्री हैं जिसमें अक्षांश, देशांतर का क्रम है (जैसे, "51.2800,-0.5100").
• publish_datetime_utc UTC में है। यदि आपका UI स्थानीय समय दिखाता है तो किनारे पर रूपांतरित करें।
• जब max_jams=0 होता है तो आपको जाम नहीं मिलेंगे; यदि आवश्यक हो तो उन्हें शामिल करने के लिए सकारात्मक मान सेट करें।
• यदि आप पोलिंग कर रहे हैं, तो बाउंडिंग बॉक्स द्वारा कैश करें और कोटा उपयोग को नियंत्रित करने के लिए एक छोटा TTL जोड़ें।

Python उदाहरण: अलर्ट प्राप्त करें और उन्हें मानचित्रित करें

यह नमूना अलर्ट और जाम एंडपॉइंट को कॉल करता है, प्रतिक्रिया को पार्स करता है, और प्रति अलर्ट एक संक्षिप्त पंक्ति प्रिंट करता है। YOUR_API_KEY को Zyla API Hub से अपनी कुंजी के साथ बदलें।

import os
import requests

API_KEY = os.getenv("Zyla_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, params=params, headers=headers, timeout=30)
resp.raise_for_status()
payload = resp.json()

if payload.get("status") != "OK":
raise RuntimeError(f"API returned non-OK status: {payload}")

alerts = (payload.get("data") or {}).get("alerts", [])
print(f"received {len(alerts)} alerts")
for a in alerts:
alert_id = a.get("alert_id")
typ = a.get("type")
sub = a.get("subtype")
lat = a.get("latitude")
lng = a.get("longitude")
city = a.get("city")
published_utc = a.get("publish_datetime_utc")
print(f"{published_utc} {typ}/{sub or 'NO_SUBTYPE'} {lat},{lng} {city or '-'} id={alert_id}")

ड्राइविंग निर्देश एंडपॉइंट

जब आपको Waze मार्गों और प्रत्येक मार्ग के साथ अलर्ट की आवश्यकता हो तो इसका उपयोग करें।

• विधि: GET
• URL: https://zylalabs.com/api/4814/waze-data-api/6004/driving-directions
• आवश्यक पैरामीटर:
  • source_coordinates (string): 32.0852999,34.78176759999999
  • destination_coordinates (string): 32.7940463,34.989571
• प्राधिकरण: Authorization: Bearer YOUR_API_KEY

यह उच्च स्तर पर क्या लौटाता है: उम्मीदवार मार्गों का एक सरणी जिसमें मेटाडेटा जैसे route_name, length_meters, duration_seconds, और प्रत्येक मार्ग के लिए प्रकार, उपप्रकार, अक्षांश, और देशांतर के साथ अलर्ट की एक सूची होती है। एंडपॉइंट वांछित आगमन समय को सेट करने का समर्थन करता है जैसा कि विवरण में है; वर्तमान में हब में प्रदर्शित पैरामीटर विकल्पों के लिए API पृष्ठ पर परामर्श करें।

वास्तविक दुनिया के पैटर्न जो शिप होते हैं

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

निर्देशांक और बाउंडिंग बॉक्स के साथ काम करना

• bottom_left और top_right स्ट्रिंग्स हैं "lat,lon"। क्रम को अक्षांश पहले, देशांतर दूसरे के रूप में रखें।
• सुनिश्चित करें कि आपका बॉक्स उलटा नहीं है; अक्षांश उत्तर की ओर बढ़ता है, देशांतर पूर्व की ओर बढ़ता है।
• बड़े शहरों के लिए, परिणाम आकार को पूर्वानुमानित रखने और पोलिंग को समानांतर करने के लिए क्षेत्र को टाइलों में विभाजित करें।
• आपके द्वारा उपयोग किए गए पैरामीटर को बनाए रखें (API उन्हें पैरामीटर के तहत प्रतिध्वनित करता है) ताकि आप अपनी इनजेशन पाइपलाइन का ऑडिट कर सकें।

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

यदि आप एक MCP-संगत क्लाइंट (जैसे, Claude Code, Cursor, Windsurf) के साथ समन्वय कर रहे हैं, तो आप मार्केटप्लेस के MCP गेटवे के माध्यम से वही HTTPS एंडपॉइंट्स को सक्रिय कर सकते हैं। अपनी Zyla API कुंजी प्रदान करें और एजेंट को ऊपर दस्तावेज़ीकृत एंडपॉइंट URLs को कॉल करने दें। गेटवे उपलब्ध है:

MCP

व्यावहारिक सुझाव:

• टूल परिभाषा या प्रति-कॉल हेडर में Authorization: Bearer YOUR_API_KEY हेडर रखें।
• सटीक रूप से दिखाए गए अनुसार क्वेरी पैरामीटर पास करें (निर्देशांक जोड़ों के लिए स्ट्रिंग्स)।
• जब एक स्वायत्त लूप बना रहे हों, तो अपने कोटा का सम्मान करने के लिए एक बैकऑफ या TTL लागू करें।

ऑपरेशनल गाइडेंस

• प्राधिकरण हेडर प्रारूप सख्त है: Authorization: Bearer YOUR_API_KEY।
• टाइमस्टैम्प UTC में हैं। आवश्यकतानुसार क्लाइंट-साइड पर रूपांतरित करें।
• अधिकतम कैप: मोबाइल क्लाइंट या छोटे मेमोरी वाले सर्वरलेस फ़ंक्शंस के लिए पेलोड आकारों को सीमित करने के लिए max_alerts और max_jams का उपयोग करें।
• त्रुटि हैंडलिंग: हमेशा शीर्ष स्तर की स्थिति की जांच करें और लॉग के लिए request_id रखें। गैर-OK परिणामों पर, समर्थन के लिए पूर्ण पेलोड लॉग करें।
• कैशिंग: मानचित्र टाइलों के लिए, एक छोटा TTL (जैसे, 30–90 सेकंड) ताजगी और कोटा दक्षता को संतुलित करता है।

एंड-टू-एंड उदाहरण प्रवाह

1. एक बाउंडिंग बॉक्स चुनें जो आपके लक्षित गलियारे को कवर करता है (जैसे, एक डिलीवरी मार्ग का 5 किमी बफर)।
2. अपने बॉक्स और अलर्ट और जाम के लिए कैप के साथ अलर्ट और जाम को कॉल करें।
3. अलर्ट प्रकार/उपप्रकार द्वारा रंगीन मार्कर रेंडर करें। स्थानीय रूपांतरण और एक सापेक्ष "उम्र" के साथ UI में publish_datetime_utc दिखाएं।
4. यदि एक महत्वपूर्ण प्रकार (ROAD_CLOSED) आगे दिखाई देता है, तो वैकल्पिक रूप से मार्ग का पुनर्मूल्यांकन करने के लिए ड्राइविंग निर्देशों को कॉल करें।
5. ETag-जैसे कैशिंग के साथ समयबद्ध लूप पर दोहराएं, जो alert_id द्वारा कुंजीबद्ध है।

समस्या निवारण चेकलिस्ट

• 401 Unauthorized: सुनिश्चित करें कि प्राधिकरण हेडर सेट है और कुंजी Zyla हब में सदस्यता प्राप्त Waze डेटा API से है।
• खाली अलर्ट सरणी: पुष्टि करें कि आपका बाउंडिंग बॉक्स वास्तव में सड़क नेटवर्कों को इंटरसेक्ट करता है; क्षेत्र का विस्तार करने या तंग कैप को हटाने का प्रयास करें।
• समय प्रदर्शन बंद: याद रखें कि publish_datetime_utc UTC में है; क्लाइंट पर रूपांतरित करें।
• बड़े पेलोड: max_alerts को कम करें और बाउंडिंग बॉक्स को विभाजित करके पृष्ठांकन-जैसी टाइलिंग सक्षम करें।

अक्सर पूछे जाने वाले प्रश्न

इस API में कौन सी प्रमाणीकरण विधि है?
प्रत्येक अनुरोध पर HTTP हेडर Authorization: Bearer YOUR_API_KEY का उपयोग करें।

मैं भौगोलिक क्षेत्र को कैसे सेट करूं?
दो स्ट्रिंग प्रदान करें: bottom_left और top_right, प्रत्येक को "lat,lon" (पहले अक्षांश, दूसरे देशांतर) के रूप में। API आयत के भीतर अलर्ट और जाम लौटाता है।

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

क्या ड्राइविंग निर्देश एंडपॉइंट में घटनाएँ शामिल हैं?
हाँ। यह प्रतिक्रिया में प्रत्येक संभावित मार्ग के साथ अलर्ट शामिल करता है, साथ ही मार्ग मेटाडेटा जैसे length_meters और duration_seconds।

क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। यह API एक सदस्यता + कोटा मॉडल का उपयोग करता है। आप 7-दिन की परीक्षण अवधि शुरू कर सकते हैं या आइटम पृष्ठ पर 50 अनुरोधों तक; वर्तमान पहुंच विकल्पों के लिए लिस्टिंग की जांच करें।

क्या आप बिना डेटा पाइपलाइन बनाए Waze-ग्रेड अलर्ट और जाम में प्लग करने के लिए तैयार हैं? सदस्यता लें और मार्केटप्लेस लिस्टिंग पर अपनी कुंजी प्राप्त करें: Waze डेटा API पर 7-दिन की परीक्षण अवधि शुरू करें. Zyla API Hub पर हजारों APIs में एक कुंजी के साथ निर्माण करें और इस सप्ताह अपनी एकीकरण को शिप करें।