世界城市自动完成功能 API

API ID 14562

快速城市自动补全 236000个地点 16种语言 无口音干扰 带地区 国家和时区

API 文档

端点

请求
即时搜索:在16种语言中忽略地方名称的开头、重音、大小写和标点符号、“St.”/“Saint”、“Ste”、“Mt”、“Ft”均可互换,并且在输入中的单词(“st”)可以同时搜索。根据人口排名,精确匹配优先(得分 = log10(人口)+ 1(匹配精确)+ 1(地方自己的名称或您的语言中的名称),对首都、座位、缩写和历史名称给予较小的加分)。防抖击键输入(每次调用都算数)
Endpoint ID: 37310
GET https://zylalabs.com/api/14562/world+city+autocomplete+api/37310/city+typeahead+prefix+search
输入参数

城市前缀搜索 — 端点功能

对象 描述
q 必需 The start of a place name (1-100 characters).
country 可选 Only these countries: ISO 3166-1 alpha-2 codes, comma-separated (up to 10).
admin1 可选 Only this region (needs exactly one country): its code from /admin1 ("CA", "02") or its name ("California", "Bayern").
limit 可选 Results, 1-50 (default 10).
lang 可选 Show names in this language (place, region and country): ar, de, en, es, fr, hi, it, ja, ko, nl, pl, pt, ru, tr, uk or zh ("en-US" works too). Without it, places carry GeoNames' own name (usually the local or international one). Searching always matches every language.
minPopulation 可选 Only places with at least this many people (default 0).

剩余免费测试请求:3 / 3。


输入参数

q
country
admin1
limit
lang
minPopulation
API 示例响应
JSON
{
    "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' 


    
请求
关于一个地方的所有信息:16种语言的名称、地区、县、国家、坐标、人口、海拔以及其当前的时区和UTC偏移量,包括一月和七月的时区(计算时会遵循夏令时规则)。
Endpoint ID: 37311
GET https://zylalabs.com/api/14562/world+city+autocomplete+api/37311/one+place+by+geonames+id
输入参数

一个地方由GeoNames ID — 端点功能

对象 描述
lang 可选 Show names in this language (place, region and country): ar, de, en, es, fr, hi, it, ja, ko, nl, pl, pt, ru, tr, uk or zh ("en-US" works too). Without it, places carry GeoNames' own name (usually the local or international one). Searching always matches every language.
geonameId 必需

剩余免费测试请求:3 / 3。


输入参数

lang
API 示例响应
JSON
{
    "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"
    }
}
一个地方由GeoNames ID — 代码片段

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' 


    
请求
半径内的地点,最近的优先,距离以公里为单位(大圆)
Endpoint ID: 37312
GET https://zylalabs.com/api/14562/world+city+autocomplete+api/37312/places+near+a+point
输入参数

地点附近 — 端点功能

对象 描述
lat 必需 Latitude, decimal degrees (-90 to 90).
lng 必需 Longitude, decimal degrees (-180 to 180).
radius 可选 Radius in km, 1-200 (default 25).
limit 可选 Results, 1-100 (default 20).
minPopulation 可选 Only places with at least this many people (default 0).
lang 可选 Show names in this language (place, region and country): ar, de, en, es, fr, hi, it, ja, ko, nl, pl, pt, ru, tr, uk or zh ("en-US" works too). Without it, places carry GeoNames' own name (usually the local or international one). Searching always matches every language.

剩余免费测试请求:3 / 3。


输入参数

lat
lng
radius
limit
minPopulation
lang
API 示例响应
JSON
{
    "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' 


    
请求
最近有人口的地方(在150公里内,否则为600公里)的IANA时区 当前的UTC偏移 是否开启夏令时 当地时间 以及“协议”(5个最邻近地点中有多少共享该时区)警告:这不是时区边界查找 在边界附近 海上或空地上可能不准确
Endpoint ID: 37313
GET https://zylalabs.com/api/14562/world+city+autocomplete+api/37313/time+zone+at+a+point+nearest+place
输入参数

附近地点的时区 — 端点功能

对象 描述
lat 必需 Latitude, decimal degrees (-90 to 90).
lng 必需 Longitude, decimal degrees (-180 to 180).

剩余免费测试请求:3 / 3。


输入参数

lat
lng
API 示例响应
JSON
{
    "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' 


    
请求
252个国家和地区:ISO代码 名称(您的语言中) 首都 大陆 人口 面积 货币 区号 语言 邻国 邮政编码格式 以及我们有多少个地方
Endpoint ID: 37314
GET https://zylalabs.com/api/14562/world+city+autocomplete+api/37314/all+countries
输入参数

所有国家 — 端点功能

对象 描述
lang 可选 Show names in this language (place, region and country): ar, de, en, es, fr, hi, it, ja, ko, nl, pl, pt, ru, tr, uk or zh ("en-US" works too). Without it, places carry GeoNames' own name (usually the local or international one). Searching always matches every language.

剩余免费测试请求:3 / 3。


输入参数

lang
API 示例响应
JSON
{
    "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' 


    
请求
一级地区及其GeoNames代码(可用作/autocomplete中的admin1)名称和地点数量
Endpoint ID: 37315
GET https://zylalabs.com/api/14562/world+city+autocomplete+api/37315/regions+states+provinces+of+a+country
输入参数

国家的地区州省 — 端点功能

对象 描述
country 必需 ISO 3166-1 alpha-2 code.
lang 可选 Show names in this language (place, region and country): ar, de, en, es, fr, hi, it, ja, ko, nl, pl, pt, ru, tr, uk or zh ("en-US" works too). Without it, places carry GeoNames' own name (usually the local or international one). Searching always matches every language.

剩余免费测试请求:3 / 3。


输入参数

country
lang
API 示例响应
JSON
{
    "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 端点。要使用 世界城市自动完成功能 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

快速城市自动补全:236,000个地点,16种语言,口音无障碍,包含地区、国家和时区

世界城市自动完成功能 API FAQs

每个端点返回特定的地理数据 城市自动完成功能根据前缀搜索提供地点名称和详细信息 通过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`为零,则表示未找到匹配项。对于部分结果,用户可以显示可用选项并提示用户细化搜索。对输入实施防抖也可以减少不必要的请求并改善用户体验

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API