यह एपीआई आपको एक शहर के नाम के आधार पर संरचित भौगोलिक जानकारी प्राप्त करने की अनुमति देती है जो इनपुट के रूप में प्रदान किया गया है जब एक शहर के नाम के साथ अनुरोध किया जाता है तो एपीआई 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/10883/city+location+lookup+api/20588/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 object जिसमें `code` और `name` शामिल हैं), `latitude`, और `longitude` शामिल हैं
प्रतिक्रिया को वस्तुओं के एक एरे के रूप में संरचित किया गया है प्रत्येक वस्तु एक शहर का प्रतिनिधित्व करती है प्रत्येक वस्तु में भौगोलिक और प्रशासनिक विवरणों के लिए क्षेत्र होते हैं जिससे इसे विश्लेषण करना और अनुप्रयोगों में उपयोग करना आसान होता है
एपीआई शहर के नामों भूगोलिक निर्देशांक प्रशासनिक क्षेत्रों और देश की जानकारी प्रदान करता है जिससे उपयोगकर्ता विभिन्न अनुप्रयोगों के लिए संपूर्ण स्थान डेटा प्राप्त कर सकें
उपयोगकर्ता GET अनुरोध में पैरामीटर के रूप में शहर का नाम निर्दिष्ट करके अनुरोधों को कस्टमाइज़ कर सकते हैं एपीआई प्रदान किए गए सटीक शहर नाम के लिए डेटा वापस करेगा जिससे लक्ष्यित क्वेरी की अनुमति होती है
विशिष्ट उपयोग के मामले में भूस्थानीयकरण सेवाएं मानचित्रण अनुप्रयोग स्थान मान्यता डेटा दृश्यता और भौगोलिक विश्लेषण शामिल हैं जहां सटीक शहर की जानकारी आवश्यक है
डेटा सटीकता को नियमित अपडेट और विश्वसनीय भौगोलिक डेटाबेस के खिलाफ सत्यापन के माध्यम से बनाए रखा जाता है जिससे प्रदान की गई जानकारी वर्तमान और सटीक होती है
यदि एपीआई आंशिक या खाली परिणाम लौटाता है तो उपयोगकर्ताओं को सटीकता के लिए शहर के नाम की सत्यता की जांच करनी चाहिए या वैकल्पिक नामों या वर्तनी पर विचार करना चाहिए अनुप्रयोगों में त्रुटि हैंडलिंग लागू करना भी ऐसे परिदृश्यों को प्रभावी रूप से प्रबंधित कर सकता है
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,614ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
692ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
5,227ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
747ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
257ms
सर्विस लेवल:
50%
रिस्पॉन्स टाइम:
181ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,656ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
479ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
114ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
756ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
9,138ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,656ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
692ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,835ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,732ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
166ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,994ms
सर्विस लेवल:
83%
रिस्पॉन्स टाइम:
564ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
678ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,779ms