最近公司项目有一个全国天气预报的小需求,想着如果用现成的API就可以大大提高开发效率,在网上的API商店搜索了一番,发现了 APISpace,它里面的全国天气预报API非常符合我的开发需求。
天气预报查询API,支持全国以及全球多个城市的天气查询,包含国内3400+个城市以及国际4万个城市的实况数据;更新频率分钟级别。
它接口使用起来也是超级方便,仅需要以下短短几步,就能够实现了:
APISpace 还有很多免费通用的API接口,利用这些接口可以帮你实现去开发出很多功能丰富,服务稳定的网页、APP还有小程序,无论是练手还是实战都是不错的选择。
接口使用注意
请求头中 **X-APISpace-Token **填写内容可以在测试页看到或者控制台的访问控制页面查看到,从这两个地方粘贴复制进去。
接下来和大家分享一下接口的一些信息。
智能天气实况
- 请求方法: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去调用智能天气实况接口,就可以查询到城市的天气预报信息。