# 国内+全球 天气预报 （支持多语言）
支持国内和全球的天气预报接口
# 接口参数
请求地址：/api/weather/{Type}
请求方式：get post
Type 参数说明：
Type 值 | 描述 |
|---|---|
now | 实况天气 |
forecast | 7 天 预报 |
hourly | 逐小时预报 |
life | 生活指数 |
find | 城市搜索 |
请求参数：
| 参数名称 | 必选 | 类型 | 说明 |
|---|---|---|---|
location | 是 | string | 要查询的城市或者地区 |
lang | 否 | string | 返回的语言,默认 zh |
location 支持：
- 城市ID：城市列表
- 经纬度格式：经度,纬度（经度在前纬度在后，英文,分隔，十进制格式，北纬东经为正，南纬西经为负
- 城市名称，支持中英文和汉语拼音
- 城市名称，上级城市 或 省 或 国家，英文,分隔，此方式可以在重名的情况下只获取想要的地区的天气数据，例如 西安,陕西
IP
lang 支持：
| 语言代码 | 语言名称 |
|---|---|
zh | 简体中文 |
zh-hant | 繁体中文 |
en | 英文 |
de | 德语 |
es | 西班牙语 |
fr | 法语 |
ja | 日语 |
ko | 韩语 |
sv | 瑞典语 |
# 返回数据
实况天气
测试参数：/api/weather/now?location=北京
{
"code": 200,
"msg": "success",
"data": {
"basic": {
"cid": "CN101010100",
"location": "北京",
"parent_city": "北京",
"admin_area": "北京",
"cnty": "中国",
"lat": "39.90498734",
"lon": "116.4052887",
"tz": "+8.00"
},
"update": {
"loc": "2019-10-07 08:36",
"utc": "2019-10-07 00:36"
},
"status": "ok",
"now": {
"cloud": "10",
"cond_code": "100",
"cond_txt": "晴",
"fl": "9",
"hum": "94",
"pcpn": "0.0",
"pres": "1017",
"tmp": "10",
"vis": "15",
"wind_deg": "267",
"wind_dir": "西风",
"wind_sc": "2",
"wind_spd": "6"
}
},
"Author": {
"name": "Alone88",
"desc": "由Alone88提供的免费API 服务，官方文档：www.alapi.cn"
}
}
城市搜索
测试参数：/api/weather/find?location=北京
{
"code": 200,
"msg": "success",
"data": {
"basic": [
{
"cid": "CN101010100",
"location": "北京",
"parent_city": "北京",
"admin_area": "北京",
"cnty": "中国",
"lat": "39.90498734",
"lon": "116.4052887",
"tz": "+8.00",
"type": "city"
},
{
"cid": "CN10101010007A",
"location": "北京孔庙",
"parent_city": "北京",
"admin_area": "北京",
"cnty": "中国",
"lat": "39.93999863",
"lon": "116.41000366",
"tz": "+8.00",
"type": "scenic"
},
{
"cid": "CN10101020006A",
"location": "北京动物园",
"parent_city": "北京",
"admin_area": "北京",
"cnty": "中国",
"lat": "39.93000031",
"lon": "116.33000183",
"tz": "+8.00",
"type": "scenic"
},
{
"cid": "CN10101010011A",
"location": "北京海洋馆",
"parent_city": "北京",
"admin_area": "北京",
"cnty": "中国",
"lat": "39.93999863",
"lon": "116.33999634",
"tz": "+8.00",
"type": "scenic"
},
{
"cid": "CN10101010006A",
"location": "北京国子监",
"parent_city": "北京",
"admin_area": "北京",
"cnty": "中国",
"lat": "39.93999863",
"lon": "116.41000366",
"tz": "+8.00",
"type": "scenic"
},
{
"cid": "CN10101020007A",
"location": "北京植物园",
"parent_city": "北京",
"admin_area": "北京",
"cnty": "中国",
"lat": "40.0",
"lon": "116.19999695",
"tz": "+8.00",
"type": "scenic"
},
{
"cid": "CN10101030004A",
"location": "北京欢乐谷",
"parent_city": "北京",
"admin_area": "北京",
"cnty": "中国",
"lat": "39.86000061",
"lon": "116.48999786",
"tz": "+8.00",
"type": "scenic"
},
{
"cid": "CN10101110003A",
"location": "北京野生动物园",
"parent_city": "北京",
"admin_area": "北京",
"cnty": "中国",
"lat": "39.49000168",
"lon": "116.33000183",
"tz": "+8.00",
"type": "scenic"
},
{
"cid": "CN10101020003A",
"location": "北京天文馆",
"parent_city": "北京",
"admin_area": "北京",
"cnty": "中国",
"lat": "39.93000031",
"lon": "116.33000183",
"tz": "+8.00",
"type": "scenic"
},
{
"cid": "CN10101010002A",
"location": "北京市规划展览馆",
"parent_city": "北京",
"admin_area": "北京",
"cnty": "中国",
"lat": "39.88999939",
"lon": "116.40000153",
"tz": "+8.00",
"type": "scenic"
}
],
"status": "ok"
},
"Author": {
"name": "Alone88",
"desc": "由Alone88提供的免费API 服务，官方文档：www.alapi.cn"
}
}
# 返回参数和数值说明
常规天气数据接口将返回一些基本字段和不同天气类型的字段。
返回的数据中，basic，update和status是基本参数，在不同数据类型中都会返回。
具体的天气数据，会根据你请求的{type}不同，将返回不同的天气数据。
# basic 基础信息
基础信息包括所查询的城市/地区的一些基本信息，例如名称、ID、经纬度等
| 参数 | 描述 | 示例值 |
|---|---|---|
| location | 地区／城市名称 | 卓资 |
| cid | 地区／城市ID | CN101080402 |
| lat | 地区／城市纬度 | 40.89576 |
| lon | 地区／城市经度 | 112.577702 |
| parent_city | 该地区／城市的上级城市 | 乌兰察布 |
| admin_area | 该地区／城市所属行政区域 | 内蒙古 |
| cnty | 该地区／城市所属国家名称 | 中国 |
| tz | 该地区／城市所在时区 | +8.0 |
# update 接口更新时间
接口更新时间为当前接口的更新时间，包括城市/地区所在地的当地时间和UTC时间，即使其中有个别数据没有变化，update时间也会变更。
| 参数 | 描述 | 示例值 |
|---|---|---|
| loc | 当地时间，24小时制，格式yyyy-MM-dd HH:mm | 2017-10-25 12:34 |
| utc | UTC时间，24小时制，格式yyyy-MM-dd HH:mm | 2017-10-25 04:34 |
# now实况天气
实况天气即为当前时间点的天气状况以及温湿风压等气象指数，具体包含的数据：体感温度、实测温度、天气状况、风力、风速、风向、相对湿度、大气压强、降水量、能见度等。
| 参数 | 描述 | 示例 |
|---|---|---|
| fl | 体感温度，默认单位：摄氏度 | 23 |
| tmp | 温度，默认单位：摄氏度 | 21 |
| cond_code | 实况天气状况代码 | 100 |
| cond_txt | 实况天气状况描述 | 晴 |
| wind_deg | 风向360角度 | 305 |
| wind_dir | 风向 | 西北 |
| wind_sc | 风力 | 3-4 |
| wind_spd | 风速，公里/小时 | 15 |
| hum | 相对湿度 | 40 |
| pcpn | 降水量 | 0 |
| pres | 大气压强 | 1020 |
| vis | 能见度，默认单位：公里 | 10 |
| cloud | 云量 | 23 |
# daily_forecast 天气预报
3-10天天气预报数据，天气预报包含的数据：日出日落、月升月落、最高最低温度、天气白天和夜间状况、风力、风速、风向、相对湿度、大气压强、降水量、降水概率、露点温度、紫外线强度、能见度等数据
| 参数 | 描述 | 示例值 |
|---|---|---|
| date | 预报日期 | 2013-12-30 |
| sr | 日出时间 | 07:36 |
| ss | 日落时间 | 16:58 |
| mr | 月升时间 | 04:47 |
| ms | 月落时间 | 14:59 |
| tmp_max | 最高温度 | 4 |
| tmp_min | 最低温度 | -5 |
| cond_code_d | 白天天气状况代码 | 100 |
| cond_code_n | 夜间天气状况代码 | 100 |
| cond_txt_d | 白天天气状况描述 | 晴 |
| cond_txt_n | 晚间天气状况描述 | 晴 |
| wind_deg | 风向360角度 | 310 |
| wind_dir | 风向 | 西北风 |
| wind_sc | 风力 | 1-2 |
| wind_spd | 风速，公里/小时 | 14 |
| hum | 相对湿度 | 37 |
| pcpn | 降水量 | 0 |
| pop | 降水概率 | 0 |
| pres | 大气压强 | 1018 |
| uv_index | 紫外线强度指数 | 3 |
| vis | 能见度，单位：公里 | 10 |
# hourly 逐小时预报
未来24-168个小时，逐小时的天气预报数据数据，具体包含的数据：温度、天气状况、风力、风速、风向、相对湿度、大气压强、降水概率等。
| 参数 | 描述 | 示例 |
|---|---|---|
| time | 预报时间，格式yyyy-MM-dd hh:mm | 2013-12-30 13:00 |
| tmp | 温度 | 2 |
| cond_code | 天气状况代码 | 101 |
| cond_txt | 天气状况描述 | 多云 |
| wind_deg | 风向360角度 | 290 |
| wind_dir | 风向 | 西北 |
| wind_sc | 风力 | 3-4 |
| wind_spd | 风速，公里/小时 | 15 |
| hum | 相对湿度 | 30 |
| pres | 大气压强 | 1030 |
| pop | 降水概率，百分比 | 30 |
| dew | 露点温度 | 12 |
| cloud | 云量 | 23 |
# lifestyle 生活指数
生活指数和生活指数预报包括：穿衣、洗车、感冒、紫外线、运动、舒适度、旅游、空气污染扩散条件。
目前生活指数仅支持中国地区
| 参数 | 描述 |
|---|---|
| brf | 生活指数简介 |
| txt | 生活指数详细描述 |
| type | 生活指数类型 comf：舒适度指数、cw：洗车指数、drsg：穿衣指数、flu：感冒指数、sport：运动指数、trav：旅游指数、uv：紫外线指数、air：空气污染扩散条件指数、ac：空调开启指数、ag：过敏指数、gl：太阳镜指数、mu：化妆指数、airc：晾晒指数、ptfc：交通指数、fsh：钓鱼指数、spi：防晒指数 |