1. 查天气-获取天气信息(weather-weatherInfo)

1.1 用户界面

手机

适用产品: 智能助手

适用产品: 搜索

适用产品: 语音助手

1.2 请求

天气信息查询请求:

1、场景一:用户没有输入位置和时间,HAG使用用户设备的经纬度和服务器侧时间调用开发者,经纬度和服务器侧时间使用请求体的单独字段传递,不使用槽位传递。

2、场景二:HAG使用设备端侧的IP和服务器侧时间调用开发者,IP使用槽位传递,服务器侧时间使用请求体单独字段传递。

3、场景三:用户使用语音输入查询城市名、区/县(区和县同时只存在一个)任意参数以及设备侧IP、服务器侧时间任意组合,调用开发者,其中城市名、区/县使用槽位传递。

(1)用户查询南京市天气,则参数为city+服务器侧时间;

(2)用户查询南京市雨花台区天气,则参数为city+district+服务器侧时间;

(3)用户查询南京市江宁县天气,则参数为city +county+服务器侧时间;

(4)用户查询雨花台区/江宁县天气,则参数为district/county+服务器侧时间。

4、场景四:用户只输入省份,比如用户说:江苏天气怎么样或者江苏省天气怎么样?开发者要返回江苏省会南京市的天气信息,同时存在省份和城市的查询时,以城市名为准;如用户说:江苏省南京市天气怎么样,则开发者要返回南京市的天气信息,注意省份的名字开发者侧只需要提取关键字即可,不要做字符串全匹配,比如江苏和江苏省。

5、场景五:华为天气APP使用的cityCode查询天气场景,cityCode标识全世界州/省市区/县乡镇唯一标识符,cityCode取值等价于ACCU的取值。

约束1:城市名可能包含海外的城市名,如伦敦、伦敦市

约束2:参数命名受兼容性约束,不完全保持风格一致。

请求报文样例:

  1. {
  2.        "slots": {
  3.          "ip": {
  4.            "name": "ip",
  5.            "slotType": "string",
  6.            "values": [
  7.              {"real":"10.10.10.10"}
  8.            ]
  9.          },
  10.          "country": {
  11.            "name": "country",
  12.            "slotType": "string",
  13.            "values": [
  14.              {"real":"中国"}
  15.            ]
  16.          },
  17.          "province": {
  18.            "name": "province",
  19.            "slotType": "string",
  20.            "values": [
  21.              {"real":"江苏"}
  22.            ]
  23.          },
  24.          "city": {
  25.            "name": "city",
  26.            "slotType": "string",
  27.            "values": [
  28.              {"real":"南京市"}
  29.            ]
  30.          },
  31.           "district": {
  32.            "name": "district",
  33.            "slotType": "string",
  34.            "values": [
  35.              {"real":"雨花台区"}
  36.            ]
  37.          },
  38.           "county": {
  39.            "name": "county",
  40.            "slotType": "string",
  41.            "values": [
  42.              {"real":"江宁县"}
  43.            ]
  44.          },
  45.          "scenicSpots": {
  46.            "name": "scenicSpots",
  47.            "slotType": "string",
  48.            "values": [
  49.              {"real":"夫子庙"}
  50.            ]
  51.          },
  52.          "cityCode": {
  53.            "name": "cityCode",
  54.            "slotType": "string",
  55.            "values": [
  56.              {"real":"12345"}
  57.            ]
  58.          }
  59.        }
  60.      }
成员名称描述是否必选类型取值范围
timestamp服务器端的请求时间,不在槽位信息中传递,详见调用开发者的请求体定义。是DateTimeFormatString/
location地理位置信息,不在槽位信息中传递,详见调用开发者的请求体定义。是Location/
ip设备IP是string最大长度:32
country国家名,如中国否string最大长度:32
province江苏,江苏省两种形式都要支持,一般场景下,优先使用两个字的称呼,如江苏否string最大长度:32
city城市名城,如南京、南京市两种形式都要支持。是string最大长度:32
district

城市下属区名称,如雨花台、雨花台区。海外版本部署不支持该参数

是string最大长度:32
county城市下属县名称,如江宁、江宁县。海外版本部署不支持该参数是string最大长度:32
cityCode州/省市区县乡镇唯一标识符是string最大长度:32

1.3 响应

