---
name: "getWeatherQuality"
mode: "api"
versionRequirements:
  - { name: "@ray-js/ray", version: "1.5.2" }
title: "getWeatherQuality - 通过设备 ID 获取当天天气。"
---

## getWeatherQuality

> [VERSION] @ray-js/ray >= 1.5.2

### 描述

通过设备 ID 获取当天天气及空气质量

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `params` | `IGetWeatherQuality` | 是 | 请求参数 |

### 返回值

类型: `Promise<IGetWeatherQualityResponse>`

天气及空气质量信息，包含城市信息、温度、湿度、风向、风速、空气质量指数等

##### IGetWeatherQualityResponse

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `c` | `Object[]` | 城市列表 |
| `w` | `Object[]` | 天气及空气质量信息 |

##### IGetWeatherQualityResponse.c[] 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `name` | `string` | 是 | - | 城市名称 |
| `id` | `number` | 是 | - | 城市 ID |


##### IGetWeatherQualityResponse.w[] 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `windDir` | `string` | 是 | - | 风向 |
| `tips` | `string` | 是 | - | 概述 |
| `realFeel` | `number` | 是 | - | 体感温度 |
| `no2` | `number` | 是 | - | 二氧化氮 |
| `so2` | `number` | 是 | - | 二氧化硫 |
| `zoneId` | `string` | 是 | - | 时区 |
| `humidity` | `number` | 是 | - | 空气湿度 |
| `windSpeed` | `string` | 是 | - | 风速，国内外都是 m/s |
| `temp` | `number` | 是 | - | 温度 ，国内外都是单位摄氏度 |
| `o3` | `number` | 是 | - | 臭氧 |
| `pm10` | `number` | 是 | - | PM10 |
| `pressure` | `number` | 是 | - | 大气气压 |
| `co` | `number` | 是 | - | 一氧化碳 |
| `qualityLevel` | `number` | 是 | - | 空气质量评分等级 |
| `quality` | `string` | 是 | - | 空气质量评分 |
| `condition` | `string` | 是 | - | 天气文本描述 |
| `pm25` | `number` | 是 | - | PM25 |
| `condIconUrl` | `string` | 是 | - | 天气图标地址 |
| `aqi` | `number` | 是 | - | 空气质量 |
| `conditionNum` | `string` | 是 | - | 天气文本编号 |
| `sunRise` | `string` | 是 | - | 日出时间文本 |
| `sunSet` | `string` | 是 | - | 日落时间文本 |
| `sunSetTimestamp` | `number` | 是 | - | 日落时间戳 |
| `sunRiseTimestamp` | `number` | 是 | - | 日出时间戳 |


### 引用对象

##### `interface` IGetWeatherQuality

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `devId` | `string` | 设备 ID |
| `isLocal` | `boolean` | 是否查询本地天气 |


### 示例代码

#### 基础用法

```ts
import { getWeatherQuality } from '@ray-js/ray';

getWeatherQuality({
  devId: 'vdevo169477319679442',
  isLocal: true,
}).then((res) => {
  console.log('天气信息:', res);
}).catch((error) => {
  console.error(error);
});
```