如何用全国天气预报API接口进行快速开发

不是海碗哟1年前 ⋅ 1836 阅读

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

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

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

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

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

接口使用注意

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

image.png

image.png

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

智能天气实况

  • 请求方法: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去调用智能天气实况接口,就可以查询到城市的天气预报信息。

全部评论: 0

    相关推荐