响应报文样例:

  1. {
  2.    "items":[{
  3.        "aqi":{
  4.            "co":7,
  5.            "no2":23,
  6.            "o3":10,
  7.            "pm10":52,
  8.            "pm25":104,
  9.            "so2":7,
  10.            "aqivalue":137,
  11.            "aqivaluetext":"良",
  12.            "aqidesc":"空气清新,多出去走走"
  13.        },
  14.        "city":{
  15.            "citycode":"105570",
  16.            "name":"南京市",
  17.            "timezone":"Asia/shanghai",
  18.            "provicename":"江苏省",
  19.            "countryname":"中国"
  20.        },
  21.        "condition":{
  22.            "weatherid":21,
  23.            "cnweatherid":21,
  24.            "humidity":"60",
  25.            "temperature":25,
  26.            "realfeel":20,
  27.            "winddir":"NW",
  28.            "windlevel":2,
  29.            "windspeed":3,
  30.            "updatetime":1547119922807,
  31.            "pressure":1020 ,
  32.            "uVIndex":1,
  33.            "uVIndexText":"较弱",
  34.            "mobileLink":{
  35.                "webURL":"webURL",
  36.                "deepLink":{
  37.                    "url":"",
  38.                    "appName":"appName",
  39.                    "appPackage":"appPackage",
  40.                    "minVersion":1.0,
  41.                    "minAndroidAPILevel":1.0
  42.                },
  43.                "quickApp":{
  44.                    "url":"url",
  45.                    "minPlatformVersion":1.0,
  46.                    "minVersion":1.0
  47.                }
  48.            }
  49.        },
  50.        "dailys":{
  51.            "dailyweathers":[
  52.                {
  53.                    "moonphase":"WaxingGibbous",
  54.                    "moonRise":1547119922807,
  55.                    "moonSet":1547119922807,
  56.                    "sunRise":1547119922807,
  57.                    "sunSet":1547119922807,
  58.                    "maxtemp":27,
  59.                    "mintemp":17,
  60.                    "aqivalue":137,
  61.                    "aqivaluetext":"良",
  62.                    "conditionDay":{
  63.                        "weatherid":21,
  64.                        "cnweatherid":21,
  65.                        "winddir":"E",
  66.                        "windlevel":2,
  67.                        "windspeed":3
  68.                    },
  69.                    "conditionNight":{
  70.                        "weatherid":21,
  71.                        "cnweatherid":21,
  72.                        "winddir":"NW",
  73.                        "windlevel":2,
  74.                        "windspeed":3
  75.                    },
  76.                    "publictime":1547119922807,
  77.                    "mobileLink":{
  78.                        "webURL":"webURL"
  79.                      }
  80.                }
  81.            ],
  82.            "publictime":1547119922807,
  83.            "mobileLink":{
  84.                "webURL":"webURL",
  85.                "deepLink":{
  86.                    "url":"",
  87.                    "appName":"appName",
  88.                    "appPackage":"appPackage",
  89.                    "minVersion":1.0,
  90.                    "minAndroidAPILevel":1.0
  91.                },
  92.                "quickApp":{
  93.                    "url":"url",
  94.                    "minPlatformVersion":1.0,
  95.                    "minVersion":1.0
  96.                }
  97.            }
  98.        },
  99.        "hourlys":{
  100.            "hourlyweathers": [{
  101.                    "weatherid":21,
  102.                    "cnweatherid":21,
  103.                    "Isdaynight":false,
  104.                    "rainprobability":30,
  105.                    "date":1547119922807,
  106.                    "temp":27
  107.            }],
  108.            "mobileLink":{
  109.                "webURL":"webURL",
  110.                "deepLink":{
  111.                    "url":"",
  112.                    "appName":"appName",
  113.                    "appPackage":"appPackage",
  114.                    "minVersion":1.0,
  115.                    "minAndroidAPILevel":1.0
  116.                },
  117.                "quickApp":{
  118.                    "url":"url",
  119.                    "minPlatformVersion":1.0,
  120.                    "minVersion":1.0
  121.                }
  122.            }
  123.        },
  124.        "liveInfos": [{
  125.            "code": "1",
  126.            "name": "穿衣指数",
  127.            "updatetime": 1550490100768,
  128.            "day": "2019-02-18",
  129.            "content": "羊毛衫、厚外套。",
  130.            "status": "冷"
  131.          }, {
  132.            "code": "2",
  133.            "name": "运动指数",
  134.            "updatetime": 1550490100765,
  135.            "day": "2019-02-18",
  136.            "content": "",
  137.            "status": "较不宜"
  138.          }, {
  139.            "code": "3",
  140.            "name": "感冒指数",
  141.            "updatetime": 1550490100762,
  142.            "day": "2019-02-18",
  143.            "content": "",
  144.            "status": "易发"
  145.          }, {
  146.            "code": "4",
  147.            "name": "洗车指数",
  148.            "updatetime": 1550490100764,
  149.            "day": "2019-02-18",
  150.            "content": "",
  151.            "status": "适宜"
  152.          }, {
  153.            "code": "5",
  154.            "name": "旅游指数",
  155.            "updatetime": 1550490100762,
  156.            "day": "2019-02-18",
  157.            "content": "",
  158.            "status": "不适宜"
  159.          }, {
  160.            "code": "6",
  161.            "name": "紫外线指数",
  162.            "updatetime": 1550490100764,
  163.            "day": "2019-02-18",
  164.            "content": "",
  165.            "status": "最弱"
  166.          }],
  167.        "additionalLiveInfos": [{
  168.            "code": "2",
  169.            "name": "运动指数",
  170.            "updatetime": 1564360881197,
  171.            "levelList": [
  172.              {
  173.                "day": "2019-07-29",
  174.                "level": 1,
  175.                "status": "较适宜",
  176.                "content": "秋衣"
  177.              },
  178.              {
  179.                "day": "2019-07-30",
  180.                "level": 1,
  181.                "status": "较适宜",
  182.                "content": "秋衣"
  183.              }
  184.            ]
  185.          }],
  186.        "alert":[{
  187.            "title":"标题",
  188.            "areaName":"鼓楼区",
  189.            "content":"正文",
  190.            "level":2,
  191.            "LevelName":"黄色",
  192.            "publicTime":1547119922807,
  193.            "type":1,
  194.            "TypeName":"台风"
  195.        }]
  196.    }]
  197. }
成员名称描述是否必选类型取值范围
items/是WeatherInfoDetail最大Item数:1 

2. 查天气-城市位置(weather-weatherCityInfo)

2.1 请求

天气位置搜索信息查询请求

场景:用户市区县乡镇街道,开发者返回搜索结果列表。

