# 🌐 地理数据查询API
## 概述
**地理数据查询API** 是一个强大可靠的RESTful API,提供249个国家和地区的广泛地理数据。它让开发者能够检索详细和最新的地理、政治和文化信息,以用于从物流到旅行、商业和教育等各类应用。
---
## 🚀 特性
- 🌍 国家名称、首都、电话区号、国旗
- 💱 货币代码和符号
- 🏙️ 州和城市
- 📍 邮政编码和位置查询
- 🌐 支持国家的表情符号旗帜
---
### 支持邮政编码数据的国家
阿尔及利亚、安道尔、阿根廷、亚美尼亚、澳大利亚、奥地利、阿塞拜疆、孟加拉国、白俄罗斯、比利时、巴西、保加利亚、加拿大、智利、哥伦比亚、捷克共和国、法国、德国、危地马拉、海地、匈牙利、冰岛、印度、意大利、墨西哥、摩尔多瓦、摩洛哥、菲律宾、波兰、罗马尼亚、俄罗斯、圣马力诺、塞尔维亚、新加坡、斯洛伐克、斯洛文尼亚、西班牙、斯里兰卡、瑞典、瑞士、泰国、英国、美国、乌拉圭。
## 📌 API端点
所有端点使用**GET**方法。
### 1. `CountriesList`
- **端点**: `/CountriesList`
- **描述**: 检索所有有可用数据的国家的完整列表。
---
### 2. `Capital By Country`
- **端点**: `/CapitalByCountry`
- **查询参数**:
- `country`: 国家名称(例如,`法国`)
- **描述**: 返回指定国家的首都。
---
### 3. `Phone Code By Country`
- **端点**: `/PhoneCodeByCountry`
- **查询参数**:
- `country`: 国家名称(例如,`印度`)
- **描述**: 返回指定国家的国际电话区号。
---
### 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`: 城市名称
- **描述**: 返回给定城市的位置详情(如经纬度)。
---
### 9. `ZipCode By City`
- **端点**: `/ZipCodeByCity`
- **查询参数**:
- `city`: 城市名称
- **描述**: 返回与给定城市相关的邮政编码。
---
国家名单
[
{
"countryID": "1",
"countryName": "Afghanistan",
"CountryCode": "AF",
"numericCode": "004",
"nativeName": "\u0627\u0641\u063a\u0627\u0646\u0633\u062a\u0627\u0646",
"Region": "Asia",
"SubRegion": "Southern Asia"
},
{
"countryID": "2",
"countryName": "Aland Islands",
"CountryCode": "AX",
"numericCode": "248",
"nativeName": "\u00c5land",
"Region": "Europe",
"SubRegion": "Northern Europe"
},
{
"countryID": "3",
"countryName": "Albania",
"CountryCode": "AL",
"numericCode": "008",
"nativeName": "Shqip\u00ebria",
"Region": "Europe",
"SubRegion": "Southern Europe"
},
{
"countryID": "4",
"countryName": "Algeria",
"CountryCode": "DZ",
"numericCode": "012",
"nativeName": "\u0627\u0644\u062c\u0632\u0627\u0626\u0631",
"Region": "Africa",
"SubRegion": "Northern Africa"
},
{
"countryID": "5",
"countryName": "American Samoa",
"CountryCode": "AS",
"numericCode": "016",
"nativeName": "American Samoa",
"Region": "Oceania",
"SubRegion": "Polynesia"
},
{
"countryID": "6",
"countryName": "Andorra",
"CountryCode": "AD",
"numericCode": "020",
"nativeName": "Andorra",
"Region": "Europe",
"SubRegion": "Southern Europe"
},
{
"countryID": "7",
"countryName": "Angola",
"CountryCode": "AO",
"numericCode": "024",
"nativeName": "Angola",
"Region": "Africa",
"SubRegion": "Middle Africa"
},
{
"countryID": "8",
"countryName": "Anguilla",
"CountryCode": "AI",
"numericCode": "660",
"nativeName": "Anguilla",
"Region": "Americas",
"SubRegion": "Caribbean"
},
{
"countryID": "9",
"countryName": "Antarctica",
"CountryCode": "AQ",
"numericCode": "010",
"nativeName": "Antarctica",
"Region": "Antarctica",
"SubRegion": "Antarctica"
},
{
"countryID": "10",
"countryName": "Antigua And Barbuda",
"CountryCode": "AG",
"numericCode": "028",
"nativeName": "Antigua and Barbuda",
"Region": "Americas",
"SubRegion": "Caribbean"
},
{
"countryID": "11",
"countryName": "Argentina",
"CountryCode": "AR",
"numericCode": "032",
"nativeName": "Argentina",
"Region": "Americas",
"SubRegion": "South America"
},
{
"countryID": "12",
"countryName": "Armenia",
"CountryCode": "AM",
"numericCode": "051",
"nativeName": "\u0540\u0561\u0575\u0561\u057d\u057f\u0561\u0576",
"Region": "Asia",
"SubRegion": "Western Asia"
},
{
"countryID": "13",
"countryName": "Aruba",
"CountryCode": "AW",
"numericCode": "533",
"nativeName": "Aruba",
"Region": "Americas",
"SubRegion": "Caribbean"
},
{
"countryID": "14",
"countryName": "Australia",
"CountryCode": "AU",
"numericCode": "036",
"nativeName": "Australia",
"Region": "Oceania",
"SubRegion": "Australia and New Zealand"
},
{
"countryID": "15",
"countryName": "Austria",
"CountryCode": "AT",
"numericCode": "040",
"nativeName": "\u00d6sterreich",
"Region": "Europe",
"SubRegion": "Western Europe"
},
{
"countryID": "16",
"countryName": "Azerbaijan",
"CountryCode": "AZ",
"numericCode": "031",
"nativeName": "Az\u0259rbaycan",
"Region": "Asia",
"SubRegion": "Western Asia"
},
{
"countryID": "17",
"countryName": "Bahamas The",
"CountryCode": "BS",
"numericCode": "044",
"nativeName": "Bahamas",
"Region": "Americas",
"SubRegion": "Caribbean"
},
{
"countryID": "18",
"countryName": "Bahrain",
"CountryCode": "BH",
"numericCode": "048",
"nativeName": "\u200f\u0627\u0644\u0628\u062d\u0631\u064a\u0646",
"Region": "Asia",
"SubRegion": "Western Asia"
},
{
"countryID": "19",
"countryName": "Bangladesh",
"CountryCode": "BD",
"numericCode": "050",
"nativeName": "Bangladesh",
"Region": "Asia",
"SubRegion": "Southern Asia"
},
{
"countryID": "20",
"countryName": "Barbados",
"CountryCode": "BB",
"numericCode": "052",
"nativeName": "Barbados",
"Region": "Americas",
"SubRegion": "Caribbean"
},
{
"countryID": "21",
"countryName": "Belarus",
"CountryCode": "BY",
"numericCode": "112",
"nativeName": "\u0411\u0435\u043b\u0430\u0440\u0443\u0301\u0441\u044c",
"Region": "Europe",
"SubRegion": "Eastern Europe"
},
{
"countryID": "22",
"countryName": "Belgium",
"CountryCode": "BE",
"numericCode": "056",
"nativeName": "Belgi\u00eb",
"Region": "Europe",
"SubRegion": "Western Europe"
},
{
"countryID": "23",
"countryName": "Belize",
"CountryCode": "BZ",
"numericCode": "084",
"nativeName": "Belize",
"Region": "Americas",
"SubRegion": "Central America"
},
{
"countryID": "24",
"countryName": "Benin",
"CountryCode": "BJ",
"numericCode": "204",
"nativeName": "B\u00e9nin",
"Region": "Africa",
"SubRegion": "Western Africa"
},
{
"countryID": "25",
"countryName": "Bermuda",
"CountryCode": "BM",
"numericCode": "060",
"nativeName": "Bermuda",
"Region": "Americas",
"SubRegion": "Northern America"
},
{
"countryID": "26",
"countryName": "Bhutan",
"CountryCode": "BT",
"numericCode": "064",
"nativeName": "\u02bcbrug-yul",
"Region": "Asia",
"SubRegion": "Southern Asia"
},
{
"countryID": "27",
"countryName": "Bolivia",
"CountryCode": "BO",
"numericCode": "068",
"nativeName": "Bolivia",
"Region": "Americas",
"SubRegion": "South America"
},
{
"countryID": "28",
"countryName": "Bonaire, Sint Eustatius and Saba",
"CountryCode": "BQ",
"numericCode": "535",
"nativeName": "Caribisch Nederland",
"Region": "Americas",
"SubRegion": "Caribbean"
},
{
"countryID": "29",
"countryName": "Bosnia and Herzegovina",
"CountryCode": "BA",
"numericCode": "070",
"nativeName": "Bosna i Hercegovina",
"Region": "Europe",
"SubRegion": "Southern Europe"
},
{
"countryID": "30",
"countryName": "Botswana",
"CountryCode": "BW",
"numericCode": "072",
"nativeName": "Botswana",
"Region": "Africa",
"SubRegion": "Southern Africa"
},
{
"countryID": "31",
"countryName": "Bouvet Island",
"CountryCode": "BV",
"numericCode": "074",
"nativeName": "Bouvet\u00f8ya",
"Region": "Antarctica",
"SubRegion": "South Atlantic Ocean"
},
{
"countryID": "32",
"countryName": "Brazil",
"CountryCode": "BR",
"numericCode": "076",
"nativeName": "Brasil",
"Region": "Americas",
"SubRegion": "South America"
},
{
"countryID": "33",
"countryName": "British Indian Ocean Territory",
"CountryCode": "IO",
"numericCode": "086",
"nativeName": "British Indian Ocean Territory",
"Region": "Africa",
"SubRegion": "Eastern Africa"
},
{
"countryID": "34",
"countryName": "Brunei",
"CountryCode": "BN",
"numericCode": "096",
"nativeName": "Negara Brunei Darussalam",
"Region": "Asia",
"SubRegion": "South-Eastern Asia"
},
{
"countryID": "35",
"countryName": "Bulgaria",
"CountryCode": "BG",
"numericCode": "100",
"nativeName": "\u0411\u044a\u043b\u0433\u0430\u0440\u0438\u044f",
"Region": "Europe",
"SubRegion": "Eastern Europe"
},
{
"countryID": "36",
"countryName": "Burkina Faso",
"CountryCode": "BF",
"numericCode": "854",
"nativeName": "Burkina Faso",
"Region": "Africa",
"SubRegion": "Western Africa"
},
{
"countryID": "37",
"countryName": "Burundi",
"CountryCode": "BI",
"numericCode": "108",
"nativeName": "Burundi",
"Region": "Africa",
"SubRegion": "Eastern Africa"
},
{
"countryID": "38",
"countryName": "Cambodia",
"CountryCode": "KH",
"numericCode": "116",
"nativeName": "K\u00e2mp\u016dch\u00e9a",
"Region": "Asia",
"SubRegion": "South-Eastern Asia"
},
{
"countryID": "39",
"countryName": "Cameroon",
"CountryCode": "CM",
"numericCode": "120",
"nativeName": "Cameroon",
"Region": "Africa",
"SubRegion": "Middle Africa"
},
{
"countryID": "40",
"countryName": "Canada",
"CountryCode": "CA",
"numericCode": "124",
"nativeName": "Canada",
"Region": "Americas",
"SubRegion": "Northern America"
},
{
"countryID": "41",
"countryName": "Cape Verde",
"CountryCode": "CV",
"numericCode": "132",
"nativeName": "Cabo Verde",
"Region": "Africa"},{"_note":"Response truncated for documentation purposes"}]
curl --location --request GET 'https://zylalabs.com/api/10777/%e5%9c%b0%e7%90%86%e6%95%b0%e6%8d%ae%e6%9f%a5%e6%89%be+api/20413/%e5%9b%bd%e5%ae%b6%e5%88%97%e8%a1%a8' --header 'Authorization: Bearer YOUR_API_KEY'
国家首都 - 端点功能
| 对象 | 描述 |
|---|---|
country |
[必需] |
[
{
"countryName": "United States",
"CountryCode": "US",
"Capital": "Washington"
}
]
curl --location --request GET 'https://zylalabs.com/api/10777/%e5%9c%b0%e7%90%86%e6%95%b0%e6%8d%ae%e6%9f%a5%e6%89%be+api/20414/%e5%9b%bd%e5%ae%b6%e9%a6%96%e9%83%bd?country=us' --header 'Authorization: Bearer YOUR_API_KEY'
国家电话代码 - 端点功能
| 对象 | 描述 |
|---|---|
country |
[必需] |
[
{
"CountryName": "United States",
"CountryCode": "US",
"PhoneCode": "+1"
}
]
curl --location --request GET 'https://zylalabs.com/api/10777/%e5%9c%b0%e7%90%86%e6%95%b0%e6%8d%ae%e6%9f%a5%e6%89%be+api/20415/%e5%9b%bd%e5%ae%b6%e7%94%b5%e8%af%9d%e4%bb%a3%e7%a0%81?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/10777/%e5%9c%b0%e7%90%86%e6%95%b0%e6%8d%ae%e6%9f%a5%e6%89%be+api/20416/%e6%8c%89%e5%9b%bd%e5%ae%b6%e7%9a%84%e8%b4%a7%e5%b8%81?country=us' --header 'Authorization: Bearer YOUR_API_KEY'
按国家获取 emoji 旗帜
国家的表情符号旗帜 - 端点功能
| 对象 | 描述 |
|---|---|
country |
[必需] |
[
{
"CountryName": "United States",
"CountryCode": "US",
"emojiU": "U+1F1FA U+1F1F8"
}
]
curl --location --request GET 'https://zylalabs.com/api/10777/%e5%9c%b0%e7%90%86%e6%95%b0%e6%8d%ae%e6%9f%a5%e6%89%be+api/20417/%e5%9b%bd%e5%ae%b6%e7%9a%84%e8%a1%a8%e6%83%85%e7%ac%a6%e5%8f%b7%e6%97%97%e5%b8%9c?country=us' --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"
},
{
"StateName": "American Samoa",
"StateCode": "AS",
"CountryCode": "US",
"latitude": "-14.270972",
"longitude": "-170.132217"
},
{
"StateName": "Arizona",
"StateCode": "AZ",
"CountryCode": "US",
"latitude": "34.0489281",
"longitude": "-111.0937311"
},
{
"StateName": "Arkansas",
"StateCode": "AR",
"CountryCode": "US",
"latitude": "35.20105",
"longitude": "-91.8318334"
},
{
"StateName": "Baker Island",
"StateCode": "UM-81",
"CountryCode": "US",
"latitude": "0.1936266",
"longitude": "-176.476908"
},
{
"StateName": "California",
"StateCode": "CA",
"CountryCode": "US",
"latitude": "36.778261",
"longitude": "-119.4179324"
},
{
"StateName": "Colorado",
"StateCode": "CO",
"CountryCode": "US",
"latitude": "39.5500507",
"longitude": "-105.7820674"
},
{
"StateName": "Connecticut",
"StateCode": "CT",
"CountryCode": "US",
"latitude": "41.6032207",
"longitude": "-73.087749"
},
{
"StateName": "Delaware",
"StateCode": "DE",
"CountryCode": "US",
"latitude": "38.9108325",
"longitude": "-75.5276699"
},
{
"StateName": "District of Columbia",
"StateCode": "DC",
"CountryCode": "US",
"latitude": "38.9071923",
"longitude": "-77.0368707"
},
{
"StateName": "Florida",
"StateCode": "FL",
"CountryCode": "US",
"latitude": "27.6648274",
"longitude": "-81.5157535"
},
{
"StateName": "Georgia",
"StateCode": "GA",
"CountryCode": "US",
"latitude": "32.1656221",
"longitude": "-82.9000751"
},
{
"StateName": "Guam",
"StateCode": "GU",
"CountryCode": "US",
"latitude": "13.444304",
"longitude": "144.793731"
},
{
"StateName": "Hawaii",
"StateCode": "HI",
"CountryCode": "US",
"latitude": "19.8967662",
"longitude": "-155.5827818"
},
{
"StateName": "Howland Island",
"StateCode": "UM-84",
"CountryCode": "US",
"latitude": "0.8113219",
"longitude": "-176.6182736"
},
{
"StateName": "Idaho",
"StateCode": "ID",
"CountryCode": "US",
"latitude": "44.0682019",
"longitude": "-114.7420408"
},
{
"StateName": "Illinois",
"StateCode": "IL",
"CountryCode": "US",
"latitude": "40.6331249",
"longitude": "-89.3985283"
},
{
"StateName": "Indiana",
"StateCode": "IN",
"CountryCode": "US",
"latitude": "40.2671941",
"longitude": "-86.1349019"
},
{
"StateName": "Iowa",
"StateCode": "IA",
"CountryCode": "US",
"latitude": "41.8780025",
"longitude": "-93.097702"
},
{
"StateName": "Jarvis Island",
"StateCode": "UM-86",
"CountryCode": "US",
"latitude": "-0.3743503",
"longitude": "-159.9967206"
},
{
"StateName": "Johnston Atoll",
"StateCode": "UM-67",
"CountryCode": "US",
"latitude": "16.7295035",
"longitude": "-169.5336477"
},
{
"StateName": "Kansas",
"StateCode": "KS",
"CountryCode": "US",
"latitude": "39.011902",
"longitude": "-98.4842465"
},
{
"StateName": "Kentucky",
"StateCode": "KY",
"CountryCode": "US",
"latitude": "37.8393332",
"longitude": "-84.2700179"
},
{
"StateName": "Kingman Reef",
"StateCode": "UM-89",
"CountryCode": "US",
"latitude": "6.383333",
"longitude": "-162.416667"
},
{
"StateName": "Louisiana",
"StateCode": "LA",
"CountryCode": "US",
"latitude": "30.9842977",
"longitude": "-91.9623327"
},
{
"StateName": "Maine",
"StateCode": "ME",
"CountryCode": "US",
"latitude": "45.253783",
"longitude": "-69.4454689"
},
{
"StateName": "Maryland",
"StateCode": "MD",
"CountryCode": "US",
"latitude": "39.0457549",
"longitude": "-76.6412712"
},
{
"StateName": "Massachusetts",
"StateCode": "MA",
"CountryCode": "US",
"latitude": "42.4072107",
"longitude": "-71.3824374"
},
{
"StateName": "Michigan",
"StateCode": "MI",
"CountryCode": "US",
"latitude": "44.3148443",
"longitude": "-85.6023643"
},
{
"StateName": "Midway Atoll",
"StateCode": "UM-71",
"CountryCode": "US",
"latitude": "28.2072168",
"longitude": "-177.3734926"
},
{
"StateName": "Minnesota",
"StateCode": "MN",
"CountryCode": "US",
"latitude": "46.729553",
"longitude": "-94.6858998"
},
{
"StateName": "Mississippi",
"StateCode": "MS",
"CountryCode": "US",
"latitude": "32.3546679",
"longitude": "-89.3985283"
},
{
"StateName": "Missouri",
"StateCode": "MO",
"CountryCode": "US",
"latitude": "37.9642529",
"longitude": "-91.8318334"
},
{
"StateName": "Montana",
"StateCode": "MT",
"CountryCode": "US",
"latitude": "46.8796822",
"longitude": "-110.3625658"
},
{
"StateName": "Navassa Island",
"StateCode": "UM-76",
"CountryCode": "US",
"latitude": "18.4100689",
"longitude": "-75.0114612"
},
{
"StateName": "Nebraska",
"StateCode": "NE",
"CountryCode": "US",
"latitude": "41.4925374",
"longitude": "-99.9018131"
},
{
"StateName": "Nevada",
"StateCode": "NV",
"CountryCode": "US",
"latitude": "38.8026097",
"longitude": "-116.419389"
},
{
"StateName": "New Hampshire",
"StateCode": "NH",
"CountryCode": "US",
"latitude": "43.1938516",
"longitude": "-71.5723953"
},
{
"StateName": "New Jersey",
"StateCode": "NJ",
"CountryCode": "US",
"latitude": "40.0583238",
"longitude": "-74.4056612"
},
{
"StateName": "New Mexico",
"StateCode": "NM",
"CountryCode": "US",
"latitude": "34.5199402",
"longitude": "-105.8700901"
},
{
"StateName": "New York",
"StateCode": "NY",
"CountryCode": "US",
"latitude": "40.7127753",
"longitude": "-74.0059728"
},
{
"StateName": "North Carolina",
"StateCode": "NC",
"CountryCode": "US",
"latitude": "35.7595731",
"longitude": "-79.0192997"
},
{
"StateName": "North Dakota",
"StateCode": "ND",
"CountryCode": "US",
"latitude": "47.5514926",
"longitude": "-101.0020119"
},
{
"StateName": "Northern Mariana Islands",
"StateCode": "MP",
"CountryCode": "US",
"latitude": "15.0979",
"longitude": "145.6739"
},
{
"StateName": "Ohio",
"StateCode": "OH",
"CountryCode": "US",
"latitude": "40.4172871",
"longitude": "-82.907123"
},
{
"StateName": "Oklahoma",
"StateCode": "OK",
"CountryCode": "US",
"latitude": "35.4675602",
"longitude": "-97.5164276"
},
{
"StateName": "Oregon",
"StateCode": "OR",
"CountryCode": "US",
"latitude": "43.8041334",
"longitude": "-120.5542012"
},
{
"StateName": "Palmyra Atoll",
"StateCode": "UM-95",
"CountryCode": "US",
"latitude": "5.8885026",
"longitude": "-162.0786656"
},
{
"StateName": "Pennsylvania",
"StateCode": "PA",
"CountryCode": "US",
"latitude": "41.2033216",
"longitude": "-77.1945247"
},
{
"StateName": "Puerto Rico",
"StateCode": "PR",
"CountryCode": "US",
"latitude": "18.220833",
"longitude": "-66.590149"
},
{
"StateName": "Rhode Island",
"StateCode": "RI",
"CountryCode": "US",
"latitude": "41.5800945",
"longitude": "-71.4774291"
},
{
"StateName": "South Carolina",
"StateCode": "SC",
"CountryCode": "US",
"latitude": "33.836081",
"longitude": "-81.1637245"
},
{
"StateName": "South Dakota",
"StateCode": "SD",
"CountryCode": "US",
"latitude": "43.9695148",
"longitude": "-99.9018131"
},
{
"StateName": "Tennessee",
"StateCode": "TN",
"CountryCode": "US",
"latitude": "35.5174913",
"longitude": "-86.5804473"
},
{
"StateName": "Texas",
"StateCode": "TX",
"CountryCode": "US",
"latitude": "31.9685988",
"longitude": "-99.9018131"
},
{
"StateName": "United States Minor Outlying Islands",
"StateCode": "UM",
"CountryCode": "US",
"latitude": "19.2823192",
"longitude": "166.647047"
},
{
"StateName": "United States Virgin Islands",
"StateCode": "VI",
"CountryCode": "US"},{"_note":"Response truncated for documentation purposes"}]
curl --location --request GET 'https://zylalabs.com/api/10777/%e5%9c%b0%e7%90%86%e6%95%b0%e6%8d%ae%e6%9f%a5%e6%89%be+api/20418/%e6%8c%89%e5%9b%bd%e5%ae%b6%e5%88%92%e5%88%86%e7%9a%84%e5%b7%9e?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"
},
{
"CityName": "Alabaster",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.24428000",
"longitude": "-86.81638000"
},
{
"CityName": "Albertville",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "34.26783000",
"longitude": "-86.20878000"
},
{
"CityName": "Alexander City",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "32.94401000",
"longitude": "-85.95385000"
},
{
"CityName": "Alexandria",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.77399000",
"longitude": "-85.88552000"
},
{
"CityName": "Aliceville",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.12957000",
"longitude": "-88.15142000"
},
{
"CityName": "Andalusia",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "31.30808000",
"longitude": "-86.48243000"
},
{
"CityName": "Anniston",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.65983000",
"longitude": "-85.83163000"
},
{
"CityName": "Arab",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "34.31815000",
"longitude": "-86.49582000"
},
{
"CityName": "Argo",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.68778000",
"longitude": "-86.50051000"
},
{
"CityName": "Ashford",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "31.18296000",
"longitude": "-85.23632000"
},
{
"CityName": "Ashland",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.27373000",
"longitude": "-85.83607000"
},
{
"CityName": "Ashville",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.83704000",
"longitude": "-86.25442000"
},
{
"CityName": "Athens",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "34.80243000",
"longitude": "-86.97219000"
},
{
"CityName": "Atmore",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "31.02379000",
"longitude": "-87.49387000"
},
{
"CityName": "Attalla",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "34.02176000",
"longitude": "-86.08859000"
},
{
"CityName": "Auburn",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "32.60986000",
"longitude": "-85.48078000"
},
{
"CityName": "Autauga County",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "32.53492000",
"longitude": "-86.64276000"
},
{
"CityName": "Baldwin County",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "30.66097000",
"longitude": "-87.74984000"
},
{
"CityName": "Ballplay",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "34.05871000",
"longitude": "-85.80802000"
},
{
"CityName": "Barbour County",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "31.86960000",
"longitude": "-85.39320000"
},
{
"CityName": "Bay Minette",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "30.88296000",
"longitude": "-87.77305000"
},
{
"CityName": "Bayou La Batre",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "30.40352000",
"longitude": "-88.24852000"
},
{
"CityName": "Bear Creek",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "34.27482000",
"longitude": "-87.70058000"
},
{
"CityName": "Berry",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.65983000",
"longitude": "-87.60001000"
},
{
"CityName": "Bessemer",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.40178000",
"longitude": "-86.95444000"
},
{
"CityName": "Bibb County",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "32.99864000",
"longitude": "-87.12644000"
},
{
"CityName": "Birmingham",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.52066000",
"longitude": "-86.80249000"
},
{
"CityName": "Blount County",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.98087000",
"longitude": "-86.56737000"
},
{
"CityName": "Blountsville",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "34.08149000",
"longitude": "-86.59110000"
},
{
"CityName": "Blue Ridge",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "32.49264000",
"longitude": "-86.19052000"
},
{
"CityName": "Boaz",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "34.20065000",
"longitude": "-86.16637000"
},
{
"CityName": "Brent",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "32.93735000",
"longitude": "-87.16472000"
},
{
"CityName": "Brewton",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "31.10518000",
"longitude": "-87.07219000"
},
{
"CityName": "Bridgeport",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "34.94758000",
"longitude": "-85.71442000"
},
{
"CityName": "Brighton",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.43428000",
"longitude": "-86.94721000"
},
{
"CityName": "Brook Highland",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.43566000",
"longitude": "-86.67388000"
},
{
"CityName": "Brookside",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.63788000",
"longitude": "-86.91666000"
},
{
"CityName": "Brookwood",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.25567000",
"longitude": "-87.32083000"
},
{
"CityName": "Brundidge",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "31.72016000",
"longitude": "-85.81606000"
},
{
"CityName": "Bullock County",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "32.10055000",
"longitude": "-85.71570000"
},
{
"CityName": "Butler",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "32.08959000",
"longitude": "-88.22197000"
},
{
"CityName": "Butler County",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "31.75243000",
"longitude": "-86.68029000"
},
{
"CityName": "Bynum",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.61316000",
"longitude": "-85.96108000"
},
{
"CityName": "Cahaba Heights",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.46400000",
"longitude": "-86.73193000"
},
{
"CityName": "Calera",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.10290000",
"longitude": "-86.75360000"
},
{
"CityName": "Calhoun County",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.77143000",
"longitude": "-85.82603000"
},
{
"CityName": "Camden",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "31.99098000",
"longitude": "-87.29055000"
},
{
"CityName": "Carbon Hill",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.89177000",
"longitude": "-87.52612000"
},
{
"CityName": "Carlisle-Rockledge",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "34.11445000",
"longitude": "-86.12407000"
},
{
"CityName": "Carrollton",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.26169000",
"longitude": "-88.09503000"
},
{
"CityName": "Cedar Bluff",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "34.22009000",
"longitude": "-85.60774000"
},
{
"CityName": "Center Point",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.64566000",
"longitude": "-86.68360000"
},
{
"CityName": "Centre",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "34.15204000",
"longitude": "-85.67885000"
},
{
"CityName": "Centreville",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "32.94620000",
"longitude": "-87.11669000"
},
{
"CityName": "Chalkville",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "33.65316000",
"longitude": "-86.64777000"
},
{
"CityName": "Chambers County",
"StateCode": "AL",
"CountryCode": "US"},{"_note":"Response truncated for documentation purposes"}]
curl --location --request GET 'https://zylalabs.com/api/10777/%e5%9c%b0%e7%90%86%e6%95%b0%e6%8d%ae%e6%9f%a5%e6%89%be+api/20419/%e5%90%84%e5%b7%9e%e5%9f%8e%e5%b8%82?state=alabama' --header 'Authorization: Bearer YOUR_API_KEY'
按城市定位 - 端点功能
| 对象 | 描述 |
|---|---|
city |
[必需] |
[
{
"CityName": "Abbeville",
"StateCode": "HDF",
"CountryCode": "FR",
"latitude": "50.10521000",
"longitude": "1.83547000"
},
{
"CityName": "Abbeville",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "31.57184000",
"longitude": "-85.25049000"
},
{
"CityName": "Abbeville",
"StateCode": "GA",
"CountryCode": "US",
"latitude": "31.99212000",
"longitude": "-83.30682000"
},
{
"CityName": "Abbeville",
"StateCode": "LA",
"CountryCode": "US",
"latitude": "29.97465000",
"longitude": "-92.13429000"
},
{
"CityName": "Abbeville",
"StateCode": "SC",
"CountryCode": "US",
"latitude": "34.17817000",
"longitude": "-82.37901000"
},
{
"CityName": "Abbeville County",
"StateCode": "SC",
"CountryCode": "US",
"latitude": "34.22257000",
"longitude": "-82.45871000"
}
]
curl --location --request GET 'https://zylalabs.com/api/10777/%e5%9c%b0%e7%90%86%e6%95%b0%e6%8d%ae%e6%9f%a5%e6%89%be+api/20420/%e6%8c%89%e5%9f%8e%e5%b8%82%e5%ae%9a%e4%bd%8d?city=Abbeville' --header 'Authorization: Bearer YOUR_API_KEY'
通过城市获取邮政编码
城市邮政编码 - 端点功能
| 对象 | 描述 |
|---|---|
city |
[必需] |
[
{
"CityName": "Abbeville",
"StateCode": "HDF",
"CountryCode": "FR",
"latitude": "50.10521000",
"longitude": "1.83547000",
"zip": null
},
{
"CityName": "Abbeville",
"StateCode": "AL",
"CountryCode": "US",
"latitude": "31.57184000",
"longitude": "-85.25049000",
"zip": [
"38601",
"31001",
"36310",
"70510",
"70511",
"29620",
"24382",
"29638",
"29659",
"29628",
"29639"
]
},
{
"CityName": "Abbeville",
"StateCode": "GA",
"CountryCode": "US",
"latitude": "31.99212000",
"longitude": "-83.30682000",
"zip": null
},
{
"CityName": "Abbeville",
"StateCode": "LA",
"CountryCode": "US",
"latitude": "29.97465000",
"longitude": "-92.13429000",
"zip": null
},
{
"CityName": "Abbeville",
"StateCode": "SC",
"CountryCode": "US",
"latitude": "34.17817000",
"longitude": "-82.37901000",
"zip": null
},
{
"CityName": "Abbeville County",
"StateCode": "SC",
"CountryCode": "US",
"latitude": "34.22257000",
"longitude": "-82.45871000",
"zip": null
}
]
curl --location --request GET 'https://zylalabs.com/api/10777/%e5%9c%b0%e7%90%86%e6%95%b0%e6%8d%ae%e6%9f%a5%e6%89%be+api/20421/%e5%9f%8e%e5%b8%82%e9%82%ae%e6%94%bf%e7%bc%96%e7%a0%81?city=Abbeville' --header 'Authorization: Bearer YOUR_API_KEY'
| 标头 | 描述 |
|---|---|
授权
|
[必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。 |
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
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 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
服务级别:
100%
响应时间:
118ms
服务级别:
100%
响应时间:
467ms
服务级别:
100%
响应时间:
235ms
服务级别:
100%
响应时间:
345ms
服务级别:
100%
响应时间:
2,088ms
服务级别:
50%
响应时间:
2,089ms
服务级别:
100%
响应时间:
1,551ms
服务级别:
90%
响应时间:
981ms
服务级别:
100%
响应时间:
3,408ms
服务级别:
83%
响应时间:
564ms
服务级别:
100%
响应时间:
857ms
服务级别:
100%
响应时间:
1,409ms
服务级别:
100%
响应时间:
339ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
1,779ms
服务级别:
89%
响应时间:
1,438ms
服务级别:
100%
响应时间:
180ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
841ms
服务级别:
100%
响应时间:
3,147ms