APISpace 天气预报查询API接口案例代码

1.天气预报查询API产品介绍

APISpace 天气预报查询API接口案例代码_第1张图片

APISpace 的 天气预报查询,支持全国以及全球多个城市的天气查询,包含国内3400+个城市以及国际4万个城市的实况数据,同时也支持全球任意经纬度查询,接口会返回该经纬度最近的站点信息;更新频率分钟级别。

2.天气预报查询详解

2.1 API列表
  • 智能天气实况
  • 天气逐小时预报
  • 天气逐3小时预报
  • 15天预报
  • 城市搜索(国内、国外城市)

接下来以【智能天气实况】为例展示

2.2 接口请求
  • 请求方式:GET
  • 请求地址:https://eolink.o.apispace.com/456456/weather/v001/now
  • 请求头:
标签 必填 说明
X-APISpace-Token 鉴权私钥,登陆 APISpace 后在管理后台的[访问控制]页面查看
Authorization-Type 鉴权方式,值为:apikey
Content-Type application/json
  • Query参数:
参数名 类型 必填 说明
areacode [string] 城市ID,和经纬度二选一。(所有城市ID可在介绍页的相关附件中查看)
lonlat [string] 经纬度,用英文逗号隔开,经度在前纬度在后(格式为:经度,纬度),会返回该经纬度最近的站点信息
2.3 返回实例及参数说明
{
    “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类型
            “prec_time”: “2021-03-05 18:00:00”, //过去1小时降水量所对应的时间段
            “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”        //数据更新时间(北京时间)
    }
}
2.4 接入示例
OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
Request request = new Request.Builder()
  .url("https://eolink.o.apispace.com/456456/weather/v001/now?areacode=101010100&lonlat=116.407526,39.904030")
  .method("GET",null)
  .addHeader("X-APISpace-Token","登录APISpace即可获得")
  .addHeader("Authorization-Type","apikey")
  .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());
2.5 接口相关附件
  • 点击查看国内城市_3405站
  • 点击查看国际城市_39474站
  • 天气状态编码表
  • 下载气象图标

你可能感兴趣的:(天气预报api,api接口)