请求报文样例:

  1. {
  2.    "slots": {
  3.        "searchKeyword": {
  4.            "name": "searchKeyword",
  5.            "slotType": "string",
  6.            "values": [{
  7.                "real": "雨花台区"
  8.            }]
  9.        }
  10.    }
  11. }
成员名称描述是否必选类型取值范围
searchKeyword城市名称,市区县乡镇街道名称。是string最大长度:32

2.2 响应

响应报文样例:

  1. {
  2.    "citys": [
  3.      {
  4.        "citycode": "60472",
  5.        "rank": "0",
  6.        "localizedname": "洋县",
  7.        "englishCityName": "yangxian",
  8.        "sparelocalizedname": "",
  9.        "timezone": "",
  10.        "type": "City",
  11.        "administrativearea": {
  12.          "id": "SN",
  13.          "localizedname": "陕西省"
  14.        },
  15.        "country": {
  16.          "id": "CN",
  17.          "localizedname": "中国"
  18.        }
  19.      }
  20.    ]
  21.  }
成员名称描述是否必选类型取值范围
cities
是WeatherCityInfoDetail[]最大Item数:50

3. 结构

CityInfoByLonLatReq

经纬度查询行政区划数据请求,HAG使用用户设备的经纬度调用CP,经纬度使用请求体的单独字段传递,不使用槽位传递
请求报文样例

  1. {
  2.        "slots": {
  3.          "locale": {
  4.            "name": "locale",
  5.            "slotType": "string",
  6.            "values": [
  7.              {"real":"en_GB"}
  8.            ]
  9.          }
  10.        }
  11.      }
成员名称描述是否必选类型

取值范围

locale请求的语言类型,格式是locale格式,比如en_GB表示英国英语是string最大长度:32

CityByLonLatInfo
响应报文样例

  1. {
  2.      "items":[
  3.        {
  4.          "cities":[{
  5.              "cityCode":"105570",
  6.              "district":"鼓楼区",
  7.              "cityName":"南京市",
  8.              "provicename":"江苏省",
  9.              "countryname":"中国"
  10.          }]
  11.        }
  12.      ]
  13.  }
成员名称描述是否必选类型

取值范围

items


是

CityInfoByLonLatDetail[]

最大Item数:1

CityInfoByLonLatDetail

成员名称描述是否必选类型

取值范围

cities

城市位置信息
是

CityInfoByLonLat[]

最大Item数:50

CityInfoByLonLat

城市信息

成员名称

描述

是否必选

类型

取值范围

cityCode

城市编码

否

string

最大长度:32

district

区县名称,可能为空

否

string

最大长度:32

cityName

城市名称,district和cityName至少二选一

否

string

最大长度:32

provinceName

省名

是

string

最大长度:32

countryName

国家名

是

string

最大长度:32

WeatherCityInfoDetail

成员名称描述是否必选类型取值范围

citycode

城市的唯一citycode,兼容性场景,不能小驼峰命名

是

string

最大长度:32

rank

城市的知名度,可能为负数

是

string

最大长度:8

localizedname

根据locale返回的本地化语言的地名,兼容性场景,不能小驼峰命名

否

string

最大长度:128

englishCityName

根据locale返回的本地化语言的地名

否

string

最大长度:128

timezone

城市所在时区,Alson格式 例如: Asia/shanghai,兼容性场景,不能小驼峰命名

否

string

最大长度:32

administrativearea


是

WeatherCityInfoAdministrativeArea


country


是

WeatherCityInfoCountry


WeatherCityInfoAdministrativeArea

成员名称

描述

是否必选

类型

取值范围

id

行政区划的ID,是双字符,如SN表示陕西省

否

string

最大长度:32

localizedname

行政区划的本地化名称,兼容性场景,不能小驼峰命名

是

string

最大长度:8

WeatherCityInfoCountry

成员名称

描述

是否必选

类型

取值范围

id

行政区划的国家的代号,是双字符,如CN表示中国

否

string

最大长度:32

localizedname

行政区划的国家的本地化名称,兼容性场景,不能小驼峰命名

是

string

最大长度:8

WeatherInfoDetail

成员名称

描述

是否必选

类型

取值范围

aqi

空气质量指数。海外部署的版本响应报文不支持该字段。

否

WeatherAqi


city

城市信息,含有该城市或地区时区信息

是

WeatherCity


condition

当前实时天气信息

是

WeatherCondition


dailys

需要返回包含昨天和未来14天的15天数据,按时间顺序排序后返回。

是

Dailys


hourlys

小时天气状况

是

Hourlyweathers


liveInfos

生活指数信息。海外部署的版本响应报文不支持该字段。

是

WeatherLiveInfo[]

最大Item数:10

additionalLiveInfos

今天、明天、后天的生活指数信息
  包括:穿衣指数 洗车指数 运动指数 出游指数 感冒指数 紫外线指数
  海外部署的版本响应报文不支持该字段。

否

WeatherAdditionalLiveInfo[]

最大Item数:20

alert

预警信息。海外部署的版本响应报文不支持该字段。

否

WeatherAlertInfo[]

最大Item数:30

WeatherAqi

空气质量指数。海外部署的版本响应报文不支持该字段。

成员名称

描述

是否必选

类型

取值范围

co

一氧化碳指数

是

number


no2

二氧化氮指数

是

number


o3

臭氧指数

是

number


pm10

PM10浓度

是

number


pm25

PM2.5浓度

是

number


