{
"query": "mün",
"searched": [
"mun"
],
"count": 5,
"results": [
{
"geonameId": 4924006,
"name": "مونسي",
"localName": "Muncie",
"label": "مونسي, إنديانا, الولايات المتحدة الأمريكية",
"region": {
"code": "IN",
"name": "إنديانا"
},
"county": {
"code": "035",
"name": "Delaware County"
},
"country": {
"code": "US",
"name": "الولايات المتحدة الأمريكية"
},
"population": 70087,
"lat": 40.19338,
"lng": -85.38636,
"timezone": "America/Indiana/Indianapolis",
"featureCode": "PPLA2",
"matched": {
"name": "Muncie",
"kind": "name",
"exact": false
},
"score": 5.996
},
{
"geonameId": 4903184,
"name": "موندلين",
"localName": "Mundelein",
"label": "موندلين, إلينوي, الولايات المتحدة الأمريكية",
"region": {
"code": "IL",
"name": "إلينوي"
},
"county": {
"code": "097",
"name": "Lake County"
},
"country": {
"code": "US",
"name": "الولايات المتحدة الأمريكية"
},
"population": 31582,
"lat": 42.26308,
"lng": -88.00397,
"timezone": "America/Chicago",
"featureCode": "PPL",
"matched": {
"name": "Mundelein",
"kind": "name",
"exact": false
},
"score": 5.5
},
{
"geonameId": 4924014,
"name": "Munster",
"label": "Munster, إنديانا, الولايات المتحدة الأمريكية",
"region": {
"code": "IN",
"name": "إنديانا"
},
"county": {
"code": "089",
"name": "Lake County"
},
"country": {
"code": "US",
"name": "الولايات المتحدة الأمريكية"
},
"population": 22984,
"lat": 41.56448,
"lng": -87.51254,
"timezone": "America/Chicago",
"featureCode": "PPL",
"matched": {
"name": "Munster",
"kind": "name",
"exact": false
},
"score": 5.362
},
{
"geonameId": 5202734,
"name": "Munhall",
"label": "Munhall, بنسيلفانيا, الولايات المتحدة الأمريكية",
"region": {
"code": "PA",
"name": "بنسيلفانيا"
},
"county": {
"code": "003",
"name": "Allegheny County"
},
"country": {
"code": "US",
"name": "الولايات المتحدة الأمريكية"
},
"population": 11247,
"lat": 40.39229,
"lng": -79.90005,
"timezone": "America/New_York",
"featureCode": "PPL",
"matched": {
"name": "Munhall",
"kind": "name",
"exact": false
},
"score": 5.051
},
{
"geonameId": 4644282,
"name": "مونفورد",
"localName": "Munford",
"label": "مونفورد, تينيسي, الولايات المتحدة الأمريكية",
"region": {
"code": "TN",
"name": "تينيسي"
},
"county": {
"code": "167",
"name": "Tipton County"
},
"country": {
"code": "US",
"name": "الولايات المتحدة الأمريكية"
},
"population": 6108,
"lat": 35.44925,
"lng": -89.81508,
"timezone": "America/Chicago",
"featureCode": "PPL",
"matched": {
"name": "Munford",
"kind": "name",
"exact": false
},
"score": 4.787
}
],
"source": {
"data": "GeoNames (geonames.org), CC BY 4.0; changed by us (see /attribution)",
"license": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "/attribution"
}
}
curl --location --request GET 'https://zylalabs.com/api/14562/world+city+autocomplete+api/37310/city+typeahead+prefix+search?q=mün&country=US&limit=5&lang=ar&minPopulation=Optional' --header 'Authorization: Bearer YOUR_API_KEY'
{
"geonameId": 2867714,
"name": "ميونخ",
"localName": "Munich",
"label": "ميونخ, بفاريا, ألمانيا",
"region": {
"code": "02",
"name": "بفاريا"
},
"county": {
"code": "091",
"name": "Upper Bavaria"
},
"country": {
"code": "DE",
"name": "ألمانيا"
},
"population": 1505005,
"lat": 48.13743,
"lng": 11.57549,
"timezone": {
"id": "Europe/Berlin",
"utcOffsetNow": "+01:00",
"dstNow": false,
"localTimeNow": "2026-10-28T02:51:00",
"utcOffsetJanuary": "+01:00",
"utcOffsetJuly": "+02:00"
},
"featureCode": "PPLA",
"asciiName": "Munich",
"elevation": 524,
"names": {
"ar": "ميونخ",
"de": "München",
"en": "Munich",
"es": "Múnich",
"fr": "Munich",
"hi": "म्यूनिख",
"it": "Monaco di Baviera",
"ja": "ミュンヘン",
"ko": "뮌헨",
"nl": "München",
"pl": "Monachium",
"pt": "Munique",
"ru": "Мюнхен",
"tr": "Münih",
"uk": "Мюнхен",
"zh": "慕尼黑"
},
"modified": "2026-05-06",
"source": {
"data": "GeoNames (geonames.org), CC BY 4.0; changed by us (see /attribution)",
"license": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "/attribution"
}
}
curl --location --request GET 'https://zylalabs.com/api/14562/world+city+autocomplete+api/37311/one+place+by+geonames+id?lang=ar&geonameId=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"lat": 48.137,
"lng": 11.575,
"radiusKm": 10,
"count": 3,
"results": [
{
"geonameId": 2867714,
"name": "ميونخ",
"localName": "Munich",
"label": "ميونخ, بفاريا, ألمانيا",
"region": {
"code": "02",
"name": "بفاريا"
},
"county": {
"code": "091",
"name": "Upper Bavaria"
},
"country": {
"code": "DE",
"name": "ألمانيا"
},
"population": 1505005,
"lat": 48.13743,
"lng": 11.57549,
"timezone": "Europe/Berlin",
"featureCode": "PPLA",
"distanceKm": 0.06
},
{
"geonameId": 2947022,
"name": "Bogenhausen",
"label": "Bogenhausen, بفاريا, ألمانيا",
"region": {
"code": "02",
"name": "بفاريا"
},
"county": {
"code": "091",
"name": "Upper Bavaria"
},
"country": {
"code": "DE",
"name": "ألمانيا"
},
"population": 77542,
"lat": 48.15221,
"lng": 11.61585,
"timezone": "Europe/Berlin",
"featureCode": "PPLX",
"distanceKm": 3.47
},
{
"geonameId": 2819568,
"name": "Unterföhring",
"label": "Unterföhring, بفاريا, ألمانيا",
"region": {
"code": "02",
"name": "بفاريا"
},
"county": {
"code": "091",
"name": "Upper Bavaria"
},
"country": {
"code": "DE",
"name": "ألمانيا"
},
"population": 10500,
"lat": 48.19253,
"lng": 11.64293,
"timezone": "Europe/Berlin",
"featureCode": "PPLA4",
"distanceKm": 7.97
}
],
"source": {
"data": "GeoNames (geonames.org), CC BY 4.0; changed by us (see /attribution)",
"license": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "/attribution"
}
}
curl --location --request GET 'https://zylalabs.com/api/14562/world+city+autocomplete+api/37312/places+near+a+point?lat=48.137&lng=11.575&radius=10&limit=3&minPopulation=Optionallang=ar' --header 'Authorization: Bearer YOUR_API_KEY'
{
"lat": 40.7128,
"lng": -74.006,
"timezone": {
"id": "America/New_York",
"utcOffsetNow": "-04:00",
"dstNow": true,
"localTimeNow": "2026-10-27T21:51:01",
"utcOffsetJanuary": "-05:00",
"utcOffsetJuly": "-04:00"
},
"nearestCity": {
"geonameId": 5128581,
"name": "New York City",
"country": "US",
"distanceKm": 0.16
},
"agreement": {
"nearestPlaces": 5,
"sameTimezone": 5,
"otherTimezones": []
},
"caveat": "The time zone of the nearest populated place, not a time zone boundary lookup: near a border, at sea or in empty land it can be wrong. Check \"agreement\" and \"nearestCity.distanceKm\".",
"source": {
"data": "GeoNames (geonames.org), CC BY 4.0; changed by us (see /attribution)",
"license": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "/attribution"
}
}
curl --location --request GET 'https://zylalabs.com/api/14562/world+city+autocomplete+api/37313/time+zone+at+a+point+nearest+place?lat=40.7128&lng=-74.006' --header 'Authorization: Bearer YOUR_API_KEY'
{
"count": 252,
"countries": [
{
"code": "AW",
"iso3": "ABW",
"isoNumeric": "533",
"name": "آروبا",
"englishName": "Aruba",
"capital": "Oranjestad",
"continent": "NA",
"population": 108785,
"areaKm2": 193,
"currency": {
"code": "AWG",
"name": "Guilder"
},
"phone": "297",
"tld": ".aw",
"languages": [
"nl-AW",
"pap",
"es",
"en"
],
"neighbours": [],
"postalCodeFormat": null,
"geonameId": 3577279,
"places": 14
},
{
"code": "IS",
"iso3": "ISL",
"isoNumeric": "352",
"name": "آيسلندا",
"englishName": "Iceland",
"capital": "Reykjavik",
"continent": "EU",
"population": 392404,
"areaKm2": 103000,
"currency": {
"code": "ISK",
"name": "Krona"
},
"phone": "354",
"tld": ".is",
"languages": [
"is",
"en",
"de",
"da",
"sv"
],
"neighbours": [],
"postalCodeFormat": "###",
"geonameId": 2629691,
"places": 50
},
{
"code": "ET",
"iso3": "ETH",
"isoNumeric": "231",
"name": "إثيوبيا",
"englishName": "Ethiopia",
"capital": "Addis Ababa",
"continent": "AF",
"population": 135472051,
"areaKm2": 1127127,
"currency": {
"code": "ETB",
"name": "Birr"
},
"phone": "251",
"tld": ".et",
"languages": [
"am",
"en-ET",
"om-ET",
"ti-ET",
"so-ET"
],
"neighbours": [
"ER",
"KE",
"SD",
"SS",
"SO"
],
"postalCodeFormat": "####",
"geonameId": 337996,
"places": 256
},
{
"code": "AZ",
"iso3": "AZE",
"isoNumeric": "031",
"name": "أذربيجان",
"englishName": "Azerbaijan",
"capital": "Baku",
"continent": "AS",
"population": 10246996,
"areaKm2": 86600,
"currency": {
"code": "AZN",
"name": "Manat"
},
"phone": "994",
"tld": ".az",
"languages": [
"az",
"ru",
"hy"
],
"neighbours": [
"GE",
"IR",
"AM",
"TR",
"RU"
],
"postalCodeFormat": "AZ ####",
"geonameId": 587116,
"places": 245
},
{
"code": "AM",
"iso3": "ARM",
"isoNumeric": "051",
"name": "أرمينيا",
"englishName": "Armenia",
"capital": "Yerevan",
"continent": "AS",
"population": 3086700,
"areaKm2": 29800,
"currency": {
"code": "AMD",
"name": "Dram"
},
"phone": "374",
"tld": ".am",
"languages": [
"hy"
],
"neighbours": [
"GE",
"IR",
"AZ",
"TR"
],
"postalCodeFormat": "####",
"geonameId": 174982,
"places": 625
}
],
"source": {
"data": "GeoNames (geonames.org), CC BY 4.0; changed by us (see /attribution)",
"license": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "/attribution"
}
}
curl --location --request GET 'https://zylalabs.com/api/14562/world+city+autocomplete+api/37314/all+countries?lang=ar' --header 'Authorization: Bearer YOUR_API_KEY'
{
"country": {
"code": "CH",
"name": "سويسرا"
},
"count": 26,
"regions": [
{
"code": "AR",
"name": "أبينزيل أوسيرهودن",
"asciiName": "Appenzell Ausserrhoden",
"geonameId": 2661739,
"places": 13
},
{
"code": "AI",
"name": "أبينزيل إينرهودن",
"asciiName": "Appenzell Innerrhoden",
"geonameId": 2661741,
"places": 4
},
{
"code": "OW",
"name": "أوبفالدن",
"asciiName": "Obwalden",
"geonameId": 2659315,
"places": 7
},
{
"code": "UR",
"name": "أوري",
"asciiName": "Uri",
"geonameId": 2658226,
"places": 15
},
{
"code": "ZG",
"name": "تسوغ",
"asciiName": "Zug",
"geonameId": 2657907,
"places": 9
},
{
"code": "TG",
"name": "تورغاو",
"asciiName": "Thurgau",
"geonameId": 2658372,
"places": 54
},
{
"code": "TI",
"name": "تيسينو",
"asciiName": "Ticino",
"geonameId": 2658370,
"places": 84
},
{
"code": "JU",
"name": "جورا",
"asciiName": "Jura",
"geonameId": 2660207,
"places": 28
},
{
"code": "SO",
"name": "سولوتورن",
"asciiName": "Solothurn",
"geonameId": 2658563,
"places": 52
},
{
"code": "SH",
"name": "شافهوزن",
"asciiName": "Schaffhausen",
"geonameId": 2658760,
"places": 20
},
{
"code": "SZ",
"name": "شفيتس",
"asciiName": "Schwyz",
"geonameId": 2658664,
"places": 33
},
{
"code": "GR",
"name": "غروبندن",
"asciiName": "Grisons",
"geonameId": 2660522,
"places": 79
},
{
"code": "GL",
"name": "غلاروس",
"asciiName": "Glarus",
"geonameId": 2660593,
"places": 14
},
{
"code": "VS",
"name": "فاليه",
"asciiName": "Valais",
"geonameId": 2658205,
"places": 88
},
{
"code": "VD",
"name": "فود",
"asciiName": "Vaud",
"geonameId": 2658182,
"places": 143
},
{
"code": "AG",
"name": "كانتون أرجاو",
"asciiName": "Aargau",
"geonameId": 2661876,
"places": 132
},
{
"code": "BL",
"name": "كانتون بازل الريف",
"asciiName": "Basel-Landschaft",
"geonameId": 2661603,
"places": 53
},
{
"code": "BE",
"name": "كانتون برن",
"asciiName": "Bern",
"geonameId": 2661551,
"places": 211
},
{
"code": "GE",
"name": "كانتون جنيف",
"asciiName": "Geneva",
"geonameId": 2660645,
"places": 36
},
{
"code": "ZH",
"name": "كانتون زيوريخ",
"asciiName": "Zurich",
"geonameId": 2657895,
"places": 550
},
{
"code": "SG",
"name": "كانتون سانت غالن",
"asciiName": "Saint Gallen",
"geonameId": 2658821,
"places": 74
},
{
"code": "FR",
"name": "كانتون فريبورغ",
"asciiName": "Fribourg",
"geonameId": 2660717,
"places": 77
},
{
"code": "BS",
"name": "كانتون مدينة بازل",
"asciiName": "Basel-City",
"geonameId": 2661602,
"places": 4
},
{
"code": "LU",
"name": "لوتسيرن",
"asciiName": "Lucerne",
"geonameId": 2659810,
"places": 73
},
{
"code": "NW",
"name": "نيدفالدن",
"asciiName": "Nidwalden",
"geonameId": 2659471,
"places": 9
},
{
"code": "NE",
"name": "نيوشاتل",
"asciiName": "Neuchatel",
"geonameId": 2659495,
"places": 37
}
],
"note": "Codes are GeoNames admin1 codes: ISO 3166-2 suffixes for the US, Switzerland, Belgium and Montenegro, FIPS 10-4 or GeoNames codes elsewhere. Use the code or the name as \"admin1\" in /autocomplete.",
"source": {
"data": "GeoNames (geonames.org), CC BY 4.0; changed by us (see /attribution)",
"license": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "/attribution"
}
}
curl --location --request GET 'https://zylalabs.com/api/14562/world+city+autocomplete+api/37315/regions+states+provinces+of+a+country?country=CH&lang=ar' --header 'Authorization: Bearer YOUR_API_KEY'
साइन अप करने के बाद, प्रत्येक डेवलपर को एक पर्सनल API एक्सेस की असाइन की जाती है, जो अक्षरों और अंकों का एक यूनिक संयोजन होता है, जिसका उपयोग हमारे API एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए विश्व शहर ऑटोपूर्ण API के साथ बस अपने बेयरर टोकन को Authorization हेडर में शामिल करें।
| हेडर | विवरण |
|---|---|
Authorization
|
आवश्यक
होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।
|
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें।
प्रत्येक अंत बिंदु विशिष्ट भौगोलिक डेटा लौटाता है सिटी टाइपहेड एक उपसर्ग खोज के आधार पर स्थान नाम और विवरण प्रदान करता है जियोग्नेम्स आईडी द्वारा एक स्थान विशिष्ट स्थान के बारे में व्यापक जानकारी लौटाता है एक बिंदु के पास स्थान अंत बिंदु निकटवर्ती स्थानों की सूची बनाता है जबकि एक बिंदु पर समय क्षेत्र समय क्षेत्र का विवरण देता है सभी देशों का अंत बिंदु देशों के बारे में जानकारी प्रदान करता है और एक देश के क्षेत्रों में राज्य प्रांत पहले स्तर के क्षेत्रों की सूची बनाते हैं
कुंजी फ़ील्ड्स एन्डपॉइंट द्वारा भिन्न होते हैं। सिटी टाइपहेड के लिए, फ़ील्ड्स में `geonameId`, `name`, `population`, और `timezone` शामिल हैं। वन प्लेस एन्डपॉइंट में `lat`, `lng`, `population`, और `elevation` शामिल हैं। प्लेस निअर अ प्वाइंट `distanceKm`, `label`, और `region` लौटाता है। टाइम ज़ोन एन्डपॉइंट में `utcOffsetNow`, `dstNow`, और `nearestCity` शामिल हैं। ऑल कंट्रीज़ एन्डपॉइंट में `code`, `capital`, `population`, और `languages` शामिल हैं।
पैरामीटर endpoint के अनुसार भिन्न होते हैं सिटी टाइपहेड एक `prefix` स्वीकार करता है खोजने के लिए एक स्थान GeoNames ID द्वारा `geonameId` की आवश्यकता होती है एक बिंदु के पास के स्थानों को `lat` `lng` और `radiusKm` की आवश्यकता होती है टाइम ज़ोन endpoint निकटतम स्थान खोजने के लिए `lat` और `lng` का उपयोग करता है सभी देशों का endpoint किसी भी पैरामीटर की आवश्यकता नहीं होती है जबकि क्षेत्रों राज्य प्रांतों का endpoint एक `country code` की आवश्यकता होती है
प्रतिक्रिया डेटा JSON प्रारूप में संरचित है प्रत्येक एंडपॉइंट प्रासंगिक फ़ील्ड्स वाला एक ऑब्जेक्ट लौटाता है उदाहरण के लिए, सिटी टाइपहेड एक `query` `count` और `results` की एक श्रृंखला लौटाता है वन प्लेस एंडपॉइंट एक स्थान के बारे में विस्तृत जानकारी को एकल ऑब्जेक्ट में लौटाता है पॉइंट के पास के स्थान `lat` `lng` और `results` की एक श्रृंखला लौटाते हैं जबकि सभी देशों का एंडपॉइंट एक `count` और `countries` की एक श्रृंखला लौटाता है
डेटा GeoNames (geonames.org) से प्राप्त किया गया है जो भौगोलिक जानकारी का एक व्यापक डेटाबेस प्रदान करता है एपीआई सटीकता को बढ़ाने के लिए अतिरिक्त डेटा संशोधन भी शामिल कर सकता है गुणवत्ता जांच में नियमित अपडेट और ज्ञात भौगोलिक मानकों के खिलाफ मान्यता शामिल है ताकि डेटा की अखंडता को बनाए रखा जा सके
विशिष्ट उपयोग के मामलों में स्थान-आधारित सेवाएं यात्रा अनुप्रयोग और भौगोलिक विश्लेषण शामिल हैं डेवलपर्स खोज सुझावों के लिए शहर टाइपहेड का उपयोग कर सकते हैं विस्तृत स्थान जानकारी के लिए एक स्थान एंडपॉइंट और निकटवर्ती आकर्षण खोजने के लिए एक बिंदु के पास स्थानों का उपयोग कर सकते हैं विभिन्न क्षेत्रों में शेड्यूलिंग के लिए समय क्षेत्र एंडपॉइंट उपयोगी है जबकि सभी देशों का एंडपॉइंट वैश्विक डेटा विश्लेषण में मदद करता है
उपयोगकर्ता अपने अनुप्रयोगों के लिए प्रासंगिक फ़ील्ड को निकालने के लिए JSON प्रतिक्रिया को पार्स करके लौटाए गए डेटा का उपयोग कर सकते हैं उदाहरण के लिए वे एक खोज इंटरफ़ेस में शहर के नाम और जनसंख्या दिखा सकते हैं या मानचित्रण अनुप्रयोगों के लिए समन्वय का उपयोग कर सकते हैं संरचना को समझना प्रभावी डेटा प्रबंधन और विभिन्न सॉफ़्टवेयर समाधानों में एकीकरण की अनुमति देता है
जब आंशिक या खाली परिणामों को संभाला जा रहा हो, उपयोगकर्ताओं को प्रतिक्रिया में `गिनती` फ़ील्ड के लिए जाँचें लागू करनी चाहिए। यदि `गिनती` शून्य है, तो इसका मतलब है कि कोई मेल नहीं मिला। आंशिक परिणामों के लिए, उपयोगकर्ता उपलब्ध विकल्प प्रदर्शित कर सकते हैं और उपयोगकर्ताओं को उनकी खोज को सुधारने के लिए प्रेरित कर सकते हैं। इनपुट पर डेबाउंस लागू करने से बिना कारण के अनुरोधों को कम किया जा सकता है और उपयोगकर्ता अनुभव में सुधार हो सकता है