> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sunnymeteo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 360 小时预报

> 查询中国城市未来 360 小时逐小时预报

## 接口概述

返回当前整点及未来 360 小时（约 15 天）的逐小时气象要素，字段与 24 小时接口一致。

| 项目 | 说明 |
| - | - |
| 覆盖范围 | 中国大陆主要城市 |
| 更新频率 | 约每小时更新 |
| 时区 | 业务时间多为北京时间；场站预报库内为 UTC，响应同时提供本地时间 |
| 鉴权 | 请求头 `X-API-Key`；需开通对应模块权限 |

### 相关参考

* [24 小时预报](https://docs.sunnymeteo.com/zh/products/hourly-forecast.md)
* [天气现象代码](https://docs.sunnymeteo.com/zh/reference/weather-codes.md)
* [城市列表](https://docs.sunnymeteo.com/zh/reference/location-codes.md)

## 请求

```
GET /v1/weather/360hourly
GET /weather/360hourly
```

### 查询参数

| 参数 | 类型 | 必填 | 说明 |
| - | - | - | - |
| `city_uid` | integer | 四选一 | 内部城市 ID，优先级最高 |
| `city_code` | string | 四选一 | GB2260 行政区划代码，如 `110000` |
| `city_name` | string | 四选一 | 城市名称，如 `北京市` |
| `lat` | number | 与 lon 成对 | 纬度 -90\~90 |
| `lon` | number | 与 lat 成对 | 经度 -180\~180 |
| `format` | string | 否 | 响应格式：`json`（默认）/`csv`/`tsv`/`xml`/`yaml` |

### 请求示例

```bash theme={null}
curl -s "https://api.sunnymeteo.com/v1/weather/360hourly?city_uid=1" \
  -H "X-API-Key: YOUR_KEY"
```

## 响应

结构与 [24 小时预报](https://docs.sunnymeteo.com/zh/products/hourly-forecast.md) 相同：`{ city, hourly: { update_time, hourly[] } }`。\
单点字段见下表（与 24 小时一致，条数更多）。

| 字段英文名 | 类型 | 单位 | 中文名 |
| - | - | - | - |
| `forecast_time` | string | ISO8601 | 预报时刻（整点） |
| `update_time` | string | ISO8601 | 数据源更新时间 |
| `weather_code` | integer | — | 天气现象代码（见参考文档） |
| `weather_cn` | string | — | 天气现象中文名 |
| `temp` | number | ℃ | 气温 |
| `dewpoint` | number | ℃ | 露点温度 |
| `real_feel` | number | ℃ | 体感温度 |
| `humidity` | number | % | 相对湿度 |
| `pressure` | number | hPa | 本站气压 |
| `mlsp` | number | hPa | 海平面气压 |
| `wind_dir` | string | — | 风向文字 |
| `wind_degrees` | number | ° | 风向角度（0–360） |
| `wind_speed` | number | m/s | 风速 |
| `wind_level` | number | 级 | 蒲福风力等级 |
| `gust_speed` | number | m/s | 阵风风速 |
| `gust_level` | number | 级 | 阵风等级 |
| `precip_1h` | number | mm | 1 小时降水量 |
| `snow_1h` | number | mm | 1 小时降雪量 |
| `cloud` | number | % | 总云量 |
| `vis` | number | m | 能见度 |
| `uvi` | number | — | 紫外线指数 |
| `solar` | number | W/m² | 太阳辐射 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.