so2

二氧化硫

是

number


aqivalue

空气质量指数值

是

int


aqivaluetext

空气质量等级划分:1、优质;2、良好;3、轻度污染;4、中度污染;5、重度污染;6、严重污染。

是

string

枚举值:
  优质,
  良好,
  轻度污染,
  中度污染,
  重度污染,
  严重污染

aqidesc

空气质量播报一句话描述,如:空气有污染,减少大量户外活动

是

string

最大长度:14

WeatherCity

城市信息,含有该城市或地区时区信息

成员名称

描述

是否必选

类型

取值范围

citycode

城市编码,HiBoard端侧需要传给EMUI APP,必填

是

string

最大长度:32

name

国际化后的城市名称,最终会返回给业务侧展示或播报。举例:用户使用中文问,则在该字段返回中文城市名。在多语言场景下该字段可能为空

否

string

最大长度:32

englishCityName

英语的城市名称,最终会返回给业务侧展示或播报。举例:用户使用经纬度查询天气,如果无国际化后的城市名称,则使用englishCityName字段返回。

是

string

最大长度:32

timezone

城市所在时区,Alson格式 例如: Asia/shanghai

是

string

最大长度:32

provincename

省名

是

string

最大长度:32

countryname

国家名

是

string

最大长度:32

onlyHit

根据请求地名得到的该搜索结果是否唯一,如果唯一则为true,否则为false,缺省值为false

否

boolean

枚举值:
  true,
  false

WeatheridDef

气象编码
id EN CN
1 Sunny 晴
2 Mostly Sunny 大部分晴
3 Partly Sunny 部分晴
4 Intermittent Clouds 间歇性多云
5 Hazy Sunshine 晴,空气质量差
6 Mostly Cloudy 大部分多云
7 Cloudy 多云
8 Dreary 阴郁(Overcast阴)
11 Fog 雾
12 Showers 阵雨
13 Mostly Cloudy w/ Showers 多云,有时有阵雨
14 Partly Sunny w/ Showers部分晴,有时有阵雨
15 T-Storms 雷雨
16 Mostly Cloudy w/ T-Storms 多云,有时有雷雨
17 Partly Sunny w/ T-Storms 部分晴,有时有雷雨
18 Rain 雨
19 Flurries 轻雪
20 Mostly Cloudy w/ Flurries 多云,有时有轻雪
21 Partly Sunny w/ Flurries 部分晴,有时有轻雪
22 Snow 雪
23 Mostly Cloudy w/ Snow 多云,有时有雪
24 Ice 冻雪
25 Sleet 冰霰
26 Freezing Rain 冻雨
29 Rain and Snow雨和雪
30 Hot 热
31 Cold 冷
32 Windy 风
33 Clear 晴
34 Mostly Clear 大部分晴朗
35 Partly Cloudy 部分多云
36 Intermittent Clouds 间歇性多云
37 Hazy Moonlight 晴,空气质量差
38 Mostly Cloudy 大部分多云
39 Partly Cloudy w/ Showers 部分多云,有时有阵雨
40 Mostly Cloudy w/ Showers 大部分多云,有时有阵雨
41 Partly Cloudy w/ T-Storms 部分多云,有时有雷雨
42 Mostly Cloudy w/ T-Storms 大部分多云,有时有雷雨
43 Mostly Cloudy w/ Flurries 大部分多云,有时有阵雪
44 Mostly Cloudy w/ Snow 大部分多云,有雪
说明w/在语音场景下,是with的意思

类型

取值范围

int

枚举值:
  1,
  2,
  3,
  4,
  5,
  6,
  7,
  8,
  11,
  12,
  13,
  14,
  15,
  16,
  17,
  18,
  19,
  20,
  21,
  22,
  23,
  24,
  25,
  26,
  29,
  30,
  31,
  32,
  33,
  34,
  35,
  36,
  37,
  38,
  39,
  40,
  41,
  42,
  43,
  44

 CnWeatheridDef

气象编码

id CNENid CNEN
00晴Sunny01多云Cloudy
02阴Overcast03阵雨Shower
04雷阵雨Thundershower05雷阵雨伴有冰雹Thundershower with hail
06雨加雪Sleet07小雨Light rain
08中雨Moderate rain09大雨Heavy rain
10暴雨Storm11大暴雨Heavy storm
12特大暴雨Severe storm13阵雪Snow flurry
14小雪Light snow15中雪Moderate snow
16大雪Heavy snow17暴雪Snowstorm
18雾Foggy19冻雨Ice rain
20沙尘暴Duststorm21小到中雨Light to moderate rain
22中到大雨Moderate to heavy rain23大到暴雨Heavy rain to storm
24暴雨到大暴雨Storm to heavy storm25大暴雨到特大暴雨Heavy to severe storm
26小到中雪Light to moderate snow27中到大雪Moderate to heavy snow
28大到暴雪Heavy snow to snowstorm29浮尘Dust
30扬沙Sand31强沙尘暴Sandstorm
32
浓雾Dense foggy 33雪(中国天气通新标中增加的,最美天气老标无该字段)Snow
49强浓雾(中国天气通新标中增加的,最美天气老标无该字段)Moderate foggy 53霾Haze
54中度霾(中国天气通新标中增加的,最美天气老标无该字段)Moderate haze 55重度霾(中国天气通新标中增加的,最美天气老标无该字段)Heavy haze 
56严重霾(中国天气通新标中增加的,最美天气老标无该字段)Severe haze 57大雾(中国天气通新标中增加的,最美天气老标无该字段)Heavy foggy 
58特强浓雾(中国天气通新标中增加的,最美天气老标无该字段)Severe foggy 301降雨(中国天气通新标中增加的,最美天气老标无该字段)Rain
302降雪(中国天气通新标中增加的,最美天气老标无该字段)Snow99无Unknown
类型取值范围
int枚举值:  1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 53, 99

