{
"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'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Autocompletar Ciudad Mundial API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento.
Autocompletar de tipo ciudad rápida: 236,000 lugares, 16 idiomas, a prueba de acentos, con región, país y zona horaria
Cada punto final devuelve datos geográficos específicos El tipo de autocompletar de ciudad proporciona nombres de lugares y detalles basados en una búsqueda por prefijo El lugar único por ID de GeoNames devuelve información completa sobre una ubicación específica El punto final Lugares cerca de un punto enumera ubicaciones cercanas mientras que la zona horaria en un punto proporciona detalles de la zona horaria El punto final Todos los países proporciona información sobre países y el punto final Regiones estados provincias de un país enumera las regiones de primer nivel
Los campos clave varían según el punto final. Para la búsqueda anticipada de ciudades, los campos incluyen `geonameId`, `nombre`, `población` y `zona horaria`. El punto final de un lugar incluye `lat`, `lng`, `población` y `elevación`. Los lugares cerca de un punto devuelven `distanciaKm`, `etiqueta` y `región`. El punto final de zona horaria presenta `utcOffsetNow`, `dstNow` y `ciudadMásCercana`. El punto final de todos los países incluye `código`, `capital`, `población` y `idiomas`
Los parámetros varían según el extremo. El tipo de sugerencia de la ciudad acepta un `prefijo` para buscar. El lugar One por ID de GeoNames requiere un `geonameId`. Los lugares cerca de un punto necesitan `lat`, `lng` y `radioKm`. El extremo de zona horaria utiliza `lat` y `lng` para encontrar el lugar más cercano. El extremo de todos los países no requiere parámetros, mientras que el extremo de regiones estados provincias requiere un `código de país`
Los datos de respuesta están estructurados en formato JSON. Cada endpoint devuelve un objeto que contiene campos relevantes. Por ejemplo, el tipo de autocompletado de ciudad devuelve una `query`, `count` y un array de `results`. El endpoint de un lugar devuelve información detallada sobre una ubicación en un solo objeto. El endpoint de lugares cerca de un punto devuelve un `lat`, `lng` y un array de `results`, mientras que el endpoint de todos los países devuelve un `count` y un array de `countries`
Los datos provienen de GeoNames (geonames.org), que proporciona una base de datos completa de información geográfica. La API también puede incorporar modificaciones adicionales de datos para mejorar la precisión. Los controles de calidad incluyen actualizaciones regulares y validación contra estándares geográficos conocidos para mantener la integridad de los datos
Los casos de uso típicos incluyen servicios basados en ubicación, aplicaciones de viaje y análisis geográfico. Los desarrolladores pueden usar el tipo de autocompletar de ciudad para sugerencias de búsqueda, el endpoint de un lugar para información detallada de la ubicación y los lugares cercanos a un punto para encontrar atracciones cercanas. El endpoint de zona horaria es útil para la programación en diferentes regiones, mientras que el endpoint de todos los países ayuda en el análisis de datos globales
Los usuarios pueden utilizar los datos devueltos al analizar la respuesta JSON para extraer campos relevantes para sus aplicaciones Por ejemplo pueden mostrar los nombres de las ciudades y las poblaciones en una interfaz de búsqueda o usar coordenadas para aplicaciones de mapeo Entender la estructura permite un manejo de datos eficiente e integración en diversas soluciones de software
Al manejar resultados parciales o vacíos, los usuarios deben implementar verificaciones para el campo `count` en la respuesta. Si `count` es cero, indica que no se encontraron coincidencias. Para resultados parciales, los usuarios pueden mostrar las opciones disponibles y solicitar a los usuarios que refinen su búsqueda. Implementar debounce en la entrada también puede reducir solicitudes innecesarias y mejorar la experiencia del usuario