{
"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 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
每个端点返回特定的地理数据 城市自动完成功能根据前缀搜索提供地点名称和详细信息 通过GeoNames ID获取的单个地点返回特定位置的综合信息 附近地点端点列出附近的地点 而某点的时区则提供时区详细信息 所有国家端点提供有关国家的信息 各国的地区、州、省列出第一层级的区域
关键字段因终端而异。城市类型提示字段包括 `geonameId`、`name`、`population` 和 `timezone`。单个地点终端包括 `lat`、`lng`、`population` 和 `elevation`。靠近某个点的地点返回 `distanceKm`、`label` 和 `region`。时区终端包含 `utcOffsetNow`、`dstNow` 和 `nearestCity`。所有国家的终端包括 `code`、`capital`、`population` 和 `languages`
参数因端点而异 城市类型提示接受用于搜索的前缀 geoname ID 的一个地方需要 geonameId 在某个点附近的地点需要 lat lng 和 radiusKm 时区端点使用 lat 和 lng 找到最近的地方 所有国家端点不需要参数,而区域州省端点需要国家代码
响应数据以 JSON 格式结构化 每个端点返回一个包含相关字段的对象 例如 城市模糊搜索返回一个 `query` `count` 和一个 `results` 数组 一个地点端点返回一个位置的详细信息在一个单一对象中 临近某个点的地点返回一个 `lat` `lng` 和一个 `results` 数组 而所有国家端点返回一个 `count` 和一个 `countries` 数组
数据来源于GeoNames(geonames.org),该网站提供了全面的地理信息数据库 API还可能结合额外的数据修改以提高准确性 质量检查包括定期更新并验证已知的地理标准以维护数据的完整性
典型的用例包括基于位置的服务、旅行应用程序和地理分析。开发人员可以使用城市类型提示获取搜索建议,使用一个地点端点获取详细位置信息,以及使用靠近某个点的地点查找附近的景点。时区端点对于跨不同区域的调度很有用,而所有国家端点则有助于全球数据分析
用户可以通过解析JSON响应来利用返回的数据,以提取其应用程序所需的相关字段。例如,他们可以在搜索界面中显示城市名称和人口,或将坐标用于地图应用。理解结构可以有效地处理数据并集成到各种软件解决方案中
在处理部分或空结果时,用户应检查响应中的`count`字段。如果`count`为零,则表示未找到匹配项。对于部分结果,用户可以显示可用选项并提示用户细化搜索。对输入实施防抖也可以减少不必要的请求并改善用户体验