यह एपीआई आपको दिए गए शहर के नाम के आधार पर संरचित भौगोलिक जानकारी प्राप्त करने की अनुमति देती है जब शहर के नाम के साथ अनुरोध किया जाता है तो एपीआई JSON प्रारूप में एक विस्तृत डेटा सेट के साथ प्रतिक्रिया देती है प्रतिक्रिया संरचना में उस शहर का प्रतिनिधित्व करने वाला एक ऑब्जेक्ट शामिल होता है जो पूछताछ की गई है और इसमें भू-स्थान या भूगोल संबंधी विश्लेषण के लिए उपयोगी विभिन्न विशेषताएँ शामिल होती हैं
मुख्य ऑब्जेक्ट में एक अद्वितीय पहचानकर्ता होता है जिसे geo_id कहा जाता है जो उस शहर को सिस्टम में अद्वितीय रूप से दर्शाता है यह शहर का नाम (name) भी शामिल करता है साथ ही संबंधित प्रशासनिक उप-विभाजन, जो एक राज्य, क्षेत्र, या जिला हो सकता है और इसे state_or_region फ़ील्ड में दर्शाया गया है इसके अतिरिक्त, उस देश की विस्तृत जानकारी जिसमें यह शहर शामिल है वह country प्रॉपर्टी के भीतर एक नस्टेड ऑब्जेक्ट के माध्यम से प्रदान की जाती है जिसमें देश का कोड ISO प्रारूप में (code) और देश का पूरा नाम (name) शामिल है
भौगोलिक दृष्टि से, प्रतिक्रिया में शहर का सटीक समन्वय शामिल होता है, जिसे दो फ़ील्ड में व्यक्त किया गया है: अक्षांश और देशांतर ये मान शहर को मानचित्रों पर सटीक रूप से स्थित करने या भूगोल संबंधी जानकारी प्रणालियों (GIS), मानचित्र सेवाओं, भू-स्थान के साथ मोबाइल एप्लिकेशनों के साथ एकीकृत करने की अनुमति देते हैं
प्रतिक्रिया की संरचना को इस प्रकार डिजाइन किया गया है कि इसे वेब अनुप्रयोगों, मोबाइल अनुप्रयोगों, या बैकएंड सेवाओं द्वारा आसानी से व्याख्यायित और उपभोग किया जा सके जिनमें शहर नाम को समन्वय या मानकीकृत भूगोल संबंधी जानकारी में परिवर्तित करने की आवश्यकता होती है यह स्थान सत्यापन, कवरेज विश्लेषण, मानचित्रों पर डेटा विज़ुअलाइज़ेशन जैसे कार्यों के लिए भी उपयोगी है या बस किसी स्थान के बारे में बुनियादी डेटा प्राप्त करने के लिए
संक्षेप में, यह एपीआई शहर के नाम को पूर्ण, मानकीकृत, और सटीक भूगोल संबंधी जानकारी में परिवर्तित करने की सुविधा प्रदान करती है जिसे विभिन्न प्रकार के अनुप्रयोगों या डेटा प्रवाह में आसानी से एकीकृत किया जा सकता है जो भूगोलिक स्थानों पर निर्भर करते हैं
शहर के नाम के आधार पर देश, क्षेत्र और निर्देशांक जैसी विस्तृत भौगोलिक जानकारी लौटाता है जो एक पैरामीटर के रूप में प्रदान की जाती है
[{"geo_id": 2968496, "name": "Villeparisis", "state_or_region": "\u00cele-de-France", "country": {"code": "FR", "name": "France"}, "latitude": 48.942081, "longitude": 2.61463}, {"geo_id": 2988507, "name": "Paris", "state_or_region": "\u00cele-de-France", "country": {"code": "FR", "name": "France"}, "latitude": 48.853409, "longitude": 2.3488}, {"geo_id": 3023645, "name": "Cormeilles-en-Parisis", "state_or_region": "\u00cele-de-France", "country": {"code": "FR", "name": "France"}, "latitude": 48.971111, "longitude": 2.20491}, {"geo_id": 3725276, "name": "Fond Parisien", "state_or_region": "Ouest", "country": {"code": "HT", "name": "Haiti"}, "latitude": 18.505831, "longitude": -71.976669}]
curl --location --request GET 'https://zylalabs.com/api/10890/city+location+data+retrieval+api/20595/city+information&city_name=Required' --header 'Authorization: Bearer YOUR_API_KEY'
| हेडर | विवरण |
|---|---|
Authorization
|
[आवश्यक] होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें। |
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
एपीआई निर्दिष्ट शहर के लिए संरचित भौगोलिक जानकारी लौटाता है जिसमें इसका नाम प्रशासनिक क्षेत्र देश का विवरण और सटीक समन्वय (अक्षांश और देशांतर) JSON प्रारूप में शामिल हैं
प्रतिक्रिया में मुख्य क्षेत्र शामिल हैं `geo_id` (अद्वितीय शहर पहचानकर्ता), `name` (शहर का नाम), `state_or_region` (प्रशासनिक उपखंड), `country` (nested वस्तु जिसमें `code` और `name` शामिल हैं), `latitude`, और `longitude`
प्रतिक्रिया एक ऑब्जेक्ट्स की एरे के रूप में संरचित है प्रत्येक एक शहर का प्रतिनिधित्व करता है प्रत्येक ऑब्जेक्ट में भौगोलिक और प्रशासनिक विवरण के लिए क्षेत्र होते हैं जिससे इसे पार्स करना और अनुप्रयोगों में उपयोग करना आसान हो जाता है
एपीआई शहरों के नाम भौगोलिक समन्वय प्रशासकीय क्षेत्रों और देश की जानकारी प्रदान करता है जिससे उपयोगकर्ता विभिन्न अनुप्रयोगों के लिए व्यापक स्थान डेटा प्राप्त कर सकें
उपयोगकर्ता GET अनुरोध में पैरामीटर के रूप में शहर का नाम निर्दिष्ट करके अनुरोध को कस्टमाइज़ कर सकते हैं एपीआई द्वारा प्रदान किए गए सटीक शहर के नाम के लिए डेटा लौटाया जाएगा जिससे लक्षित क्वेरी की अनुमति मिलेगी
विशिष्ट उपयोग के मामलों में भू-स्थान सेवाएँ मानचित्रण अनुप्रयोग स्थान मान्यता डेटा दृश्यता और भौगोलिक विश्लेषण शामिल हैं जहाँ सटीक शहर की जानकारी आवश्यक है
डेटा की सटीकता नियमित अपडेट और विश्वसनीय भौगोलिक डेटाबेस के खिलाफ मान्यता के माध्यम से बनाए रखी जाती है यह सुनिश्चित करते हुए कि प्रदान की गई जानकारी वर्तमान और सटीक है
यदि एपीआई आंशिक या खाली परिणाम लौटाती है तो उपयोगकर्ताओं को सटीकता के लिए शहर का नाम सत्यापित करना चाहिए या वैकल्पिक नामों या वर्तनी पर विचार करना चाहिए अनुप्रयोगों में त्रुटि हैंडलिंग को लागू करना भी ऐसे परिदृश्यों को प्रभावी ढंग से प्रबंधित कर सकता है
Zyla API Hub APIs के लिए एक बड़ा स्टोर जैसा है, जहाँ आप हजारों APIs एक ही जगह पर पा सकते हैं। हम सभी APIs की समर्पित सपोर्ट और रीयल-टाइम मॉनिटरिंग भी प्रदान करते हैं। एक बार साइन अप करने के बाद, आप चुन सकते हैं कि कौन सी APIs उपयोग करनी हैं। बस याद रखें, प्रत्येक API को अपनी स्वयं की सब्सक्रिप्शन की आवश्यकता होती है। लेकिन यदि आप कई APIs पर सब्सक्राइब करते हैं, तो आप सभी के लिए एक ही की का उपयोग करेंगे, जिससे आपके लिए चीज़ें आसान हो जाती हैं।
कीमतें USD (अमेरिकी डॉलर), EUR (यूरो), CAD (कनाडाई डॉलर), AUD (ऑस्ट्रेलियाई डॉलर), और GBP (ब्रिटिश पाउंड) में सूचीबद्ध हैं। हम सभी प्रमुख डेबिट और क्रेडिट कार्ड स्वीकार करते हैं। हमारा पेमेंट सिस्टम नवीनतम सुरक्षा तकनीक का उपयोग करता है और Stripe द्वारा संचालित है, जो दुनिया की सबसे विश्वसनीय पेमेंट कंपनियों में से एक है। यदि आपको कार्ड से पेमेंट करने में कोई समस्या हो, तो बस हमसे संपर्क करें [email protected]
इसके अलावा, यदि आपके पास पहले से ही इनमें से किसी भी करेंसी (USD, EUR, CAD, AUD, GBP) में एक सक्रिय सब्सक्रिप्शन है, तो बाद की सब्सक्रिप्शंस के लिए वही करेंसी बनी रहेगी। जब तक आपके पास कोई सक्रिय सब्सक्रिप्शन नहीं है, आप किसी भी समय करेंसी बदल सकते हैं।
प्राइसिंग पेज पर दिखाई देने वाली स्थानीय करेंसी आपके IP पते के देश पर आधारित है और केवल संदर्भ के लिए प्रदान की गई है। वास्तविक कीमतें USD (अमेरिकी डॉलर) में हैं। जब आप भुगतान करते हैं, तो आपके कार्ड स्टेटमेंट पर चार्ज USD में दिखाई देगा, भले ही हमारी वेबसाइट पर आपको आपकी स्थानीय करेंसी में समतुल्य राशि दिखाई दे। इसका अर्थ है कि आप सीधे अपनी स्थानीय करेंसी से भुगतान नहीं कर सकते।
कभी-कभी, बैंक फ्रॉड प्रोटेक्शन सेटिंग्स के कारण चार्ज को डिक्लाइन कर सकता है। हम सुझाव देते हैं कि आप पहले अपने बैंक से संपर्क करें कि क्या वे हमारे चार्ज को ब्लॉक कर रहे हैं। साथ ही, आप बिलिंग पोर्टल तक पहुंच सकते हैं और भुगतान करने के लिए जुड़े कार्ड को बदल सकते हैं। यदि यह काम नहीं करता और आपको अतिरिक्त सहायता की आवश्यकता है, तो कृपया हमारी टीम से संपर्क करें [email protected]
कीमतें पुनरावर्ती मासिक या वार्षिक सब्सक्रिप्शन के आधार पर निर्धारित की जाती हैं, जो चुने गए प्लान पर निर्भर करती हैं।
API कॉल्स आपके प्लान से सफल रिक्वेस्ट के आधार पर घटाई जाती हैं। प्रत्येक प्लान में प्रति माह आप जितनी कॉल कर सकते हैं उसकी एक विशेष संख्या होती है। केवल सफल कॉल्स, जो स्टेटस 200 रिस्पॉन्स से इंगित होती हैं, आपकी कुल संख्या से घटाई जाएँगी। इससे सुनिश्चित होता है कि असफल या अधूरी रिक्वेस्ट आपके मासिक कोटा को प्रभावित नहीं करतीं।
Zyla API Hub एक पुनरावर्ती मासिक सब्सक्रिप्शन सिस्टम पर काम करता है। आपका बिलिंग साइकल उस दिन से शुरू होगा जिस दिन आप किसी पेड प्लान को खरीदते हैं, और अगले महीने के उसी दिन नवीनीकृत होगा। इसलिए यदि आप भविष्य के चार्ज से बचना चाहते हैं, तो समय पर अपनी सब्सक्रिप्शन कैंसल करना सुनिश्चित करें।
अपनी मौजूदा सब्सक्रिप्शन प्लान को अपग्रेड करने के लिए, बस API के प्राइसिंग पेज पर जाएँ और वह प्लान चुनें जिस पर आप अपग्रेड करना चाहते हैं। अपग्रेड तुरंत प्रभावी होगा, जिससे आपको नए प्लान की सुविधाओं का तुरंत आनंद मिलेगा। कृपया ध्यान दें कि आपके पिछले प्लान से बची हुई कॉल्स नए प्लान में नहीं जोड़ी जाएँगी, इसलिए अपग्रेड करने से पहले इसे ध्यान में रखें। आपको नए प्लान की पूरी राशि चार्ज की जाएगी।
यह देखने के लिए कि आपके पास वर्तमान महीने के लिए कितनी API कॉल्स बची हैं, रिस्पॉन्स हेडर में "X-Zyla-API-Calls-Monthly-Remaining" फ़ील्ड देखें। उदाहरण के लिए, यदि आपके प्लान में प्रति माह 1,000 रिक्वेस्ट की अनुमति है और आपने 100 का उपयोग किया है, तो रिस्पॉन्स हेडर में यह फ़ील्ड 900 बची हुई कॉल्स दिखाएगा।
आपके प्लान में अनुमत API रिक्वेस्ट्स की अधिकतम संख्या देखने के लिए, "X-Zyla-RateLimit-Limit" रिस्पॉन्स हेडर देखें। उदाहरण के लिए, यदि आपके प्लान में प्रति माह 1,000 रिक्वेस्ट्स शामिल हैं, तो यह हेडर 1,000 दिखाएगा।
"X-Zyla-RateLimit-Reset" हेडर यह दिखाता है कि आपकी रेट लिमिट रीसेट होने में कितने सेकंड बचे हैं। यह आपको बताता है कि आपकी रिक्वेस्ट गिनती कब से फिर से शुरू होगी। उदाहरण के लिए, यदि यह 3,600 दिखाता है, तो इसका मतलब है कि लिमिट रीसेट होने में 3,600 सेकंड बचे हैं।
हाँ, आप कभी भी अपने अकाउंट में जाकर और बिलिंग पेज पर कैंसिलेशन विकल्प चुनकर अपना प्लान कैंसल कर सकते हैं। कृपया ध्यान दें कि अपग्रेड, डाउनग्रेड और कैंसिलेशन तुरंत प्रभावी होते हैं। साथ ही, कैंसल करने पर आपको सेवा तक पहुंच नहीं होगी, भले ही आपके कोटा में कॉल्स बची हों।
आप तुरंत सहायता प्राप्त करने के लिए हमारे चैट चैनल के माध्यम से हमसे संपर्क कर सकते हैं। हम हमेशा सुबह 8 बजे से शाम 5 बजे (EST) तक ऑनलाइन रहते हैं। यदि आप हमें उस समय के बाद संपर्क करते हैं, तो हम यथाशीघ्र आपसे संपर्क करेंगे। इसके अलावा, आप हमें ईमेल के माध्यम से भी संपर्क कर सकते हैं [email protected]
आपको बिना किसी प्रतिबद्धता के हमारी APIs का अनुभव करने का मौका देने के लिए, हम 7-दिवसीय फ्री ट्रायल प्रदान करते हैं, जो आपको 50 API कॉल्स तक मुफ्त में करने की अनुमति देता है। यह ट्रायल केवल एक बार उपयोग किया जा सकता है, इसलिए हम सलाह देते हैं कि आप इसे उस API पर लागू करें जिसमें आपको सबसे अधिक रुचि है। जबकि अधिकांश APIs फ्री ट्रायल प्रदान करते हैं, कुछ शायद न करें। ट्रायल 7 दिनों के बाद या 50 रिक्वेस्ट होने पर, जो भी पहले हो, समाप्त हो जाता है। यदि आप ट्रायल के दौरान 50 रिक्वेस्ट लिमिट तक पहुँच जाते हैं, तो रिक्वेस्ट जारी रखने के लिए आपको "Start Your Paid Plan" करना होगा। आप अपने प्रोफाइल में Subscription -> जिस API पर आप सब्सक्राइब हैं उसे चुनें -> Pricing टैब में "Start Your Paid Plan" बटन पा सकते हैं। यदि आप 7वें दिन से पहले अपनी सब्सक्रिप्शन कैंसल नहीं करते हैं, तो आपका फ्री ट्रायल समाप्त हो जाएगा और आपका प्लान अपने आप चार्ज हो जाएगा, जिससे आपको अपने प्लान में निर्दिष्ट सभी API कॉल्स तक पहुंच मिल जाएगी। अवांछित चार्ज से बचने के लिए कृपया इसे ध्यान में रखें।
7 दिनों के बाद, आपको उस प्लान की पूरी राशि चार्ज की जाएगी, जिस पर आप ट्रायल के दौरान सब्सक्राइब थे। इसलिए, ट्रायल अवधि समाप्त होने से पहले कैंसल करना महत्वपूर्ण है। समय पर कैंसल करना भूलने के लिए रिफंड अनुरोध स्वीकार नहीं किए जाते।
जब आप किसी API के फ्री ट्रायल पर सब्सक्राइब करते हैं, तो आप 50 API कॉल्स तक कर सकते हैं। यदि आप इस लिमिट से आगे अतिरिक्त API कॉल्स करना चाहते हैं, तो API आपको "Start Your Paid Plan" करने का संकेत देगा। आप अपने प्रोफाइल में Subscription -> जिस API पर आप सब्सक्राइब हैं उसे चुनें -> Pricing टैब में "Start Your Paid Plan" बटन पा सकते हैं।
पAYOUT ऑर्डर्स महीने की 20 तारीख से 30 तारीख के बीच प्रोसेस किए जाते हैं। यदि आप अपना अनुरोध 20 तारीख से पहले सबमिट करते हैं, तो आपका पेमेंट इस समयावधि के भीतर प्रोसेस किया जाएगा।
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
352ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
4,111ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,614ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,865ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
598ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,043ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
114ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,641ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
625ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,553ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,371ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
573ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
42ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,116ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
0ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,381ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
677ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,093ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,480ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
94ms