WinddirDef

风向

类型取值范围
string最大长度:16,枚举值:  NE, E, SE, S, SW, W, N, NW

WeatherCondition

当前实时天气信息:

成员名称

描述

是否必选

类型

取值范围

weatherid

气象编码
  id EN CN
  1 Sunny 晴
  2 Mostly Sunny 大部分晴
  3 Partly Sunny 部分晴
  4 Intermittent Clouds 间歇性多云
  5 Hazy Sunshine 晴,空气质量差
  6 Mostly Cloudy 大部分多云
  7 Cloudy 多云
  8 Dreary 阴郁(Overcast阴)
  11 Fog 雾
  12 Showers 阵雨
  13 Mostly Cloudy w/ Showers 多云,有时有阵雨
  14 Partly Sunny w/ Showers部分晴,有时有阵雨
  15 T-Storms 雷雨
  16 Mostly Cloudy w/ T-Storms 多云,有时有雷雨
  17 Partly Sunny w/ T-Storms 部分晴,有时有雷雨
  18 Rain 雨
  19 Flurries 轻雪
  20 Mostly Cloudy w/ Flurries 多云,有时有轻雪
  21 Partly Sunny w/ Flurries 部分晴,有时有轻雪
  22 Snow 雪
  23 Mostly Cloudy w/ Snow 多云,有时有雪
  24 Ice 冻雪
  25 Sleet 冰霰
  26 Freezing Rain 冻雨
  29 Rain and Snow雨和雪
  30 Hot 热
  31 Cold 冷
  32 Windy 风
  33 Clear 晴
  34 Mostly Clear 大部分晴朗
  35 Partly Cloudy 部分多云
  36 Intermittent Clouds 间歇性多云
  37 Hazy Moonlight 晴,空气质量差
  38 Mostly Cloudy 大部分多云
  39 Partly Cloudy w/ Showers 部分多云,有时有阵雨
  40 Mostly Cloudy w/ Showers 大部分多云,有时有阵雨
  41 Partly Cloudy w/ T-Storms 部分多云,有时有雷雨
  42 Mostly Cloudy w/ T-Storms 大部分多云,有时有雷雨
  43 Mostly Cloudy w/ Flurries 大部分多云,有时有阵雪
  44 Mostly Cloudy w/ Snow 大部分多云,有雪
  说明w/在语音场景下,是with的意思

是

int(WeatheridDef)


cnweatherid

气象编码
  id CN EN
  00 晴 Sunny
  01 多云 Cloudy
  02 阴 Overcast
  03 阵雨 Shower
  04 雷阵雨 Thundershower
  05 雷阵雨伴有冰雹   Thundershower with hail
  06 雨夹雪 Sleet
  07 小雨 Light rain
  08 中雨 Moderate rain
  09 大雨 Heavy rain
  10 暴雨 Storm
  11 大暴雨 Heavy storm
  12 特大暴雨 Severe storm
  13 阵雪 Snow flurry
  14 小雪 Light snow
  15 中雪 Moderate snow
  16 大雪 Heavy snow
  17 暴雪 Snowstorm
  18 雾 Foggy
  19 冻雨 Ice rain
  20 沙尘暴 Duststorm
  21 小到中雨 Light to moderate rain
  22 中到大雨 Moderate to heavy rain
  23 大到暴雨 Heavy rain to storm
  24 暴雨到大暴雨 Storm   to heavy storm
  25 大暴雨到特大暴雨 Heavy   to severe storm
  26 小到中雪 Light to moderate snow
  27 中到大雪 Moderate to heavy snow
  28 大到暴雪 Heavy snow to snowstorm
  29 浮尘 Dust
  30 扬沙 Sand
  31 强沙尘暴 Sandstorm
  32 浓雾 Dense foggy
  33 雪 Snow --中国天气通新标中增加的,最美天气老标无该字段
  49 强浓雾 Moderate foggy --中国天气通新标中增加的,最美天气老标无该字段
  53 霾 Haze
  54 中度霾 Moderate haze --中国天气通新标中增加的,最美天气老标无该字段
  55 重度霾 Heavy haze --中国天气通新标中增加的,最美天气老标无该字段
  56 严重霾 Severe haze --中国天气通新标中增加的,最美天气老标无该字段
  57 大雾 Heavy foggy --中国天气通新标中增加的,最美天气老标无该字段
  58 特强浓雾 Severe foggy --中国天气通新标中增加的,最美天气老标无该字段
  301 降雨 Rain   --中国天气通新标中增加的,最美天气老标无该字段
  302 降雪 Snow   --中国天气通新标中增加的,最美天气老标无该字段
  99 无 Unknown

是

int(CnWeatheridDef)


humidity

湿度,百分制,HAG自动补齐%符号

是

string

最大长度:32

temperature

温度,单位:摄氏度。

是

number


realfeel

体感温度,单位:摄氏度。

是

number


winddir

风向

是

string(WinddirDef)


windlevel

风级,实时天气的风级
  0国内版本表示微风,海外版本0表示无风。

是

int

最小值:0,最大值:17

