# 🌐GeoSource API
## अवलोकन
**GeoSource API** एक शक्तिशाली और विश्वसनीय RESTful API है जो 249 से अधिक देशों और क्षेत्रों पर विस्तृत भू-डेटा प्रदान करता है। यह डेवलपर्स को लॉजिस्टिक्स से लेकर यात्रा, वाणिज्य और शिक्षा तक के अनुप्रयोगों में उपयोग के लिए विस्तृत और अद्यतन भौगोलिक, राजनीतिक और सांस्कृतिक जानकारी प्राप्त करने की क्षमता देता है।
---
## 🚀 विशेषताएँ
- 🌍 देश के नाम, राजधानियाँ, फोन कोड, झंडे
- 💱 मुद्रा कोड और प्रतीक
- 🏙️ राज्य और शहर
- 📍 ज़िप कोड और स्थान खोज
- 🌐 देशों के लिए इमोजी झंडा समर्थन
---
### ज़िप कोड डेटा के लिए समर्थित देश
अल्जीरिया, अंडोरा, अर्जेंटीना, आर्मेनिया, ऑस्ट्रेलिया, ऑस्ट्रिया, अजरबाइजान, बांग्लादेश, बेलारूस, बेल्जियम, ब्राजील, बुल्गारिया, कनाडा, चिली, कोलंबिया, चेक गणराज्य, फ्रांस, जर्मनी, ग्वाटेमाला, हैती, हंगेरी, आइसलैंड, भारत, इटली, मेक्सिको, मोल्दोवा, मोरक्को, फिलीपींस, पोलैंड, रोमेनिया, रूस, सैन मरीनो, सर्बिया, सिंगापुर, स्लोवाकिया, स्लोवेनिया, स्पेन, श्रीलंका, स्वीडन, स्विट्ज़रलैंड, थाईलैंड, यूनाइटेड किंगडम, यूनाइटेड स्टेट्स, उरुग्वे.
## 📌 API एंडपॉइंट्स
सभी एंडपॉइंट **GET** विधि का उपयोग करते हैं।
### 1. `CountriesList`
- **एंडपॉइंट**: `/CountriesList`
- **विवरण**: उपलब्ध डेटा के साथ सभी देशों की पूरी सूची प्राप्त करता है।
---
### 2. `Capital By Country`
- **एंडपॉइंट**: `/CapitalByCountry`
- **क्वेरी पैरामीटर**:
- `country`: देश का नाम (जैसे, `France`)
- **विवरण**: निर्दिष्ट देश की राजधानी शहर लौटाता है।
---
### 3. `Phone Code By Country`
- **एंडपॉइंट**: `/PhoneCodeByCountry`
- **क्वेरी पैरामीटर**:
- `country`: देश का नाम (जैसे, `India`)
- **विवरण**: निर्दिष्ट देश का अंतरराष्ट्रीय फोन कोड लौटाता है।
---
### 4. `Currency By Country`
- **एंडपॉइंट**: `/CurrencyByCountry`
- **क्वेरी पैरामीटर**:
- `country`: देश का नाम
- **विवरण**: निर्दिष्ट देश का मुद्रा कोड और प्रतीक लौटाता है।
---
### 5. `emoji Flag By Country`
- **एंडपॉइंट**: `/emojiFlagByCountry`
- **क्वेरी पैरामीटर**:
- `country`: देश का नाम
- **विवरण**: देश के झंडे का इमोजी प्रतिनिधित्व लौटाता है।
---
### 6. `states By Country`
- **एंडपॉइंट**: `/statesByCountry`
- **क्वेरी पैरामीटर**:
- `country`: देश का नाम
- **विवरण**: दिए गए देश में राज्यों या प्रांतों की सूची लौटाता है।
---
### 7. `cities By State`
- **एंडपॉइंट**: `/citiesByState`
- **क्वेरी पैरामीटर**:
- `state`: राज्य का नाम
- **विवरण**: दिए गए राज्य और देश के भीतर के शहर लौटाता है।
---
### 8. `Location By City`
- **एंडपॉइंट**: `/LocationByCity`
- **क्वेरी पैरामीटर**:
- `city`: शहर का नाम
- **विवरण**: दिए गए शहर के लिए स्थान विवरण (जैसे lat/lon) लौटाता है।
---
### 9. `ZipCode By City`
- **एंडपॉइंट**: `/ZipCodeByCity`
- **क्वेरी पैरामीटर**:
- `city`: शहर का नाम
- **विवरण**: दिए गए शहर से जुड़े ज़िप/डाक कोड लौटाता है।
---
देशों की सूची
[
{
"countryID": "1",
"countryName": "Afghanistan",
"CountryCode": "AF",
"numericCode": "004",
"nativeName": "افغانستان",
"Region": "Asia",
"SubRegion": "Southern Asia"
},
{
"countryID": "2",
"countryName": "Aland Islands",
"CountryCode": "AX",
"numericCode": "248",
"nativeName": "Åland",
"Region": "Europe",
"SubRegion": "Northern Europe"
},
{
"countryID": "3",
"countryName": "Albania",
"CountryCode": "AL",
"numericCode": "008",
"nativeName": "Shqipëria",
"Region": "Europe",
"SubRegion": "Southern Europe"
}
]
curl --location --request GET 'https://zylalabs.com/api/6794/geosource+api/10207/countries+list' --header 'Authorization: Bearer YOUR_API_KEY'
देश की राजधानी प्राप्त करें
देशानुसार राजधानी - एंडपॉइंट फीचर्स
| ऑब्जेक्ट | विवरण |
|---|---|
country |
[आवश्यक] |
[
{
"countryName": "United States",
"CountryCode": "US",
"Capital": "Washington"
}
]
curl --location --request GET 'https://zylalabs.com/api/6794/geosource+api/10208/capital+by+country?country=us' --header 'Authorization: Bearer YOUR_API_KEY'
देश द्वारा फोन कोड प्राप्त करें
देश द्वारा फोन कोड - एंडपॉइंट फीचर्स
| ऑब्जेक्ट | विवरण |
|---|---|
country |
[आवश्यक] |
[
{
"CountryName": "United States",
"CountryCode": "US",
"PhoneCode": "+1"
}
]
curl --location --request GET 'https://zylalabs.com/api/6794/geosource+api/10209/phone+code+by+country?country=us' --header 'Authorization: Bearer YOUR_API_KEY'
देश के अनुसार मुद्रा प्राप्त करें
देश के द्वारा मुद्रा - एंडपॉइंट फीचर्स
| ऑब्जेक्ट | विवरण |
|---|---|
country |
[आवश्यक] |
[
{
"CountryName": "United States",
"CountryCode": "US",
"Currency": "USD",
"CurrencySymbol": "$"
}
]
curl --location --request GET 'https://zylalabs.com/api/6794/geosource+api/10214/currency+by+country?country=us' --header 'Authorization: Bearer YOUR_API_KEY'
देश के अनुसार इमोजी झंडा प्राप्त करें
देश द्वारा इमोजी ध्वज - एंडपॉइंट फीचर्स
| ऑब्जेक्ट | विवरण |
|---|---|
country |
[आवश्यक] |
[
{
"CountryName": "United States",
"CountryCode": "US",
"emojiU": "U+1F1FA U+1F1F8"
}
]
curl --location --request GET 'https://zylalabs.com/api/6794/geosource+api/10215/emoji+flag+by+country?country=eg' --header 'Authorization: Bearer YOUR_API_KEY'
देश द्वारा राज्य प्राप्त करें
देशों के अनुसार राज्य - एंडपॉइंट फीचर्स
| ऑब्जेक्ट | विवरण |
|---|---|
country |
[आवश्यक] |
[
{
"StateName": "Alabama",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "32.3182314",
"longitude": "-86.902298"
},
{
"StateName": "Alaska",
"StateCode": "AK",
"CountryCode": "US",
"latitude": "64.2008413",
"longitude": "-149.4936733"
}
]
curl --location --request GET 'https://zylalabs.com/api/6794/geosource+api/10216/states+by+country?country=us' --header 'Authorization: Bearer YOUR_API_KEY'
राज्य द्वारा शहर - एंडपॉइंट फीचर्स
| ऑब्जेक्ट | विवरण |
|---|---|
state |
[आवश्यक] |
[
{
"CityName": "Abbeville",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "31.57184000",
"longitude": "-85.25049000"
},
{
"CityName": "Adamsville",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.60094000",
"longitude": "-86.95611000"
}
]
curl --location --request GET 'https://zylalabs.com/api/6794/geosource+api/10217/cities+by+state?state=alabama' --header 'Authorization: Bearer YOUR_API_KEY'
शहर द्वारा स्थान (अक्षांश और देशांतर) प्राप्त करें
शहर द्वारा स्थान - एंडपॉइंट फीचर्स
| ऑब्जेक्ट | विवरण |
|---|---|
city |
[आवश्यक] |
[
{
"CityName": "El Cairo",
"StateCode": "VAC",
"CountryCode": "CO",
"latitude": "4.74889000",
"longitude": "-76.24443000"
},
{
"CityName": "Cairo",
"StateCode": "C",
"CountryCode": "EG",
"latitude": "30.06263000",
"longitude": "31.24967000"
},
{
"CityName": "New Cairo",
"StateCode": "C",
"CountryCode": "EG",
"latitude": "30.03000000",
"longitude": "31.47000000"
},
{
"CityName": "Cairon",
"StateCode": "NOR",
"CountryCode": "FR",
"latitude": "49.24017000",
"longitude": "-0.45046000"
},
{
"CityName": "Cairo Montenotte",
"StateCode": "42",
"CountryCode": "IT",
"latitude": "44.39790000",
"longitude": "8.27775000"
},
{
"CityName": "Gropello Cairoli",
"StateCode": "25",
"CountryCode": "IT",
"latitude": "45.17707000",
"longitude": "8.99353000"
},
{
"CityName": "Pieve del Cairo",
"StateCode": "25",
"CountryCode": "IT",
"latitude": "45.04920000",
"longitude": "8.80322000"
},
{
"CityName": "Cairo",
"StateCode": "GA",
"CountryCode": "US",
"latitude": "30.87751000",
"longitude": "-84.20214000"
},
{
"CityName": "Cairo",
"StateCode": "IL",
"CountryCode": "US",
"latitude": "37.00533000",
"longitude": "-89.17646000"
},
{
"CityName": "Cairo",
"StateCode": "NY",
"CountryCode": "US",
"latitude": "42.29897000",
"longitude": "-73.99847000"
}
]
curl --location --request GET 'https://zylalabs.com/api/6794/geosource+api/10218/location+by+city?city=Abbeville' --header 'Authorization: Bearer YOUR_API_KEY'
शहर द्वारा ज़िप कोड प्राप्त करें
शहर द्वारा ज़िप कोड - एंडपॉइंट फीचर्स
| ऑब्जेक्ट | विवरण |
|---|---|
city |
[आवश्यक] |
[
{
"CityName": "Brussels",
"StateCode": "BRU",
"CountryCode": "BE",
"latitude": "50.85045000",
"longitude": "4.34878000",
"zip": [
"1000"
]
},
{
"CityName": "Brussels",
"StateCode": "ON",
"CountryCode": "CA",
"latitude": "43.73339000",
"longitude": "-81.24975000",
"zip": [
"N0G 0B2",
"N0G 1H0"
]
},
{
"CityName": "Brussels",
"StateCode": "WI",
"CountryCode": "US",
"latitude": "44.73611000",
"longitude": "-87.62093000",
"zip": [
"54204",
"62013",
"09714",
"09724"
]
}
]
curl --location --request GET 'https://zylalabs.com/api/6794/geosource+api/10223/zip+code+by+city?city=Abbeville' --header 'Authorization: Bearer YOUR_API_KEY'
| हेडर | विवरण |
|---|---|
Authorization
|
[आवश्यक] होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें। |
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
प्रत्येक एंडपॉइंट विशिष्ट भू-जानकारी लौटाता है उदाहरण के लिए `/CountriesList` देश के नाम कोड और क्षेत्रों को प्रदान करता है जबकि `/CapitalByCountry` एक निर्दिष्ट देश की राजधानी शहर लौटाता है अन्य एंडपॉइंट फोन कोड मुद्राएँ राज्य शहर स्थान और ज़िप कोड पर डेटा प्रदान करते हैं
मुख्य क्षेत्रों में भिन्नता प्रदान बिंदु के अनुसार होती है `/CountriesList` के लिए, क्षेत्रों में `countryID`, `countryName`, और `Region` शामिल हैं `/CurrencyByCountry` के लिए, क्षेत्रों में `CountryName`, `Currency`, और `CurrencySymbol` शामिल हैं प्रत्येक बिंदु का उत्तर संरचना उस डेटा के अनुसार होती है जो वह प्रदान करता है
प्रत्येक एंडपॉइंट के लिए विशिष्ट क्वेरी पैरामीटर होते हैं उदाहरण के लिए `/CapitalByCountry` को `country` पैरामीटर की आवश्यकता होती है जबकि `/citiesByState` को `state` पैरामीटर की आवश्यकता होती है उपयोगकर्ताओं को सटीक डेटा प्राप्त करने के लिए मान्य देश या राज्य के नाम प्रदान करने होंगे
प्रतिक्रिया डेटा JSON वस्तुओं के अनुरूप में संरचित है प्रत्येक वस्तु में अनुरोधित डेटा के लिए प्रासंगिक फ़ील्ड होते हैं उदाहरण के लिए `/LocationByCity` से प्रतिक्रिया में `CityName` `latitude` और `longitude` शामिल हैं जिससे इसे अनुप्रयोगों में पार्स करना और उपयोग करना आसान हो जाता है
GeoSource API विश्वसनीय भूगोलिक और सरकारी स्रोतों से डेटा एकत्र करता है ताकि सटीकता सुनिश्चित की जा सके डेटा को नियमित रूप से अद्यतन किया जाता है ताकि भू-राजनीतिक सीमाओं मुद्रा और अन्य प्रासंगिक जानकारी में परिवर्तनों को दर्शाया जा सके उच्च गुणवत्ता और विश्वसनीयता बनाए रखते हुए
विशिष्ट उपयोग के मामलों में यात्रा एप्लिकेशन शामिल हैं जिन्हें देश और शहर की जानकारी की आवश्यकता होती है ई-कॉमर्स प्लेटफार्मों को मुद्रा डेटा की आवश्यकता होती है और लॉजिस्टिक्स सेवाएं जो शिपिंग के लिए ज़िप कोड और स्थान विवरण का उपयोग करती हैं डेवलपर्स सटीक भू-जानकारी के साथ उपयोगकर्ता अनुभव को बढ़ा सकते हैं
उपयोगकर्ता प्राप्त डेटा को अनुप्रयोगों में एकीकृत कर सकते हैं JSON उत्तरों को पार्स करके उदाहरण के लिए /LocationByCity से `latitude` और `longitude` का उपयोग करके डेवलपर्स मानचित्र प्रदर्शित कर सकते हैं या दूरी निकाल सकते हैं प्रत्येक एंडपॉइंट का संरचित डेटा सीधी कार्यान्वयन की अनुमति देता है
यदि कोई एंडपॉइंट आंशिक या खाली परिणाम लौटाता है तो उपयोगकर्ताओं को अपने अनुप्रयोगों में त्रुटि प्रबंधन लागू करना चाहिए उदाहरण के लिए यदि `/citiesByState` में किसी राज्य के लिए कोई शहर नहीं मिलता है तो अनुप्रयोग उपयोगकर्ता से राज्य नाम को जांचने या वैकल्पिक सुझाव देने के लिए कह सकता है
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
625ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,099ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
832ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,147ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
828ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,272ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
848ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
1,939ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
54ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
62ms
सर्विस लेवल:
50%
रिस्पॉन्स टाइम:
1,183ms
सर्विस लेवल:
50%
रिस्पॉन्स टाइम:
1,703ms
सर्विस लेवल:
50%
रिस्पॉन्स टाइम:
10,498ms
सर्विस लेवल:
50%
रिस्पॉन्स टाइम:
5,192ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
4,733ms
सर्विस लेवल:
50%
रिस्पॉन्स टाइम:
9,245ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
2,896ms
सर्विस लेवल:
50%
रिस्पॉन्स टाइम:
5,854ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,284ms
सर्विस लेवल:
100%
रिस्पॉन्स टाइम:
3,831ms