आपकी टीम को इस सप्ताह उत्पादन में लाइव नेविगेशन डेटा की आवश्यकता है—ट्रैफिक जाम, घटनाएँ, और मार्ग विकल्प जिन पर आप भरोसा कर सकते हैं। इस गाइड के अंत तक, आप प्रमाणित करने, Zyla API Hub से Waze डेटा API के नेविगेशन एंडपॉइंट्स को कॉल करने, और उन फ़ील्ड्स को पार्स करने में सक्षम होंगे जिनकी आपको वास्तव में एक मानचित्र, ETA, या रूटिंग फीचर भेजने के लिए आवश्यकता है।
Waze डेटा API के साथ आप क्या बना सकते हैं
Waze डेटा API एक भौगोलिक क्षेत्र में वास्तविक समय की चेतावनियाँ और जाम प्रदान करता है और दो निर्देशांकों के बीच ड्राइविंग दिशाएँ, प्रत्येक मार्ग के साथ चेतावनियों सहित। यह निम्नलिखित के लिए उपयोगी है:
- इन-ऐप ट्रैफिक ओवरले (दुर्घटनाएँ, सड़क बंद, खतरें, पुलिस, जाम)।
- रूटिंग/ETA फीचर्स जो मार्ग के साथ चेतावनियाँ प्रदर्शित करते हैं।
- डिस्पैच और लॉजिस्टिक्स डैशबोर्ड जो एक शहर या गलियारे के चारों ओर एक लाइव आयत को देखते हैं।
API Zyla API Hub पर उपलब्ध है, जो एक मार्केटप्लेस है जिसमें एक सब्सक्रिप्शन मॉडल और एक कुंजी के पीछे 10,000 से अधिक सार्वजनिक APIs हैं।
Zyla API Hub पर शुरू करना
Waze डेटा API पृष्ठ खोलें और अपनी कुंजी प्राप्त करने के लिए सब्सक्राइब करें। Zyla पर पहला API 7-दिन की ट्रायल या 50 अनुरोधों के साथ आता है; बिलिंग सब्सक्रिप्शन + कोटा है (पे-पर-कॉल नहीं)। कोई मुफ्त योजना नहीं है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
- जाएँ: Waze डेटा API पर 7-दिन की ट्रायल शुरू करें
- सब्सक्राइब या फ्री ट्रायल शुरू करने के लिए क्लिक करें (जब उपलब्ध हो)।
- अपनी API कुंजी कॉपी करें।
सभी अनुरोधों में हेडर Authorization: Bearer YOUR_API_KEY का उपयोग होता है। बेस होस्ट Zyla द्वारा प्रदान किया गया है; नीचे दिखाए गए हब URLs का सटीक उपयोग करें।
नेविगेशन के लिए आप जिन एंडपॉइंट्स का उपयोग करेंगे
1) चेतावनियाँ और जाम
विधि: 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
2) ड्राइविंग दिशाएँ
विधि: 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
अपना पहला कॉल करें: चेतावनियाँ और जाम
नीचे दिए गए आधिकारिक कर्ल को कॉपी-पेस्ट करें। YOUR_API_KEY को अपनी कुंजी से बदलें। URL और पैरामीटर को ठीक उसी तरह रखें जैसा दिखाया गया है।
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: श्रेणी और उपश्रेणी (जैसे, HAZARD_ON_ROAD_CONSTRUCTION, ROAD_CLOSED)।
- latitude, longitude: आपके मानचित्र पर स्थान इंगित करें।
- publish_datetime_utc: हाल की जांच और TTL निर्णयों के लिए UTC टाइमस्टैम्प।
- city, street, country: UI के लिए वैकल्पिक लेबल।
- num_thumbs_up: त्वरित लोकप्रियता/मान्यता संकेत।
Python उदाहरण: एक आयत में खतरों को लाना और प्रदर्शित करना
यह नमूना उसी चेतावनियों और जाम के एंडपॉइंट को कॉल करता है, ROAD_CLOSED और HAZARD के लिए फ़िल्टर करता है, और एक संक्षिप्त पंक्ति प्रिंट करता है जिसे आप लॉग कर सकते हैं या मानचित्र ओवरले में भेज सकते हैं।
import os
import requests
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=20)
resp.raise_for_status()
payload = resp.json()
alerts = (payload.get("data") or {}).get("alerts") or []
for a in alerts:
a_type = a.get("type")
if a_type in ("ROAD_CLOSED", "HAZARD"):
print(
f"{a.get('publish_datetime_utc')} | {a_type} | "
f"{a.get('subtype')} | {a.get('city')} | "
f"{a.get('latitude')},{a.get('longitude')}"
)नोट्स:
- Authorization: Bearer YOUR_API_KEY आवश्यक है।
- निर्देशांक दशमलव डिग्री में हैं। आयत को नीचे-बाएँ और ऊपर-दाएँ जोड़े द्वारा परिभाषित किया गया है।
- publish_datetime_utc में लौटाए गए टाइमस्टैम्प UTC हैं। TZ ड्रिफ्ट से बचने के लिए UTC में स्टोर और तुलना करें।
मार्ग के साथ चेतावनियों के साथ ड्राइविंग दिशाएँ
इस एंडपॉइंट का उपयोग उम्मीदवार मार्गों और उन पर चेतावनियों को प्राप्त करने के लिए करें। आप सबसे तेज़ चुन सकते हैं, टोल को चिह्नित कर सकते हैं, और अपने UI में मार्ग के साथ जाम को हाइलाइट कर सकते हैं। पैरामीटर source_coordinates और destination_coordinates हैं, दोनों अक्षांश, देशांतर स्ट्रिंग के रूप में।
विधि: 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
प्रतिक्रिया से आप जो उदाहरण फ़ील्ड्स प्राप्त कर सकते हैं उनमें शामिल हैं:
- route_name: मार्ग के लिए लेबल।
- length_meters: मीटर में मार्ग की लंबाई।
- duration_seconds: सेकंड में मार्ग की अवधि।
- is_toll, is_hov, is_fastest: UI चयन और ह्यूरिस्टिक्स के लिए फ्लैग।
- alerts[]: प्रकार, उपप्रकार, अक्षांश, देशांतर के साथ प्रति-मार्ग चेतावनियाँ।
एक लाइव कॉल और उदाहरण प्रतिक्रिया के लिए, API पृष्ठ पर एंडपॉइंट देखें। ऊपर नोट किए गए Authorization हेडर का उपयोग करें।
वास्तविक दुनिया के नेविगेशन उपयोग के मामले
- मानचित्र ओवरले: हर N सेकंड में अपने सेवा क्षेत्र के चारों ओर चेतावनियों और जाम की आयत को पोल करें, alert_id द्वारा डुप्लिकेट करें, publish_datetime_utc द्वारा समाप्त करें।
- संदर्भ के साथ ETAs: ड्राइविंग दिशाएँ प्राप्त करें, सबसे तेज़ मार्ग चुनें (is_fastest), और चालक के निकटता के आधार पर शीर्ष 3 चेतावनियाँ प्रदर्शित करें।
- जियोफेंस्ड सूचनाएँ: जब एक चालक एक बाउंडिंग बॉक्स में प्रवेश करता है, तो एक फ़ेच ट्रिगर करें और यदि आगे कोई ROAD_CLOSED है तो सूचित करें।
- ऑप्स डैशबोर्ड: यदि आप केवल घटना मार्करों को चाहते हैं तो max_jams=0 सेट करें ताकि पेलोड का आकार कम हो सके।
समय बचाने वाले कार्यान्वयन नोट्स
- इकाइयाँ: length_meters मीटर में है; duration_seconds सेकंड में है; टाइमस्टैम्प UTC हैं।
- बाउंडिंग बॉक्स: बड़े आयत अधिक चेतावनियाँ लौटाते हैं; मोबाइल के लिए पेलोड को छोटा रखने के लिए max_alerts को ट्यून करें।
- कैशिंग: शॉर्ट-टर्म कैश (30–60s) आमतौर पर बिना अपने कोटा को थ्रैश किए एक तरल मानचित्र के लिए पर्याप्त है।
- त्रुटि हैंडलिंग: निदान के लिए status और request_id की जांच करें; ट्रेसिंग के लिए दोनों को लॉग करें।
- कोटा: उपयोग सब्सक्रिप्शन + कोटा है। Zyla पर पहला API 7-दिन की ट्रायल या 50 अनुरोधों के साथ आता है—अपने Zyla डैशबोर्ड में खपत की निगरानी करें। वर्तमान शर्तों के लिए, API पृष्ठ देखें।
MCP के माध्यम से AI एजेंट से Waze डेटा API कॉल करें
आप इस API को MCP-संगत डेवलपर उपकरणों और एजेंटों में वायर कर सकते हैं। अपने क्लाइंट को MCP एंडपॉइंट पर पॉइंट करें और उन क्लाइंट्स के दस्तावेज़ों में वर्णित अनुसार अपनी Zyla कुंजी पास करें। यहाँ MCP के मूल बातें देखें:
अपने एजेंट के MCP टूल परिभाषा में, ऊपर दिखाए गए समान हब URLs को कॉल करें और Authorization: Bearer YOUR_API_KEY हेडर शामिल करें। क्वेरी पैरामीटर नामों को एंडपॉइंट स्पेक्स के समान रखें।
उत्पादन चेकलिस्ट
- Retry नीति: अस्थायी 5xx के साथ जिटर किया हुआ बैकऑफ; बड़े आयतों पर पुनः प्रयास के तूफानों से बचें।
- Idempotence: घटनाओं को डुप्लिकेट करने के लिए alert_id का उपयोग करें। प्रत्येक आयत के लिए अंतिम देखे गए टाइमस्टैम्प को स्टोर करें।
- गोपनीयता: PII को लॉग न करें; API संचालन उपयोग के लिए उपयुक्त घटना मेटाडेटा लौटाता है।
- पर्यवेक्षण: प्रति-कॉल ट्रेसबिलिटी के लिए लॉग और डैशबोर्ड पर request_id संलग्न करें।
- रोलआउट: अपने प्राथमिक अनुमानक को बदलने से पहले मार्ग की अवधि को अपने ऐतिहासिक ETAs के खिलाफ मान्य करें।
जहाँ अन्वेषण करें और सब्सक्राइब करें
Zyla API Hub पर कैटलॉग ब्राउज़ करें ताकि एक कुंजी के पीछे अधिक नेविगेशन और मैपिंग इंटीग्रेशन खोज सकें। जब आप विशेष रूप से Waze डेटा API के साथ शिप करने के लिए तैयार हों, तो नीचे अपनी ट्रायल शुरू करें और एंडपॉइंट्स को अपनी सेवा में प्लग करें:
Waze डेटा API पर 7-दिन की ट्रायल शुरू करें
FAQ
Waze डेटा API Zyla पर कौन सी प्रमाणीकरण का उपयोग करता है?
हर अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें जो ऊपर दिखाए गए हब URLs पर है।
मैं मानचित्र ओवरले के लिए पेलोड आकार को कैसे सीमित करूँ?
Alerts और Jams पर max_alerts और max_jams का उपयोग करें। केवल घटना मानचित्रों के लिए, max_jams=0 सेट करें।
निर्देशांक प्रारूप क्या हैं?
सभी निर्देशांक दशमलव डिग्री में हैं, जैसे "lat,lon" के रूप में पास किए जाते हैं। बाउंडिंग आयतें bottom_left और top_right जोड़ों का उपयोग करती हैं।
ड्राइविंग दिशाओं में कौन सी इकाइयाँ उपयोग की जाती हैं?
length_meters मीटर में है और duration_seconds सेकंड में है।
क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। Zyla पर पहला API 7-दिन की ट्रायल या 50 अनुरोधों के साथ आता है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ देखें।