windspeed

风速,单位KM/H

是

int


updatetime

发布时间

是

number


pressure

压强,单位:百帕。

是

number


uVIndex

紫外线指数
  1 紫外线最弱
  2 紫外线弱
  3 紫外线中等
  4 紫外线强
  5 紫外线很强

是

int

枚举值:
  1,
  2,
  3,
  4,
  5

uVIndexText

紫外线指数描述,海外版本不支持

是

string

最大长度:16,枚举值:
  最弱,
  弱,
  中等,
  强,
  很强

mobileLink


是

Interaction


 Dailys

需要返回包含昨天和未来14天的15天数据,按时间顺序排序后返回。

成员名称描述是否必选类型取值范围
dailyweathers日天气信息是DayWeatherInfo[]最大Item数:8
publictime发布时间否number/
mobileLink
否Interaction/

DayWeatherInfo

日天气信息:

成员名称

描述

是否必选

类型

取值范围

currentFestival

本天的节假日信息,包括24节气和假日信息,如果某天有多个节日,以/分隔,如“护士节/母亲节”

否

string

最大长度:64

moonphase

月相,总共有 8 种可能:New, Waxingcrescent, First,   WaxingGibbous, Full, WaningGibbous, Last, WaningCrescent

否

string

最大长度:32,枚举值:
  New,
  Waxingcrescent,
  First,
  WaxingGibbous,
  Full,
  WaningGibbous,
  Last,
  WaningCrescent

moonRise

月出

否

number


moonSet

月落

否

number


sunRise

日出

是

number


sunSet

日落

是

number


maxtemp

最高温度,单位:摄氏度

是

number


mintemp

最低温度,单位:摄氏度

是

number


aqivalue

空气质量指数值。海外版本不支持。

否

int


aqivaluetext

空气质量等级划分:1、优质;2、良好;3、轻度污染;4、中度污染;5、重度污染;6、严重污染。
  海外版本不支持。

否

string

枚举值:
  优质,
  良好,
  轻度污染,
  中度污染,
  重度污染,
  严重污染

publictime

XX天天气的发布时间,换算后对应于昨天和未来14天的某一天 ,转换后,如2019-1-21

是

number


conditionDay

日夜天气信息

是

DayNightCondition


conditionNight

日夜天气信息

是

DayNightCondition


sources

文字描述,预报来源,用于界面展示

是

string[]

最大Item数:16,Item校验规则[最大长度:128]

mobileLink


否

Interaction


 DayNightCondition

日夜天气信息:

成员名称描述是否必选类型取值范围
weatherid气象编码

id EN CN
1 Sunny 晴
2 Mostly Sunny 大部分晴
3 Partly Sunny 部分晴
4 Intermittent Clouds 间歇性多云
5 Hazy Sunshine 晴,空气质量差
6 Mostly Cloudy 大部分多云
7 Cloudy 多云
8 Dreary 阴郁(Overcast阴)
11 Fog 雾
12 Showers 阵雨
13 Mostly Cloudy w/ Showers 多云,有时有阵雨
14 Partly Sunny w/ Showers部分晴,有时有阵雨
15 T-Storms 雷雨
16 Mostly Cloudy w/ T-Storms 多云,有时有雷雨
17 Partly Sunny w/ T-Storms 部分晴,有时有雷雨
18 Rain 雨
19 Flurries 轻雪
20 Mostly Cloudy w/ Flurries 多云,有时有轻雪
21 Partly Sunny w/ Flurries 部分晴,有时有轻雪
22 Snow 雪
23 Mostly Cloudy w/ Snow 多云,有时有雪
24 Ice 冻雪
25 Sleet 冰霰
26 Freezing Rain 冻雨
29 Rain and Snow雨和雪
30 Hot 热
31 Cold 冷
32 Windy 风
33 Clear 晴
34 Mostly Clear 大部分晴朗
35 Partly Cloudy 部分多云
36 Intermittent Clouds 间歇性多云
37 Hazy Moonlight 晴,空气质量差
38 Mostly Cloudy 大部分多云
39 Partly Cloudy w/ Showers 部分多云,有时有阵雨
40 Mostly Cloudy w/ Showers 大部分多云,有时有阵雨
41 Partly Cloudy w/ T-Storms 部分多云,有时有雷雨
42 Mostly Cloudy w/ T-Storms 大部分多云,有时有雷雨
43 Mostly Cloudy w/ Flurries 大部分多云,有时有阵雪
44 Mostly Cloudy w/ Snow 大部分多云,有雪
说明w/在语音场景下,是with的意思

是

int(WeatheridDef)

/
cnweatherid天气id,国内33个种类,每种天气需要按照白天和夜晚展示不同的天气现象的图标和背景动画。是int(CnWeatheridDef)/
winddir风向,如东北风。是string(WinddirDef)/
windlevel风级,白天风级和夜晚风级合并起来,如3~4级,表示白天3级和夜晚4级,国内版本表示微风,海外版本0表示无风。是int最小值:0,最大值:17
windspeed风速,单位KM/H是int/

Hourlyweathers

小时天气状况:

成员名称描述是否必选类型取值范围
hourlyweathers含当前小时的未来24小时天气信息。是Hourlys[]最大Item数:24
mobileLink/否Interaction/

Hourlys

小时天气状况,只需要返回未来24小时天气,包含当前小时的24小时,按顺序返回。

成员名称描述是否必选类型取值范围
weatherid气象编码

