Waze डेटा API के लिए उपयोग के मामले

आपको विश्वसनीय लाइव नेविगेशन डेटा की आवश्यकता है: घटनाएँ, सड़क बंद, जाम, और ETA के साथ व्यावहारिक मार्ग। इस गाइड के अंत तक, आप Waze के अलर्ट और ट्रैफिक जाम के लिए एक बाउंडिंग बॉक्स का क्वेरी करेंगे, दो निर्देशांकों के बीच ड्राइविंग दिशाएँ प्राप्त करेंगे, और इन परिणामों को Zyla API Hub पर Waze डेटा API का उपयोग करके अपने ऐप में भेजेंगे।

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

Waze डेटा API दो मुख्य नेविगेशन क्षमताओं को उजागर करता है:

Illustration: Use Cases for Waze Data API

एक भौगोलिक आयत के भीतर वास्तविक समय के अलर्ट और जाम (दुर्घटनाएँ, सड़क ब्लॉक्स, खतरें, ट्रैफिक जाम, पुलिस, और अधिक)।
दो निर्देशांकों के बीच ड्राइविंग दिशाएँ, प्रत्येक मार्ग के साथ अलर्ट और "is_fastest" और टोल/HOV संकेतकों जैसे झंडे शामिल हैं।

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

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

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

यदि आप बाद में अन्य श्रेणियों का अन्वेषण कर रहे हैं, तो आप अपने योजना में APIs के बीच उसी कुंजी का पुन: उपयोग कर सकते हैं Zyla API Hub पर।

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

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

विधि: 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)
- max_jams (string)

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_…

आप वास्तव में जिन प्रमुख क्षेत्रों का उपयोग करेंगे:

data.alerts[].type और subtype: UI टैग और फ़िल्टरिंग के लिए खतरा/जाम/बंद श्रेणीकरण।
latitude और longitude: मानचित्र पर प्लॉट करें या मार्गों/स्टॉप के निकटता की गणना करें।
publish_datetime_utc: टाइमस्टैम्प UTC ISO-8601 हैं; UTC के रूप में स्टोर करें और केवल प्रदर्शन के लिए क्लाइंट में परिवर्तित करें।
city, street, description: अधिसूचना पाठ या ऑपरेटर डैशबोर्ड को भरें।
num_thumbs_up: प्राथमिकता के लिए सरल विश्वास प्रॉक्सी।

Python उदाहरण: निर्माण खतरों और सड़क बंदियों को फ़िल्टर करें

import requests

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=20)
resp.raise_for_status()
payload = resp.json()

alerts = (payload.get("data") or {}).get("alerts") or []
construction_or_closed = []
for a in alerts:
a_type = a.get("type")
a_sub = a.get("subtype")
if a_type == "ROAD_CLOSED" or a_sub == "HAZARD_ON_ROAD_CONSTRUCTION":
construction_or_closed.append({
"id": a.get("alert_id"),
"type": a_type,
"subtype": a_sub,
"when_utc": a.get("publish_datetime_utc"),
"lat": a.get("latitude"),
"lon": a.get("longitude"),
"street": a.get("street"),
"city": a.get("city"),
"desc": a.get("description"),
})

print(f"Total alerts: {len(alerts)} (construction/closed: {len(construction_or_closed)})")
for row in construction_or_closed[:5]:
print(row)

नोट्स:

निर्देशांक कोमा से अलग किए गए स्ट्रिंग के रूप में पास किए जाते हैं। cURL नमूने में URL-कोडित कोमा को requests पुस्तकालय द्वारा स्वचालित रूप से संभाला जाता है।
इकाइयाँ: निर्देशांक डिग्री में; टाइमस्टैम्प UTC में; इस एंडपॉइंट के लिए कोई पृष्ठन नहीं है—वॉल्यूम नियंत्रण के लिए बाउंडिंग बॉक्स और वैकल्पिक max_alerts/max_jams का उपयोग करें।
कैश अमान्यकरण: ये अलर्ट स्वाभाविक रूप से वास्तविक समय के होते हैं; यदि आप सर्वर पर कैश करते हैं, तो महत्वपूर्ण सुरक्षा श्रेणियों के लिए TTL को छोटा रखें।

एंडपॉइंट: ड्राइविंग दिशाएँ

