最近公司项目有一个全国天气预报的小需求，想着如果用现成的API就可以大大提高开发效率，在网上的API商店搜索了一番，发现了 APISpace，它里面的全国天气预报API非常符合我的开发需求。

全国天气预报查询API，支持国内3400+个城市以及国际4万个城市的实况数据；更新频率分钟级别。

它接口使用起来也是超级方便，仅需要以下短短几步，就能够实现了：

1. 到 APISpace 注册账户
2. 申请 全国天气预报查询 API
3. 申请之后就可以使用该接口了

APISpace 还有很多免费通用的API接口，利用这些接口可以帮你实现去开发出很多功能丰富，服务稳定的网页、APP还有小程序，无论是练手还是实战都是不错的选择。

接口使用注意

请求头中 X-APISpace-Token 填写内容可以在测试tab页看到或者控制台的访问控制页面查看到，从这两个地方粘贴复制进去。

接下来和大家分享一下接口的一些信息。

智能天气实况

• 接口请求地址：点击查看
• 请求方法：GET
• 返回格式：JSON
• 请求参数
  • areacode：城市ID，必填（可以在下面的国内城市列表接口获取）。
• 返回示例：

{
    "status": 0,
    "result": {
        "location": {
            "areacode": "JPN10041001001",        //城市ID
            "name": "足立区",                    //城市中文名
            "country": "日本",                    //所属国家中文名
            "path": "足立区,足立区,东京都,日本"    //行政区划路径
        },
        "realtime": {
            "text": "多云",                //天气现象，string类型
            "code": "01",                        //天气现象编码，string类型
            "temp": 6.5,                        //气温，单位℃，double类型
            "feels_like": 6,                //体感温度，单位℃，int类型
            "rh": 38,                        //相对湿度，单位%，int类型
            "wind_class": "2级",                //蒲福氏风级，string类型
            "wind_speed": 2.5,        //风速，单位m/s，double类型
            "wind_dir": "南风",                //风向，string类型
            "wind_angle": 187,        //风向角度，0表示正北，180表示正南，int类型
            "prec": 0.0,                        //过去1小时降水量，单位毫米(mm)，double类型
            "clouds": 99,                //云量，单位%，int类型
            "vis": 12085,                //能见度，单位米(m)，int类型
            "pressure": 1020,                //气压，单位百帕(hPa)，int类型
            "dew": -6,                        //露点温度，单位℃，int类型
            "uv": 2,                        //紫外线指数，int类型
            "snow": 0.0,                //降雪量，单位厘米(cm)，double类型 #国内城市不支持#
            "weight": 0,                //文案权重，int类型
            "brief": "今日惊蛰",                //天气短文案，string类型
            "detail": "今日惊蛰，春雷惊百虫",                //天气长文案 ，string类型
        },
        "last_update": "2021-03-05 19:07:44"        //数据更新时间(北京时间)
    }
}

城市搜索（支持国内、国外城市）

• 接口请求地址：点击查询
• 请求方法：GET
• 请求参数
  • province：查询省份名字，例如：北京，不传默认返回全国的城市信息。非必填
  • location：检索内容，支持中文、英文以及拼音，必填。
  • items：返回结果数量，最大为20，必填。
  • area：搜索范围，china和global可选，必填。
  • language：返回城市信息语言，CHN和ENG可选，默认为CHN，非必填。
  • withTz：返回结果中是否包含时区信息，默认为false，非必填。
  • withPoi：返回结果中是否包含经纬度信息，默认为false，必填。
• 接口说明：该接口作为智能天气实况接口的辅助接口，通过该接口得到想查询城市的ID，然后拿到ID去调用智能天气实况接口，就可以查询到城市的天气预报信息。