यह एपीआई आपको दिए गए शहर के नाम के आधार पर संरचित भौगोलिक जानकारी प्राप्त करने की अनुमति देती है जब एक अनुरोध शहर के नाम के साथ किया जाता है, एपीआई JSON प्रारूप में एक विस्तृत डेटा सेट के साथ प्रतिक्रिया देती है प्रतिक्रिया संरचना में एक ऑब्जेक्ट शामिल होता है जो पूछे गए शहर का प्रतिनिधित्व करता है और इसमें भौगोलिक स्थिति या भौगोलिक विश्लेषण के लिए उपयोगी विभिन्न विशेषताएँ होती हैं
मुख्य ऑब्जेक्ट में एक अद्वितीय पहचानकर्ता होता है जिसे geo_id कहा जाता है, जो प्रणाली में उस शहर का अनूठा प्रतिनिधित्व करता है इसमें शहर का नाम (name) भी शामिल होता है, साथ ही संबंधित प्रशासनिक उप विभाग, जो राज्य, क्षेत्र, या जिले के रूप में हो सकता है, और इसे state_or_region फ़ील्ड में दर्शाया जाता है इसके अतिरिक्त, उस देश के बारे में विस्तृत जानकारी जिसमें शहर स्थित है, country प्रॉपर्टी के भीतर एक नेस्टेड ऑब्जेक्ट के माध्यम से प्रदान की जाती है, जिसमें ISO प्रारूप में देश का कोड (code) और देश का पूरा नाम (name) शामिल होता है
भौगोलिक रूप से, प्रतिक्रिया में शहर के सटीक समन्वय शामिल होते हैं, जो दो फ़ील्ड में व्यक्त किए जाते हैं: latitude और longitude ये मान शहर को मानचित्रों पर सटीक रूप से स्थानांकित करने या भौगोलिक जानकारी प्रणालियों (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/10886/retrieve+city+location+details+api/20594/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` (नेस्टेड ऑब्जेक्ट जिसमें `code` और `name` शामिल हैं), `latitude`, और `longitude`
प्रतिक्रिया एक वस्तुओं के सेट के रूप में संरचित है प्रत्येक वस्तु एक शहर का प्रतिनिधित्व करती है प्रत्येक वस्तु में भौगोलिक और प्रशासनिक विवरण के लिए फ़ील्ड होते हैं जिससे इसे पार्स करना और अनुप्रयोगों में उपयोग करना आसान हो जाता है
एपीआई शहरों के नामों, भौगोलिक समन्वय, प्रशासनिक क्षेत्रों और देश की जानकारी प्रदान करता है जिससे उपयोगकर्ता विभिन्न अनुप्रयोगों के लिए व्यापक स्थान डेटा प्राप्त कर सकते हैं
उपयोगकर्ता GET अनुरोध में पैरामीटर के रूप में शहर का नाम निर्दिष्ट करके अनुरोधों को अनुकूलित कर सकते हैं API प्रदान किए गए सटीक शहर नाम के लिए डेटा लौटाएगी जो लक्षित क्वेरीज़ की अनुमति देती है
विशिष्ट उपयोग के मामले में भू-स्थान सेवाएँ मानचित्रण अनुप्रयोग स्थान मान्यता डेटा दृश्यता और भौगोलिक विश्लेषण शामिल हैं जहां सटीक शहर की जानकारी आवश्यक है
डेटा की सटीकता को नियमित अपडेट और विश्वसनीय भौगोलिक डेटाबेस के खिलाफ मान्यता के माध्यम से बनाए रखा जाता है यह सुनिश्चित करते हुए कि प्रदान की गई जानकारी वर्तमान और सटीक है
यदि एपीआई आंशिक या खाली परिणाम लौटाता है तो उपयोगकर्ताओं को सटीकता के लिए शहर के नाम की जांच करनी चाहिए या वैकल्पिक नामों या वर्तनी पर विचार करना चाहिए अनुप्रयोगों में त्रुटि प्रबंधन लागू करना भी ऐसे परिदृश्यों को प्रभावी ढंग से प्रबंधित कर सकता है
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,614ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
80ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
62ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,480ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
74ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
747ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
105ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
926ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
421ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
246ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
6,455ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
612ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
4,636ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,407ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
713ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
363ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
240ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,127ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
806ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
649ms