यह एपीआई आपको दिए गए शहर के नाम के आधार पर संरचित भौगोलिक जानकारी प्राप्त करने की अनुमति देती है जब शहर के नाम के साथ अनुरोध किया जाता है तो एपीआई 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 अनुरोध में पैरामीटर के रूप में शहर का नाम निर्दिष्ट करके अनुरोध को कस्टमाइज़ कर सकते हैं एपीआई द्वारा प्रदान किए गए सटीक शहर के नाम के लिए डेटा लौटाया जाएगा जिससे लक्षित क्वेरी की अनुमति मिलेगी
विशिष्ट उपयोग के मामलों में भू-स्थान सेवाएँ मानचित्रण अनुप्रयोग स्थान मान्यता डेटा दृश्यता और भौगोलिक विश्लेषण शामिल हैं जहाँ सटीक शहर की जानकारी आवश्यक है
डेटा की सटीकता नियमित अपडेट और विश्वसनीय भौगोलिक डेटाबेस के खिलाफ मान्यता के माध्यम से बनाए रखी जाती है यह सुनिश्चित करते हुए कि प्रदान की गई जानकारी वर्तमान और सटीक है
यदि एपीआई आंशिक या खाली परिणाम लौटाती है तो उपयोगकर्ताओं को सटीकता के लिए शहर का नाम सत्यापित करना चाहिए या वैकल्पिक नामों या वर्तनी पर विचार करना चाहिए अनुप्रयोगों में त्रुटि हैंडलिंग को लागू करना भी ऐसे परिदृश्यों को प्रभावी ढंग से प्रबंधित कर सकता है
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
352ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
4,111ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,614ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,043ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
598ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
114ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,641ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
635ms
सर्विस लेवल:
83%
रिस्पॉन्स टाइम:
265ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
625ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
10,821ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
16ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
620ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
5,081ms
सर्विस लेवल:
50%
रिस्पॉन्स टाइम:
5,418ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
37ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,323ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
18ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
51ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,701ms