智能小程序 Ray 开发设备信息 API —— 天气 API 汇总

getWeathers

说明：设备天气根据 设备配网经纬度 和 IP 地址 获取。如果本接口仅返回 true，但无天气详情数据，那么该设备的 设备配网经纬度 和 IP 地址 可能设置错误，请查看设备日志。

天气预报接口。

请求参数

参数	数据类型	描述	是否必填
devId	String	设备 ID	是
dataRange	Integer	预报天数（默认值为 7，最大可预报天数为 7）	否

返回结果

参数	数据类型	说明
c	c[]	见 c
weathers	weathers[]	见 weathers

• c

参数	数据类型	说明
name	String	城市名称
id	Number	城市 ID

• weathers

参数	数据类型	说明
temp	Number	风向
thigh	Number	日落文本
pressure	Number	概述
condition	String	体感温度
tlow	Number	二氧化氮
condIconUrl	String	日落时间戳
humidity	Number	空气湿度
conditionNum	String	天气文本编号
windSpeed	String	风速，国内外都是 m/s
windDir	String	风向
windLevel	Number	风速等级
zoneId	String	时区
sunSetTimestamp	Number	日落时间戳
sunRiseTimestamp	Number	日出时间戳
sunSet	String	日落时间文本，文本格式是 yyyy-MM-dd HH:mm:ss
sunRise	String	日出时间文本，文本格式是 yyyy-MM-dd HH:mm:ss

请求示例

import { getWeathers } from '@ray-js/ray';
 
getWeathers({
  devId: `${YOUR_DEVICE_ID}`,
  dataRange: 7,
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

{
  c:
  {
    name: String,   // 城市名称
    id: Number,        // 城市id
  },
  weathers:
	[
    items:
	   {
	      temp: Number,   // 温度 ，国内外都是单位摄氏度
 	      thigh: Number,     // 最高温度 ，国内外都是单位摄氏度
	      pressure: Number,      //  大气气压
	      condition: String,      // 天气文本描述
	      tlow: Number,      // 最低温度 ，国内外都是单位摄氏度
	      condIconUrl: String,  //  天气图标地址
	      humidity: Number,   //  空气湿度
	      conditionNum: String,    // 天气文本编号
	      windSpeed: String,       // 风速，国内外都是 m/s
	      windDir: String,     // 风向
	      windLevel: Number,     //  风速等级
	      zoneId: String,    //  时区
	      sunRise: String,    //  日出文本
	      sunSet: String,     //   日落文本
	      sunSetTimestamp: Number    // 日落时间戳
	      sunRiseTimestamp: Number    // 日出时间戳
	    }
  ]
}

👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。 

 

getWeatherQuality

说明：设备天气根据 设备配网经纬度 和 IP 地址 获取。如果本接口仅返回 true，但无天气详情数据，那么该设备的 设备配网经纬度 和 IP 地址 可能设置错误，请查看设备日志。

通过设备 ID 获取当天天气。

请求参数

参数	数据类型	描述	是否必填
devId	String	设备 ID	是
isLocal	Boolean	是否使用用户本地时区（ 默认值是 false ）	否

返回结果

参数	数据类型	说明
c	c[]	见 c
w	w[]	见 w

• c

参数	数据类型	说明
name	String	城市名称
id	Number	城市 ID

• 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	天气文本编号
sunSetTimestamp	Number	日落时间戳
sunRiseTimestamp	Number	日出时间戳
sunSet	String	日落时间文本，文本格式是 yyyy-MM-dd HH:mm:ss
sunRise	String	日出时间文本，文本格式是 yyyy-MM-dd HH:mm:ss

请求示例

import { getWeatherQuality } from '@ray-js/ray';
 
getWeatherQuality({
  devId: `${YOUR_DEVICE_ID}`,
  isLocal: true,
})
  .then((response) => {
    console.log(response);
  })
  .catch();

返回示例

{
  c:
  {
    name: String,   // 城市名称
    id: Number,    // 城市id
  },
  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    // 日出时间戳
  }
}

 👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。