दो निर्देशांकों के बीच मार्ग विकल्प प्राप्त करें और प्रत्येक मार्ग पर अलर्ट। यह विकल्प दिखाने, ETA की गणना करने, और पूर्व-यात्रा खतरे के पूर्वावलोकन प्रदान करने के लिए आदर्श है। API वांछित आगमन समय सेट करने का समर्थन करता है, लेकिन इसके लिए पैरामीटर यहाँ विस्तृत नहीं हैं—नवीनतम विकल्पों के लिए API पृष्ठ की जांच करें।

विधि: 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

cURL

प्रतिक्रिया में क्या अपेक्षा करें

प्रतिक्रिया में एक या अधिक मार्ग शामिल होते हैं जिनमें विशेषताएँ होती हैं जैसे:

route_name: UI के लिए उपयुक्त लेबल।
length_meters और duration_seconds: दूरी/ETA डिस्प्ले और सॉर्टिंग के लिए उपयोग करें।
is_fastest, is_toll, is_hov: मार्ग चयन तर्क।
alerts: मार्ग के साथ अलर्ट मार्करों का एक सरणी (प्रकार, उपप्रकार, निर्देशांक)।

उदाहरण फ़ील्ड इस प्रकार दिखाई देते हैं:

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

duration_seconds सेकंड में है; उपयोगकर्ता प्रदर्शन के लिए मिनटों में परिवर्तित करें और ETA गणना के लिए कच्चे सेकंड रखें।
length_meters मीटर में है; मील या किलोमीटर के लिए, गोलाई के मुद्दों से बचने के लिए क्लाइंट-साइड पर परिवर्तित करें।
यदि आपको मार्ग ज्यामिति की आवश्यकता है, तो route_coordinates जैसे फ़ील्ड की जांच करें; ऊपर दिए गए उदाहरण में यह मौजूद है लेकिन खाली है—वर्तमान व्यवहार और झंडों के लिए API पृष्ठ की जांच करें।

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

भू-सीमाबद्ध ड्राइवर अलर्ट: अपने सेवा क्षेत्र के लिए हर N सेकंड/मिनट में अलर्ट और जाम का क्वेरी करें और सक्रिय यात्राओं के X मीटर के भीतर ROAD_CLOSED या HAZARD_ON_ROAD_CONSTRUCTION प्रकार के लिए पुश सूचनाएँ भेजें।
डिस्पैच डैशबोर्ड ओवरले: क्षेत्रीय बाउंडिंग बॉक्स के भीतर सभी data.alerts मार्करों को खींचें; प्रकार द्वारा रंग (जैसे, ROAD_CLOSED के लिए लाल, HAZARD के लिए एम्बर) करें।
असाइनमेंट से पहले मार्ग की जांच: उम्मीदवार पिकअप/ड्रॉपऑफ के लिए ड्राइविंग दिशाएँ कॉल करें; यदि काम टोल की अनुमति नहीं देता है तो is_toll=true के साथ गैर-तेज़तम मार्गों को अस्वीकार करें।
ETA-जानकारी ग्राहक संदेश: अपेक्षाएँ सेट करने के लिए duration_seconds का उपयोग करें, और जब is_fastest सीमांत हो तो शीर्ष दो विकल्प दिखाएँ।
ऑप्स मॉनिटरिंग: num_thumbs_up और उपप्रकार फ़िल्टरिंग के माध्यम से निर्माण खतरों में स्पाइक्स को ट्रैक करें ताकि क्षेत्रीय टीमों के लिए संचार को प्राथमिकता दी जा सके।

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

निर्देशांक क्रम: सभी दिखाए गए पैरामीटर उस क्रम में अक्षांश, देशांतर का उपयोग करते हैं, जैसे कि कोमा से अलग किए गए स्ट्रिंग।
बाउंडिंग बॉक्स: ड्राइवर के चारों ओर ऑन-डिवाइस पोलिंग के लिए एक छोटा आयत का उपयोग करें, या सर्वर-साइड समेकन के लिए क्षेत्र के अनुसार बड़े बॉक्स।
टाइमस्टैम्प: publish_datetime_utc UTC है; अपने बैकएंड में UTC के रूप में स्टोर करें और केवल रेंडरिंग के समय क्लाइंट में स्थानीयकरण करें।
त्रुटि हैंडलिंग: अवलोकन के लिए स्थिति और request_id की जांच करें; अपने मॉनिटरिंग के साथ सहसंबंधित करने के लिए request_id को लॉग करें।
थ्रूपुट: मार्केटप्लेस एक सदस्यता + कोटा मॉडल का उपयोग करता है, न कि प्रति-कॉल भुगतान। पहली बार Zyla उपयोगकर्ताओं के लिए, पहला API 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है। कोई मुफ्त योजना नहीं है। वर्तमान कोटा और सीमाओं के लिए API पृष्ठ देखें।

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