id EN CN
1 Sunny 晴
2 Mostly Sunny 大部分晴
3 Partly Sunny 部分晴
4 Intermittent Clouds 间歇性多云
5 Hazy Sunshine 晴,空气质量差
6 Mostly Cloudy 大部分多云
7 Cloudy 多云
8 Dreary 阴郁(Overcast阴)
11 Fog 雾
12 Showers 阵雨
13 Mostly Cloudy w/ Showers 多云,有时有阵雨
14 Partly Sunny w/ Showers部分晴,有时有阵雨
15 T-Storms 雷雨
16 Mostly Cloudy w/ T-Storms 多云,有时有雷雨
17 Partly Sunny w/ T-Storms 部分晴,有时有雷雨
18 Rain 雨
19 Flurries 轻雪
20 Mostly Cloudy w/ Flurries 多云,有时有轻雪
21 Partly Sunny w/ Flurries 部分晴,有时有轻雪
22 Snow 雪
23 Mostly Cloudy w/ Snow 多云,有时有雪
24 Ice 冻雪
25 Sleet 冰霰
26 Freezing Rain 冻雨
29 Rain and Snow雨和雪
30 Hot 热
31 Cold 冷
32 Windy 风
33 Clear 晴
34 Mostly Clear 大部分晴朗
35 Partly Cloudy 部分多云
36 Intermittent Clouds 间歇性多云
37 Hazy Moonlight 晴,空气质量差
38 Mostly Cloudy 大部分多云
39 Partly Cloudy w/ Showers 部分多云,有时有阵雨
40 Mostly Cloudy w/ Showers 大部分多云,有时有阵雨
41 Partly Cloudy w/ T-Storms 部分多云,有时有雷雨
42 Mostly Cloudy w/ T-Storms 大部分多云,有时有雷雨
43 Mostly Cloudy w/ Flurries 大部分多云,有时有阵雪
44 Mostly Cloudy w/ Snow 大部分多云,有雪
说明w/在语音场景下,是with的意思

是

int(WeatheridDef)

/
cnweatherid气象编码id CN EN00 晴 Sunny01 多云 Cloudy02 阴 Overcast03 阵雨 Shower04 雷阵雨 Thundershower05 雷阵雨伴有冰雹 Thundershower with hail06 雨夹雪 Sleet07 小雨 Light rain08 中雨 Moderate rain09 大雨 Heavy rain10 暴雨 Storm11 大暴雨 Heavy storm12 特大暴雨 Severe storm13 阵雪 Snow flurry14 小雪 Light snow15 中雪 Moderate snow16 大雪 Heavy snow17 暴雪 Snowstorm18 雾 Foggy19 冻雨 Ice rain20 沙尘暴 Duststorm21 小到中雨 Light to moderate rain22 中到大雨 Moderate to heavy rain23 大到暴雨 Heavy rain to storm24 暴雨到大暴雨 Storm to heavy storm25 大暴雨到特大暴雨 Heavy to severe storm26 小到中雪 Light to moderate snow27 中到大雪 Moderate to heavy snow28 大到暴雪 Heavy snow to snowstorm29 浮尘 Dust30 扬沙 Sand31 强沙尘暴 Sandstorm32浓雾 Dense foggy33雪Snow –中国天气通新标中增加的,最美天气老标无该字段 49强浓雾Moderate foggy –中国天气通新标中增加的,最美天气老标无该字段53霾Haze54中度霾Moderate haze –中国天气通新标中增加的,最美天气老标无该字段55重度霾Heavy haze –中国天气通新标中增加的,最美天气老标无该字段56严重霾Severe haze –中国天气通新标中增加的,最美天气老标无该字段57大雾Heavy foggy –中国天气通新标中增加的,最美天气老标无该字段58特强浓雾Severe foggy –中国天气通新标中增加的,最美天气老标无该字段301降雨Rain –中国天气通新标中增加的,最美天气老标无该字段302降雪Snow –中国天气通新标中增加的,最美天气老标无该字段99 无 Unknown。是int(CnWeatheridDef)/
date预报日期,转换后对应于未来的某一个小时,如2019-1-21 16:00。是
long
/
temp温度,单位:摄氏度。是number/
rainprobability降水率 ,返回值百分比,不用携带%符号,HAG自动补齐。是number/
Isdaynight是白天还是晚上是boolean枚举值:  false,true

DressingIdxDef

穿衣指数

1 羽绒服-寒冷

2 厚外套-冷

3 毛衣-较冷

4 薄外套-较舒适

5 长袖-舒适

6 短袖-热

7 短袖-炎热

类型取值范围
int枚举值:  1, 2, 3, 4, 5, 6, 7

SportsIdxDef

运动指数

1 适宜运动

2 较适宜运动

3 较不宜运动

类型取值范围
int枚举值:  1, 2, 3

 ColdIdxDef

感冒指数

1 感冒少发

2 感冒较易发

3 感冒易发

4 感冒极易发

热

类型取值范围
int枚举值:  1, 2, 3, 4

CarWashIdxDef

洗车指数

1 不宜

2 较不宜

3 较适宜

4 适宜

类型取值范围
int枚举值:  1, 2, 3, 4

TourismIdxDef

旅游指数

1 不适宜

2 不太适宜

3 较适宜

4 适宜

类型取值范围
int枚举值:  1, 2, 3, 4

UVIdxDef

紫外线指数

1 紫外线最弱

2 紫外线弱

3 紫外线中等

4 紫外线强

5 紫外线很强

类型取值范围
int枚举值:  1, 2, 3, 4, 5

WeatherLiveInfo

天气生活信息:

成员名称描述是否必选类型取值范围
code生活指数种类码。1 表示穿衣指数 2 表示运动指数 3 表示感冒指数 4 表示洗车指数 5 表示旅游指数 6 表示紫外线指数是string最大长度:16,枚举值:  1, 2, 3, 4, 5, 6
day日期,格式yyyy-MM-dd,例如:2018-02-23。是DateFormatString/
level穿衣指数:1、羽绒服-寒冷;2、厚外套-冷;3、毛衣-较冷;4、薄外套-较舒适;5、长袖-舒适;6、短袖-热;7、短袖-炎热运动指数:1、适宜运动;2、较适宜运动;3、较不宜运动感冒指数:1、不易感冒;2、较易感冒;3、容易感冒;4、极易感冒洗车指数:1、不宜;2、较不易;3、较适宜;4、适宜旅游指数:1、不适宜;2、不太适宜;3、较适宜;4、适宜紫外线指数:1、紫外线最弱;2、紫外线弱;3、紫外线中等;4、紫外线强;5、紫外线很强当前语音查询冷热场景下,会使用穿衣指数的level用来做冷热的取值映射。否int/
name指数名,穿衣指数、运动指数、感冒指数、洗车指数、旅游指数、紫外线指数是string最大长度:16,枚举值:  穿衣指数, 运动指数, 感冒指数, 洗车指数, 旅游指数, 紫外线指数
content指数描述,如穿衣指数中的描述:羊毛衫、厚外套。是string最大长度:16
status状态名穿衣指数:寒冷;冷;较冷;较舒适;舒适;热;炎热运动指数:适宜;较适宜;较不宜感冒指数:不易;较易;容易;极易洗车指数:不宜;较不易;较适宜;4适宜旅游指数:不适宜;不太适宜;较适宜;适宜紫外线指数:最弱;弱;中等;强;很强。是string最大长度:16
updatetime发布时间是number/
mobilelink生活指数对应的二级页面 URL否Interaction/

WeatherAdditionalLiveInfo

今天、明天、后天的生活指数信息

成员名称描述是否必选类型取值范围
code生活指数种类码。1 表示穿衣指数 2 表示运动指数 3 表示感冒指数 4 表示洗车指数 5 表示旅游指数 6 表示紫外线指数是string最大长度:16,枚举值:  1, 2, 3, 4, 5, 6
name指数名,穿衣指数、运动指数、感冒指数、洗车指数、旅游指数、紫外线指数是string最大长度:16,枚举值:  穿衣指数, 运动指数, 感冒指数, 洗车指数, 旅游指数, 紫外线指数
levelList日期,格式yyyy-MM-dd, 例如:2018-02-23是WeatherAdditionalLiveItemInfo[]最大Item数:30
updatetime发布时间是number

WeatherAdditionalLiveItemInfo

明天、后天、大后天的生活指数信息

成员名称描述是否必选类型取值范围
day日期,格式yyyy-MM-dd, 例如:2018-02-23是DateFormatString

level

穿衣指数:1、羽绒服-寒冷;2、厚外套-冷;3、毛衣-较冷;4、薄外套-较舒适;5、长袖-舒适;6、短袖-热;7、短袖-炎热
运动指数:1、适宜运动;2、较适宜运动;3、较不宜运动
感冒指数:1、不易感冒;2、较易感冒;3、容易感冒;4、极易感冒
洗车指数:1、不宜;2、较不易;3、较适宜;4、适宜
旅游指数:1、不适宜;2、不太适宜;3、较适宜;4、适宜
紫外线指数:1、紫外线最弱;2、紫外线弱;3、紫外线中等;4、紫外线强;5、紫外线很强
当前语音查询冷热场景下,会使用穿衣指数的level用来做冷热的取值映射
是int
status状态名穿衣指数:寒冷;冷;较冷;较舒适;舒适;热;炎热运动指数:适宜;较适宜;较不宜感冒指数:不易;较易;容易;极易洗车指数:不宜;较不易;较适宜;4适宜旅游指数:不适宜;不太适宜;较适宜;适宜紫外线指数:最弱;弱;中等;强;很强是string最大长度:16
content指数描述,如穿衣指数中的描述:羊毛衫、厚外套。是string最大长度:16

WeatherAlertInfo

天气预警信息:

成员名称描述是否必选类型取值范围
title标题是string最大长度:128
areaName地区名字否string最大长度:128
content预警正文是string最大长度:256
level等级 01-04是int枚举值:1,2,3,4
levelName等级名称,如01蓝色、02黄色、03橙色、04红色是string最大长度:32,枚举值:蓝色,黄色,橙色,红色
publictime发布时间是number/
type预警类型:01-14,01 台风02 暴雨03 暴雪04 寒潮05 大风06 沙尘暴07 高温08 干旱09 雷电10 冰雹11 霜冻12 大雾13 霾14 道路结冰是int枚举值:1,2,3,4,5,6,7,8,9,10,11,12,13,14
TypeName预警类名称:01台风、02暴雨、03暴雪、04寒潮、05大风、06沙尘暴、07高温、08干旱、09雷电、10冰雹、11霜冻、12大雾、13霾、14道路结冰是string最大长度:32,枚举值:台风,暴雨,暴雪,寒潮,大风,沙尘暴,高温,干旱,雷电,冰雹,霜冻,大雾,霾,道路结冰