यदि आप MCP-संगत क्लाइंट (Claude Code, Cursor, Windsurf, आदि) का उपयोग करते हैं, तो उन्हें Zyla MCP एंडपॉइंट पर इंगित करें और URL में अपनी कुंजी प्रदान करें:

MCP

एक बार कॉन्फ़िगर होने के बाद, आपका एजेंट Authorization: Bearer YOUR_API_KEY हेडर के साथ समान Waze डेटा API हब URLs को कॉल कर सकता है। यह स्वचालित रूप से एकीकरण कोड उत्पन्न करने, फ़ेच फ़ंक्शंस का मसौदा तैयार करने, या विकास के दौरान त्वरित परीक्षण कॉल चलाने के लिए सहायक है।

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

यात्रा निर्माण पर, source_coordinates और destination_coordinates के साथ ड्राइविंग दिशाएँ कॉल करें। उस मार्ग का चयन करें जहाँ is_fastest सत्य है; ETA के लिए duration_seconds को स्टोर करें।
यात्रा के दौरान, ड्राइवर के चारों ओर एक छोटे बाउंडिंग बॉक्स के लिए अलर्ट और जाम का पोल करें। यदि आप 300 मीटर आगे type=ROAD_CLOSED प्राप्त करते हैं, तो ड्राइविंग दिशाएँ फिर से अनुरोध करें और एक रीरूट का प्रस्ताव करें।
अपने डैशबोर्ड में, अपने हाल के थ्रेशोल्ड के भीतर subtype और publish_datetime_utc द्वारा फ़िल्टर किए गए सभी सक्रिय क्षेत्रों के लिए वर्तमान अलर्ट को विज़ुअलाइज़ करें, उसी अलर्ट और जाम एंडपॉइंट का उपयोग करके।

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

401/403 प्रतिक्रियाएँ: Authorization: Bearer YOUR_API_KEY और यह सुनिश्चित करें कि आपकी सदस्यता सक्रिय है।
खाली अलर्ट सरणी: पुष्टि करें कि आपका बाउंडिंग बॉक्स वास्तव में सड़क नेटवर्कों को इंटरसेक्ट करता है और कि max_alerts/max_jams अत्यधिक प्रतिबंधात्मक नहीं हैं।
धीमी क्लाइंट-साइड मानचित्र: प्रकार के एक उपसमुच्चय को फ़िल्टर करके प्रतीक घनत्व को कम करें, या उच्च ज़ूम स्तरों पर मार्करों को क्लस्टर करें।
ETA पुराना लगता है: जब अलर्ट और जाम आपके मार्ग से संबंधित एक निकटतम JAM या ROAD_CLOSED को सतह पर लाते हैं, तो ड्राइविंग दिशाएँ फिर से क्वेरी करें।

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

मुझे अलर्ट और जाम के लिए कितनी बार पोल करना चाहिए?
यह आपके उपयोग के मामले और कोटा पर निर्भर करता है। सुरक्षा-क्रिटिकल ओवरले के लिए, अंतराल को छोटा रखें लेकिन अपने सीमाओं के साथ संतुलित करें; डैशबोर्ड के लिए, लंबे अंतराल पर्याप्त हो सकते हैं। छोटे से शुरू करें, मात्रा को मापें, फिर ट्यून करें।

length_meters और duration_seconds किस इकाई का उपयोग करते हैं?
क्रमशः मीटर और सेकंड। आवश्यकतानुसार क्लाइंट में मील/किलोमीटर और मिनटों में परिवर्तित करें।

क्या मैं वांछित आगमन समय के लिए मार्गों का अनुरोध कर सकता हूँ?
ड्राइविंग दिशाएँ एंडपॉइंट वांछित आगमन समय सेट करने का समर्थन करता है, लेकिन पैरामीटर यहाँ विस्तृत नहीं हैं। वर्तमान विकल्पों के लिए API पृष्ठ की जांच करें।

मैं केवल निर्माण या बंदियों को कैसे फ़िल्टर करूँ?
data.alerts[].type और subtype की जांच करें, जैसे, type=ROAD_CLOSED या subtype=HAZARD_ON_ROAD_CONSTRUCTION।

क्या यह प्रति-कॉल भुगतान है?
नहीं। Zyla एक सदस्यता + कोटा मॉडल का उपयोग करता है। पहली बार Zyla उपयोगकर्ताओं के लिए, पहला API 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है। वर्तमान विवरणों के लिए लिस्टिंग देखें।

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